Skip to main content

1. Technical configuration

1.6 Admin Notifications: Telegram Bot Setup

Telegram notifications provide a fast, reliable, and cost-free way to keep admins informed about important events on the platform in real time. Messages are delivered instantly to any device where Telegram is installed — phone, desktop, or web — and can be directed to admins. Compared to email, Telegram offers near-instant delivery, better visibility (no lost messages in spam folders), and the ability to group relevant people in one channel. To enable this, we connect our platform to a dedicated Telegram bot on your side, which acts as the sender for all types of notifications.

To enable admin notifications via Telegram in our platform, we need two pieces of information from your side:

✍️
Bot name — in the format @your_bot_name
Bot token — a long string provided by Telegram, e.g. 123456789:ABCdefGhIJKlmNoPQRsTUVwxyZ

Both are generated free of charge by Telegram’s official @BotFather service. The whole process takes about 2–3 minutes.

Before you start
You will need a Telegram account and the Telegram app installed on your phone or desktop. If you don’t have one yet, download Telegram from telegram.org and register with your phone number.

Step 1. Open BotFather in Telegram

BotFather is the official Telegram bot used to create and manage other bots.

  1. Open Telegram and tap the search icon at the top.
  2. Type @BotFather in the search field.
  3. Select the account with the blue verified checkmark next to the name — this confirms it’s the real BotFather.
  4. Tap Start (or send the command /start) to begin the chat.
❗
Important
Only use the official BotFather with the verified checkmark. There are fake bots with similar names that will steal your token.

Step 2. Create a new bot

  1. In the BotFather chat, send the command: /newbot
  2. BotFather will ask for a display name for the bot. This is the friendly name shown in chats (e.g. Company Admin Notifications). It can contain spaces and be changed later.
  3. Next, BotFather will ask for a username. This is the permanent @handle and must:
  • Be unique across Telegram
  • End with the word bot (e.g. company_admin_bot, MyCompanyNotifyBot)
  • Contain only Latin letters, digits, and underscores
  • Be between 5 and 32 characters long

If the username is already taken, BotFather will ask you to try another one.

Step 3. Copy the bot name and token

Once the username is accepted, BotFather will send a confirmation message containing everything you need.

🚫
Security warning
The bot token is equivalent to a password — anyone with it can send messages as your bot and read incoming ones. Please share it with us through a secure channel (e.g. Private Note) and never post it publicly. If the token is ever exposed, you can regenerate it in BotFather with /revoke.