Amistio
Start building
Telegram connector

Setup guide

Start agents from Telegram messages

Create a bot with @BotFather, connect its token, and Amistio registers the webhook for you - every message to your bot can start an agent.

Official documentation

1. Create a bot with @BotFather

Open Telegram and message @BotFather. Send /newbot, pick a display name and a username ending in "bot". BotFather answers with the bot's token - a string like 123456789:AAH9x... Keep it private; anyone with the token controls the bot.

Official docs: BotFather and bot creation

2. Connect the token in Amistio

In the builder, pick the Telegram start card in the palette - the trigger's inspector asks for the token right there (or open Integrations to manage connections). It is stored encrypted in your vault and only ever sent to api.telegram.org.

3. Pick the trigger

The palette's Telegram start card configures the Trigger block to "New message to your bot". Select your connection in the inspector. Optionally set a chat id filter so only one group starts the agent.

4. Activate

Publish and activate the agent. Amistio calls Telegram's setWebhook with a unique, secret-protected URL - there is nothing to paste anywhere. Message your bot and watch the run appear.

Group messages: by default bots only see messages that mention them. To react to every group message, disable Group Privacy for your bot in @BotFather (/setprivacy), then re-add the bot to the group.

A Telegram bot has one webhook. If you activate a second agent on the same bot token, the webhook re-points to it and the first agent stops receiving messages - use one bot per agent, or one agent that routes.

Official docs: setWebhook

Replying from the agent

Add the "Reply in the same Telegram chat" action block - its chat id is pre-filled with {{trigger.source.chatId}}, so the answer lands in whatever chat started the run. Photos and documents sent to the bot are available as attachments on the trigger data.

Ready to try it? The trigger picker in the builder walks through the same steps.

Open the builder