Channels: Telegram

Telegram is a Tier 1 channel. You create a bot with Telegram’s BotFather, paste its token into Wayland, and the bot relays messages between Telegram and an assistant.

Before you start (prerequisites and accounts)

• A Telegram account.
• The Wayland desktop app running, with at least one model provider connected so an assistant can reply.

Create the credentials (on the provider side)

1. In Telegram, open a chat with @BotFather.
2. Send /newbot and follow the prompts to name the bot and choose a username (the username must end in bot).
3. BotFather returns a bot token. Copy it. Keep it private: anyone with the token can control the bot.

Connect it in Wayland (Settings -> Channels -> Telegram)

1. Open Settings -> Channels and choose Telegram.
2. Paste the token into the Bot token field.
3. There is a token-test step that checks the token and reads back the bot username before you save.
4. Save the configuration.

Telegram uses long polling by default, so you do not need a public webhook URL.

Verify (status goes from idle to connected, send a test message)

After saving, the channel status moves from idle to connected. The page shows a Next Steps guide. Message your bot in Telegram and confirm a reply comes back. New senders may appear under Pending Pairings or Authorized Users: approve the sender there so the bot will respond to them.

Route to an assistant or team

On the Telegram page, set the Assistant and the Default Model the channel should use. Inbound Telegram messages are handled by that assistant.

Troubleshooting

If the bot does not reply, recheck the token, confirm the sender is authorized, and review Channel Connection Issues.

Next

• Channels
• Create a Custom Assistant
• FAQ and Troubleshooting