Skip to main content

How do I connect Telegram, Slack or Discord to my agent, and why doesn't the bot reply?

Set up Telegram, Slack or Discord for an agent, including the user allowlists, and fix a bot that doesn't answer.

Every agent works in its web chat with no extra setup. Telegram, Slack and Discord are optional extra channels. They're available on every agent and don't change the plan price, though replies through them use credits like any other reply. A channel turns on as soon as every required field on its card is saved, and saving restarts a running agent.

Telegram

  1. In Telegram, message @BotFather, send /newbot, and paste the token it gives you into Telegram Bot Token.

  2. Under Allowed Telegram DM User IDs, add the numeric user ID of every person who may message the bot, for example from @userinfobot. User IDs are positive numbers of at least 5 digits; @usernames and phone numbers don't work.

  3. Optional: under Allowed Telegram Groups, add a group's chat ID (a negative number, often starting with -100) together with the user IDs allowed to use the bot there. In groups, people must mention the bot.

Slack

  1. Create a Slack app for the agent, add the bot scopes and events listed in the field help, install it to your workspace, and paste the Bot User OAuth Token (xoxb-...).

  2. Turn on Socket Mode, create an App-Level Token with only the connections:write scope, and paste it (xapp-...). Both tokens must come from the same app.

  3. Enter the Workspace ID, which starts with T, and the member IDs (starting with U or W) of the people allowed to message the bot directly.

  4. Optional: add channels, each with its own allowed members. In channels the bot answers only when mentioned.

Discord

  1. In the Discord Developer Portal, create an application and its bot, turn on Message Content Intent (plus Server Members Intent for the user and role allowlists), and paste the bot token.

  2. Add the numeric user IDs (15 to 22 digits; turn on Developer Mode and use Copy User ID) of the people allowed to message the bot directly.

  3. Invite the bot to your server with the link from the OAuth2 URL Generator. Optional: add server rows with the allowed channels and users or roles; there, too, the bot answers only when mentioned.

Why the bot doesn't reply

  • The sender isn't on the allowlist. The bot ignores them without any message. Add their numeric ID, not a username.

  • It's a group, channel or server. The bot must be mentioned, and that place needs its own entry that includes the sender's ID.

  • The agent is stopped or out of credits. See Why won't my agent start or reply?

  • The token changed. If you regenerated the bot token (for example in BotFather), paste the new one and save.

  • A required field is empty. The channel stays off until all of its required fields are saved.

For team agents, Chat Mode decides whether approved direct-message users share one conversation with the agent (see agents in a team). To turn a channel off, clear one of its required fields and save.

Docs: Telegram and communication channels.

Did this answer your question?

Related Articles