header
login

Telegram Integration

Telegram is the primary channel for bots in TheQueue. Setup takes just a few minutes and requires no coding.

Connecting a Bot

1. Create a Bot in Telegram

  1. Open @BotFather in Telegram
  2. Send the /newbot command
  3. Enter the bot name and username
  4. Copy the received token (format: 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11)

2. Add the Token to TheQueue

  1. Open your project in the visual editor
  2. Add a Telegram trigger (right-click → Triggers → Telegram)
  3. Double-click the trigger → paste the bot token in the bot_api field
  4. Save (Ctrl+S)

The bot will start receiving messages automatically.

Available Data

The following variables are available when a message is received:

Variable Description
{=message=} Message text
{=tgData.from.id=} User ID
{=tgData.from.first_name=} First name
{=tgData.from.last_name=} Last name
{=tgData.from.username=} Username
{=tgData.chat.id=} Chat ID
{=tgData.message_id=} Message ID

Buttons

Add interactive buttons to messages via the send_message function:

Choose an action:
{buttons:[[Button 1] [Button 2]][[Button 3]]}

Limitations

  • Maximum message length — 4096 characters (Telegram API limit)
  • Bot token must be unique per project