Telegram channel issues usually come down to three things: the bot token, the webhook registration, or the channel configuration in Vosaire. Here's how to trace the problem.
The bot doesn't reply to messages
Check 1 — Is the channel active?
Go to your agent → Channels tab → find the Telegram channel → make sure the toggle is On. An inactive channel won't process any incoming messages.
Check 2 — Is the bot token valid?
Open the channel settings and look at the AI Agent Token field. The token should look like 123456789:ABCdef... (a number, a colon, and a long alphanumeric string).
To verify it's still valid, open a browser and visit:
https://api.telegram.org/bot<YOUR_TOKEN>/getMe
Replace <YOUR_TOKEN> with your actual token. If the token is valid, you'll see a JSON response with your bot's username. If it returns an error, the token is invalid or was revoked.
To get a new token: open BotFather in Telegram → send /mybots → select your bot → API Token → Revoke current token → generate a new one. Update the token in your Vosaire channel settings.
Check 3 — Was the webhook set correctly?
When you save a Telegram channel in Vosaire, it automatically registers the webhook with Telegram. Check if the webhook is set by visiting:
https://api.telegram.org/bot<YOUR_TOKEN>/getWebhookInfo
Look at the url field — it should point to Vosaire's servers. If it's empty or wrong, delete the channel in Vosaire and recreate it. Saving a new channel triggers a fresh webhook registration.
Check 4 — Is the bot an admin in the group (if using a group chat)?
For Telegram group chats, the bot must be added as a member and may need admin permissions depending on what capabilities you want. Add the AI agent to the group and grant it message-related permissions.
The bot was working before but stopped
This almost always means the bot token was revoked. This can happen if:
- Someone went into BotFather and regenerated the token
- The Telegram account that owns the bot was compromised and changed
Follow Check 2 above to verify the token and generate a new one if needed. Then update the token in your channel settings.
Webhook conflict — multiple registrations
Telegram only allows one webhook per bot token. If you accidentally created two Vosaire channels with the same token, or if something else registered a webhook for that bot, you'll have a conflict.
To reset: visit the following URL to clear the webhook entirely:
https://api.telegram.org/bot<YOUR_TOKEN>/deleteWebhook
Then go back to your Vosaire channel and save it again — this will re-register the webhook cleanly.
Bot replies but with wrong answers
If the bot is replying but the answers are off, this is a training issue, not a Telegram issue. The Telegram channel is just a delivery mechanism — the responses come from your agent's knowledge sources and training.
See Training your agent from conversations for how to improve response quality.
Testing that the bot works
The simplest test: open Telegram, find your bot by its username, and send /start. If your agent is configured and the channel is active, you should get a response within a few seconds.
If you see no response at all after 30 seconds, work through the checks above. If you see an error message from Telegram itself (not your agent), that suggests a webhook or API issue.
Need more help?
Contact support with:
- Your bot username (e.g.,
@MyCompanyBot) - The output of
getWebhookInfo(visit the URL from Check 3 and paste the result) - Your organization ID from Settings → Organization
- Approximately when the issue started