DocsIntegrationsTelegram

Telegram

A Telegram bot that messages you, a group or a channel. Most people start here: it takes two minutes and the alerts land on your phone.

CategoryChat
Used byTelegram node
Secret fields1
TestYes

Set it up

  1. In Telegram, open a chat with @BotFather, send /newbot and follow along. Copy the token it gives you.
  2. Add your bot to the chat, group or channel it should post in, and send it any message so it can see the chat.
  3. In the console, open Integrations, choose Add integration, pick Telegram and paste the token.
  4. Press Test, then pick the integration in a Telegram node and choose the chat from the list.

Fields

FieldRequiredWhat it is
Bot tokenbotTokensecretYesFrom @BotFather: digits, a colon, then the key, like 123456:ABC-DEF….

Secret fields are encrypted as soon as you save them and never shown again: the console shows their last four characters so you can tell which one is saved. Replace one to rotate it; workflows pick up the new one on their next step.

Test it

Asks Telegram who the bot is (getMe). Nothing is posted.

Finding the chatThe chat list shows chats the bot heard from in the last 24 hours. If yours is missing, send the bot a message there and refresh. A public channel can also be named as @channelname.

Problems you might see

CodeMeans
INTEGRATION_AUTH_FAILEDTelegram doesn't know the token. It was revoked or mistyped.
TELEGRAM_CHAT_FORBIDDENAt send time: the bot was blocked or removed from the chat.

Codes starting INTEGRATION_ come from saving or testing. Every other integration code is on the error codes page.