---
title: The Telegram bot for People
description: 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.
section: cloud
order: 162
audience: [user, operator]
sources: ["services/nodejs-cloud/lib/people/comms.ts", "services/nodejs-cloud/app/(people)/people/telegram", "services/nodejs-cloud/app/api/integrations/people-telegram", services/nodejs-cloud/components/people/TelegramSettings.tsx, services/nodejs-cloud/lib/people/telegram.ts, services/nodejs-cloud/migrations/0165_people_capture.sql]
features: [cloud.api-integrations]
---

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](/docs/comms.md) 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](/docs/comms/support-and-people.md#people-capture-by-message)).

## 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.
