The Telegram channel turns your agent into a Telegram bot. When someone messages your AI agent on Telegram, your agent reads it, generates a response, and replies — all automatically.
Step 1 — Create a Telegram bot
You need a Telegram bot token before you can set up the channel. Here's how to get one:
- Open Telegram and search for @BotFather (it's Telegram's official bot creation tool)
- Start a chat and send
/newbot - Follow the prompts — give your AI agent a name (display name) and a username (must end in
bot, e.g.mysupportbot) - BotFather will give you a bot token that looks like:
7234567890:AAFxxxxxxxxxxxxxxxx
Copy that token — you'll need it in the next step.
Set an AI agent description (optional but recommended): send /setdescription to BotFather and write a short description of what the AI agent helps with. This shows up when users find your AI agent.
Step 2 — Add the Telegram channel in Vosaire
Go to your agent → Channels tab → Add Channel → Telegram.
Paste in your bot token. Vosaire will verify it immediately — if it's valid, you'll see your AI agent's username appear. If it shows an error, double-check the token for typos.
Give the channel a name and set the reply mode (Auto-reply or Draft), then click Add Channel.
Vosaire automatically registers a webhook with Telegram in the background. This is what makes messages flow from Telegram to your agent in real time — you don't need to configure this manually.
Step 3 — Test it
Open Telegram, search for your AI agent's username, and send it a message. Your agent should reply within a few seconds.
If there's no response:
- Wait 10–15 seconds — the first message can occasionally have a small delay
- Check the channel is showing as Active in Vosaire
- Make sure your agent has knowledge sources indexed — an agent with no sources will not reply
Settings
In the channel config, there are a couple of Telegram-specific options:
Allow group chats — by default the AI agent only responds in direct messages (1:1). Enable this if you want the AI agent to participate in group chats.
Bot username — shown for reference, this is the username your AI agent is reachable at on Telegram.
Important: one bot per channel
Each Telegram bot token can only be connected to one Vosaire channel. This is a Telegram limitation — a bot can only have one webhook registered at a time.
If you want multiple agents to have Telegram access, you'll need to create a separate Telegram bot for each one (back to BotFather, /newbot again).
If you want to change which Vosaire agent handles a Telegram channel, you can update the Default AI Agent setting on the channel — no need to recreate the bot or the channel.