Docs

Telegram Setting

Use Security > Telegram Setting to manage Telegram bot based notification channels.

This module allows you to:

  • add new Telegram bot configurations
  • edit existing bot settings
  • enable or disable each bot with Active toggle
  • assign different bots by service type such as OTP, Support, Deposit, or KYC

Current Panel Overview

The video covers:

  • User and Admin tabs
  • add and edit flow
  • Service Type selection
  • Active enable and disable behavior
  • bot token and group configuration

Required Fields

  • Service Type: notification scenario to bind this bot to
  • Bot Username: bot handle such as xyz_bot
  • Bot Token: Telegram bot token
  • Group Id: target Telegram group chat id

What to Enter in Each Field

  • Service Type: choose the exact notification purpose shown in the dropdown, such as KYC Verification Bot or another operational event type
  • Bot Username: enter the Telegram bot username created in @BotFather
  • Bot Token: paste the full bot token provided by @BotFather
  • Group Id: enter the Telegram group chat id where notifications should be delivered

Important:

  • Service Type decides where this bot will be used, so choose it carefully.
  • Bot Username and Bot Token must belong to the same bot.
  • Group Id must belong to a group where that bot has already been added.
  • If Group Id is wrong, notifications will not reach the target group.

Add or Edit a Telegram Bot

  1. Open Security > Telegram Setting.
  2. Select the correct tab such as User or Admin.
  3. Click Add or use the row edit action for an existing bot.
  4. Select the correct Service Type.
  5. Enter Bot Username, Bot Token, and Group Id.
  6. Click Submit to save the record.

If the video flow is followed for a KYC bot:

  • select KYC Verification Bot in Service Type
  • enter the bot username from BotFather
  • paste the matching bot token
  • enter the Telegram group id where KYC alerts should be sent

Enable and Disable Flow

Each bot entry includes an Active toggle:

  • ON: the bot is active and notifications are sent
  • OFF: the bot is disabled and notifications stop

After a toggle change, the system uses the current status for that service type.

Group Notification Setup Logic

  1. Create the bot with @BotFather.
  2. Copy the bot token.
  3. Add the bot to the target Telegram group.
  4. Ensure the bot has permission to send messages if required.
  5. Get the group chat id and set it in Group Id.
  6. Save the configuration and test the notification flow.

Where to Get Values

  • Bot Username and Bot Token: from @BotFather
  • Group Id: from Telegram Bot API getUpdates or helper chat-id bots after adding the bot to the group
  • Service Type: selected based on your notification use case

Operational Best Practices

  • Use separate bots for User and Admin channels.
  • Keep critical service types actively monitored.
  • If the token is rotated, update bot configuration immediately.
  • Never expose bot tokens in public docs, screenshots, or logs.