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
- In Telegram, open a chat with @BotFather, send
/newbotand follow along. Copy the token it gives you. - Add your bot to the chat, group or channel it should post in, and send it any message so it can see the chat.
- In the console, open Integrations, choose Add integration, pick Telegram and paste the token.
- Press Test, then pick the integration in a Telegram node and choose the chat from the list.
Fields
| Field | Required | What it is |
|---|---|---|
| Bot tokenbotToken | Yes | From @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
| Code | Means |
|---|---|
INTEGRATION_AUTH_FAILED | Telegram doesn't know the token. It was revoked or mistyped. |
TELEGRAM_CHAT_FORBIDDEN | At 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.