Table of contents

Connect a Telegram bot

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

Official Telegram bot tutorial

External requirements checked: 23 August 2026

Create a separate test bot

  1. 1Open the verified @BotFather account in Telegram
  2. 2Run /newbot and complete the requested name and username
  3. 3Copy 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. 1Sign in to the company dashboard
  2. 2Open Bots and select Add bot
  3. 3Choose Telegram, enter the token, and save
  4. 4Confirm 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. 1Send a test message through the MassAccess API
  2. 2Confirm the request response and message record
  3. 3Verify the status webhook or dashboard status
  4. 4Test 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