Telegram Setup Guide

BEFORE YOU START

What you need

• A Telegram bot created with BotFather
• The bot token issued by BotFather
• Permission to manage Integrations in your SEROS workspace

CONNECTION STEPS

Connect Telegram, one click at a time

Complete each small action in order. Do not move to the next step until the expected result matches what you see.

1. 01
   TelegramOpen @BotFather

   Open the real BotFather account

   BotFather is Telegram's official bot-management account. Use only the verified account named @BotFather.

   • Open Telegram on your phone or computer.
   • Use Search and type @BotFather.
   • Open the verified BotFather chat and select Start.

   Expected resultBotFather displays a list of commands you can use.

2. 02
   Telegram · BotFather

   Create a new bot

   BotFather asks for two names. The first is the public display name; the second is the unique username customers will search for.

   • Send /newbot in the BotFather chat.
   • Enter a clear display name, for example “SEROS Support”.
   • Enter a unique username ending in bot, for example seros_support_bot.
   • If the username is taken, change it slightly and send it again.

   Expected resultBotFather confirms that the bot was created and shows a long authentication token.

3. 03
   Telegram · BotFather

   Copy the bot token

   The token is the long value containing numbers, a colon, and letters. Anyone with it can control the bot, so treat it like a password.

   • Press and hold the token, then choose Copy.
   • Do not copy the bot username or the t.me link by mistake.
   • Keep the BotFather chat open until the SEROS setup is saved.

   Expected resultThe full authentication token is in your clipboard.

4. 04
   SEROS

   Open the Telegram connection form

   Now move to the SEROS workspace where your team should receive Telegram conversations.

   • Open SEROS and select Integrations in the left menu.
   • Scroll to the Telegram block.
   • Select Connect.
   • In Connection name, enter a team-friendly name such as “Main support bot”.

   Expected resultThe Telegram bot token field is visible in the setup window.

5. 05
   SEROS

   Paste and save the token

   SEROS encrypts the token when you submit the form and will not show the saved value again.

   • Click the Telegram bot token field.
   • Paste the token copied from BotFather.
   • Check that there are no spaces before or after it.
   • Select Save securely.

   Expected resultSEROS opens Finish setup and the connection status is Pending.

6. 06
   SEROS

   Test and activate the connection

   The Test action checks the token with Telegram. Activate then registers the secure webhook automatically.

   • Close Finish setup and find the new Telegram connection inside its block.
   • Select Test and wait for the bot name to be confirmed.
   • Select Activate.
   • Confirm that the status changes to Active.

   Expected resultThe Telegram connection shows Active with a successful health check.

7. 07
   Telegram + SEROS Inbox

   Send a real message and reply

   Telegram bots cannot start a private chat. A person must message the bot first.

   • From a Telegram account that is not the bot owner, open the bot username and select Start.
   • Send a simple message such as “Hello”.
   • In SEROS, open Unified Inbox and select the new Telegram conversation.
   • Send a reply from SEROS and confirm it arrives in Telegram.

   Expected resultBoth the incoming message and the SEROS reply are visible in the two apps.

FINAL CHECK

Verify before your team relies on it

• The integration health check reports the bot identity
• The connection status is Active
• A new customer message appears in the Unified Inbox
• A reply sent from SEROS arrives in Telegram

IMPORTANT NOTES

Know the provider rules