Connect a Telegram bot

Create a company bot through BotFather, protect its token, and connect it in MassAccess.

Official Telegram bot tutorialExternal requirements checked: 23 August 2026

Create a separate test bot

  1. 01Open the verified @BotFather account in Telegram
  2. 02Run /newbot and complete the requested name and username
  3. 03Copy the generated token into an approved secret store

Treat the token as a password

Do not paste a real token into source code, screenshots, tickets, chat messages, or documentation.

Connect it to MassAccess

  1. 01Sign in to the company dashboard
  2. 02Open Bots and select Add bot
  3. 03Choose Telegram, enter the token, and save
  4. 04Confirm that the connection state reports a configured webhook
/dashboard/bots/new

Register the test recipient

Open the bot from a separate test account, start the bot flow, and share the contact requested by your scenario before sending by phone number.

Verify send and status

  1. 01Send a test message through the MassAccess API
  2. 02Confirm the request response and message record
  3. 03Verify the status webhook or dashboard status
  4. 04Test a controlled failure without exposing the token

Common checks

  • The recipient has not started the bot
  • The recipient did not share the required contact
  • The token was revoked or entered incorrectly
  • The webhook connection state is not healthy