The Telegram bot for People
Connect your organisation's own Telegram bot to Venom People. Forward a contact, a business card photo, a vCard or a voice note to it and the person lands in People, tagged with the day's event.
You already live in Telegram at conferences. The bot lets you forward what you receive there to People without
leaving the chat. It is your organisation's own bot, made with Telegram's @BotFather: Venom registers nothing on
any account, and the only calls Venom makes to Telegram use the token you paste (getMe, setWebhook,
deleteWebhook, getFile and the file download, sendMessage).
Set it up (an admin, once)
- In Telegram, open @BotFather and send
/newbot. Choose a name and a username. - Copy the token BotFather gives you (it looks like
123456789:AA…). - In Venom, open People, then the link at the bottom of Capture, or go to
/people/telegram. Paste the token and press Connect the bot.
Venom checks the token with getMe, seals it in the vault (the same way as provider keys and the Slack app's
secrets; only its last four characters are shown afterwards), and sets the webhook to
https://<your cloud>/api/integrations/people-telegram/<organisation id> with a random secret_token. Telegram sends
that secret with every call and Venom checks it in constant time before it reads anything; a call without it is
refused. Webhooks need an https address and VENOM_VAULT_KEYS set. Pause stops the bot answering; Disconnect
removes the webhook, the token and everyone's links.
It runs on Venom Comms
The bot is a Comms channel: connecting it also adds a Telegram provider, the bot as a sender and a People capture route, and the bot's answers go out through Comms. Nothing changed for a bot you connected earlier: its token, webhook address and linked chats are the same, and Comms adopts it when its next message arrives. You can also capture by WhatsApp or SMS the same way (Support and People).
Link yourself (each member)
Telegram users are unknown until a member links them. On /people/telegram press Link my Telegram, then open the
link it shows (or send /link CODE to the bot). The code works once and for 15 minutes. After that, messages from your
Telegram account are saved as your own, private people; nobody else's messages are.
What to send
| You send | The bot does |
|---|---|
| A forwarded or shared contact | Saves the name and phone number. |
| A photo of a card, a badge, or a screenshot of a contact | Reads it with the vision model and keeps the photo on the person. A caption becomes what you talked about. |
A .vcf file |
Saves every card in it (up to 20). |
| A voice note, or an audio file | Transcribes it and parses the people mentioned. |
| A line of text | Parses it: "met Sarah from Acme, wants GPU pricing; also Raj from Jio". |
/event, /event GTC Asia, /event none |
Shows, sets or clears the event new people are tagged with today. |
The bot replies with what it saved and a link to each person, for example "Saved Sarah Okafor (Acme)" and "Tagged GTC Asia." A person you already know by phone, email or Telegram handle is updated ("Updated Raj") instead of duplicated; a name that only looks alike is saved as new and shown on the person's page to merge. The bot answers private chats only and ignores groups and edited messages. Files over 4 MB are declined.
If the daily People AI limit is reached or the organisation has no gear, the bot says so; contacts and .vcf files
still work because they need no AI.