search

Telegram

Deploy an AI agent to Telegram.

circle-info

Requires a Telegram account.

Publishing an AI agent to Telegram allows your audience to interact with the agent—and subsequently with live agents—in a Telegram thread.

In the agent's Publish tab, create a Telegram channel or select an existing one from the table to open its settings.

hashtag
Basic Settings

In the Basics accordion, the following options are available:

  • Name — the internal name of the channel, used to distinguish from any other Telegram channels the agent is published to.

  • Default chat language — the language used by the AI agent at the start of a new chat. Available languages are set in the agent's General settings.

  • Icon — the channel's avatar seen by live agents in the Inbox dashboard.

Press Save to confirm edits.

hashtag
Connecting to Telegram

hashtag
Configuration

  • Authentication token - required to authorize the Telegram channel

hashtag
Telegram Create a New Bot

  1. Login to your Telegram account and start chatting with BotFatherarrow-up-right. BotFather is the one bot to rule them all on Telegram. It will help you create new bots and change settings for existing ones.

  1. Use the /newbot command to create a new bot. The BotFather will ask you for a name and username, then generate an authentication token for your new bot.

  • The name of your bot that will be shown to your customer/end user.

  • The Username is a short name, to be used in mentions and t.me links. Usernames are 5-32 characters long and are case insensitive, but may only include Latin characters, numbers, and underscores. Your bot's username must end in 'bot', e.g. 'tetris_bot' or 'TetrisBot'.

  • The token is a string is required to authorize the bot and send requests to the Telegram Bot API.

triangle-exclamation

Important

Keep your token secure and store it safely, it can be used by anyone to control your bot.

circle-info

If your existing token is compromised or you lost it for some reason, use the /token command to generate a new one.

  1. Copy and paste the token to your Telegram channel Authentication token on Proto's platform.

  2. Click on the Verify button. If verification successful, a t.me/<bot_username> link will be generated and you can share this link to your customer.

  3. Click on the Save button to save the Authentication token.

  1. Use /setjoingroups command to disable the bot to be added into group chats. Select the bot you created and type "Disable"

  2. After disable the join group setting of your bot on Telegram, you enabled the Telegram channel and click SAVE.

circle-exclamation

Reminder

You will not be able to enable your Telegram channel on Proto's platform if you didn't DISABLED the Allow Group setting .

You can use /mybots command to return a list of your bots on your Telegram account to edit their settings. Please refer to the documentation on Telegramarrow-up-right to learn more about the commands you can use.

In the Configuration accordion, a token is required from Telegram.

To get this, use Telegram's BotFather chatbot to create a bot and gets its token:

  1. Login to your Telegram account and start chatting with BotFatherarrow-up-right, used to create new bots and change settings for existing ones.

  2. Insert the /newbot command to create a new bot.

  3. BotFather will ask for you to insert a:

    • Name — the bot's name shown to people who chat with it.

    • Username — the bot's short name, used in mentions and 't.me' links. It must be 5-32 characters long and is case sensitive, and only include letters, numbers, and underscores. The username must also end in "bot", e.g. "help_bot" or "HelpBot".

  4. BotFather will then generate the bot's token, which allows anyone to control the bot. If it's lost or compromised, use the /token command to generate a new one.

  5. Insert the /setjoingroups command to disable the bot from being added to group chats, required for integration with Proto. Select the bot and type "Disable"

  6. In Proto, paste the token into the Telegram configuration's Authentication token field.

  7. Press Verify. If successful, a t.me/<bot_username> link will be generated and you can share this link with your audience.

  8. Press Save to confirm edits.

See Telegram documentationarrow-up-right for a full list of BotFather commands and options.

hashtag
Using Telegram

Follow the link generated in step 7 above to open a thread with the bot (your AI agent) in Telegram.

PreviousWhatsAppNextLINE

Last updated