Veflow Docs
Messaging Channels

Telegram

Connect a Telegram bot to your AI Agent so it can chat with users on Telegram.

Connecting Telegram gives your AI Agent its own Telegram bot. People message the bot, the agent answers, and every thread appears in your Conversation inbox under the Telegram channel.

What you need

  • A published or ready-to-publish AI Agent — see Creating AI Agents.
  • A Telegram account to create the bot with.

Step 1 — Create a bot with BotFather

  1. In Telegram, search for @BotFather and open it.
  2. Send /newbot and follow the instructions: pick a display name and a unique bot username.
  3. BotFather replies with a Bot Token (a long string like 123456789:ABCDEF...). Copy it and keep it secret — anyone with the token controls the bot.
  4. Optionally use /setdescription and /setuserpic to polish the bot's profile.

Step 2 — Connect the bot to your agent

  1. Open your agent in the studio, click Publish, and choose Social Media Connector. (For an already published agent, use Manage Social Media Config.)
  2. On the Telegram card, paste the token into Bot Token.
  3. Click Connect. Veflow verifies the token and registers the webhook; on success the card shows Connected as followed by the bot's username.

Each agent has its own Telegram configuration, so different agents can run different bots. Use Update Config on the card to swap tokens later, or Disconnect to remove the connection.

Step 3 — Verify users with the code

Only verified people can talk to the agent, so the bot can't be used by strangers:

  1. On the same Telegram card, find the User Verification section showing Your Verification Code — a short 6-character code. Click Generate Code if none exists yet (or Regenerate to invalidate the old one).
  2. Open the bot in Telegram and press Start.
  3. The bot asks for your code — send the 6-character code as a message.
  4. The bot replies "Verification Successful!" and links your Telegram account. From then on, just chat — the agent answers using its prompt, knowledge bases, and tools.

Each team member who should use the bot generates and sends their own code from their Veflow account.

Company notification bot (optional)

Separately from per-agent bots, Workspace Setting has a social media section where an admin can connect one company-wide Telegram Bot used for outbound notifications — reports, follow-up alerts, and CRM messages. It also takes a token from @BotFather, plus a default chat or group ID to send notifications to, and offers a Test connection check. Connecting an agent's chat bot and the company notification bot are independent steps.

Troubleshooting

  • Bot not responding — check the card still shows Connected as your bot; reconnect if the token changed.
  • The bot keeps asking for a code — the verification code was regenerated or never sent; send the current code shown in the Telegram card.
  • Wrong bot answering — verify which agent the token is connected to; one token should only be used by one agent.

Prefer WhatsApp? See WhatsApp.

On this page