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_id deep links for attribution and campaign tracking.
• Media support -- send and receive photos, documents, audio, video, stickers, and locations.

Connection flow

1. Go to Settings > Blocks > Telegram and click Connect.
2. Create a bot via @BotFather on Telegram if you haven't already.
3. Paste your Bot Token into Convotic.
4. 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.