Telegram Block
The Telegram Block connects your Telegram Bot to Convotic, enabling message sync, callback queries, and deep link tracking.
Features
- Bot messages -- all messages sent to your Telegram bot are synced to Convotic. Agents can reply from the inbox.
- Callback queries -- handle inline keyboard button taps as workflow triggers or route them to agents.
- Deep links -- use
t.me/YourBot?start=campaign_iddeep links for attribution and campaign tracking. - Media support -- send and receive photos, documents, audio, video, stickers, and locations.
Connection flow
- Go to Settings > Blocks > Telegram and click Connect.
- Create a bot via @BotFather on Telegram if you haven't already.
- Paste your Bot Token into Convotic.
- Convotic sets the webhook on your bot and verifies the connection.
Workflow triggers
| Trigger | Description |
|---|---|
new_message | Fires on any incoming message to the bot. |
keyword | Fires when a message matches a keyword. |
postback | Fires when a user taps an inline keyboard button (callback query). |
new_conversation | Fires when a user sends their first message to the bot. |
Deep links
Use Telegram deep links (t.me/YourBot?start=<payload>) to attribute new users to specific campaigns. The start parameter is captured in the new_conversation trigger and can be used in Workflow conditions or stored as a contact attribute.
Limitations
- Telegram bots cannot initiate conversations; the user must message the bot first.
- Group chat support requires the bot to be added as an admin.
- File uploads are limited to 50 MB via the Bot API.