Skip to content
Docs menu

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.

View .md

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)

  1. In Telegram, open @BotFather and send /newbot. Choose a name and a username.
  2. Copy the token BotFather gives you (it looks like 123456789:AA…).
  3. 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).

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.