nœuds / builtin / integration
Telegram
Send messages, photos and documents to a Telegram chat via the Bot API.
Ce contenu n’est pas encore disponible dans votre langue.
Send a message, a photo or a file to a Telegram chat through your own bot, a simple way to get alerts on your phone.
What it does
Section titled “What it does”The node sends one thing to one chat each time it runs, using a Telegram bot you create:
- Send message: a text message.
- Send photo: an image, with an optional Caption.
- Send document: any file, with an optional Caption.
Photo and Document accept a web address, a Telegram file id, or a base64 data: URL. A data URL, such as the dataUrl from Screenshot Page, is uploaded as a file, so you can send a picture of the page you are on.
The node only sends. It cannot read the messages people send to your bot.
When to use it
Section titled “When to use it”- Get a phone alert when a page you watch changes, with a screenshot of it.
- Receive a daily digest or an AI summary in a private chat.
- Post updates to a group or channel your bot belongs to.
- Send yourself a file a workflow produced, such as a PDF found on a page.
For Slack or Discord channels, use Slack or Discord. For a notification with no bot to set up, see Push Notification.
Inputs and settings
Section titled “Inputs and settings”| Réglage | Type | Ce que cela fait |
|---|---|---|
| Credential (obligatoire) | Credential | The Telegram bot token (from @BotFather). It is the whole credential and grants full control of the bot — keep it secret. |
3 choix · choisissez Resource and Operation pour voir ses réglages
Réglages de Message · Send message
| Réglage | Type | Ce que cela fait |
|---|---|---|
| Chat ID (obligatoire) | Text | The target chat: a numeric chat ID, or a channel username like @mychannel. |
| Text (obligatoire) | Text | The message text. |
| Formatting | Choice | How to interpret formatting in the text/caption. Options: None, Markdown, MarkdownV2, HTML. |
Réglages de Message · Send photo
| Réglage | Type | Ce que cela fait |
|---|---|---|
| Chat ID (obligatoire) | Text | The target chat: a numeric chat ID, or a channel username like @mychannel. |
| Photo (obligatoire) | Text | An image URL, a Telegram file_id, or a base64 data URL (e.g. from Screenshot Page). |
| Caption | Text | Optional caption shown under the photo/document. |
| Formatting | Choice | How to interpret formatting in the text/caption. Options: None, Markdown, MarkdownV2, HTML. |
Réglages de Message · Send document
| Réglage | Type | Ce que cela fait |
|---|---|---|
| Chat ID (obligatoire) | Text | The target chat: a numeric chat ID, or a channel username like @mychannel. |
| Document (obligatoire) | Text | A file URL, a Telegram file_id, or a base64 data URL. |
| Caption | Text | Optional caption shown under the photo/document. |
| Formatting | Choice | How to interpret formatting in the text/caption. Options: None, Markdown, MarkdownV2, HTML. |
Affichage des réglages de Message · Send message
- Chat ID is a number for a person or group (groups start with
-, like-1001234567890), or@channelnamefor a public channel. To find your own chat id, send any message to your bot, then openhttps://api.telegram.org/bot<your token>/getUpdatesin the browser and look for"chat":{"id":…}. - Formatting decides how
*bold*,_italic_or<b>tags</b>in Text or Caption are shown. Leave it onNonefor plain text. WithMarkdownV2, characters like.,-and!must be escaped with\, soHTMLis often easier.
Outputs
Section titled “Outputs”-
Output
The output is the message Telegram created: its message_id, the chat it went to, the date, and the text or the photo / document details. Keep message_id if a later step needs to refer to the message.
Dependencies and credentials
Section titled “Dependencies and credentials”- Credential (connection, Bearer Token): required. See Connect Telegram.
The credential is your bot’s token, saved as a Bearer Token credential:
- In Telegram, open a chat with @BotFather and send
/newbot. - Choose a name and a username. BotFather replies with a token like
123456789:ABCdefGhIJKlmNoPQRstuVWxyz. - Paste the token into a new credential. See Create a credential.
- Open a chat with your new bot and press Start, or add it to the group or channel you want to post in. A bot cannot message someone who never started it.
Anyone with the token controls the bot, so keep it private. If it leaks, send /revoke to @BotFather and update the credential.
Example workflow
Section titled “Example workflow”- An Element Change trigger watches CSS Selectors
.stock-statuson a product page. - Screenshot Page captures the visible page.
- Telegram, Send photo, Chat ID
123456789, Photo{{ $input.dataUrl }}, Caption<b>Stock changed</b> on {{ $('Element Change').url }}, FormattingHTML.
Common issues
Section titled “Common issues”- “Telegram API Error: Unauthorized”. The token is wrong or was revoked. Get the current token from @BotFather and update the credential.
- “Telegram API Error: Bad Request: chat not found”. The Chat ID is wrong, or the bot was never started in that chat or added to that group. Press Start in the bot’s chat, or add the bot, then try again.
- “Telegram API Error: Bad Request: can’t parse entities…”. The text does not follow the chosen Formatting. Fix the markup, escape special characters, or set Formatting to
None. - “Telegram API Error: Forbidden: bot was blocked by the user”. The person blocked the bot. They need to unblock it and press Start again.
- “Only base64 data URLs are supported”. The Photo or Document value starts with
data:but is not base64. Use thedataUrlfrom Screenshot Page as it is, or a web address.
Related nodes
Section titled “Related nodes”- Screenshot Page: a picture of the page to send.
- Push Notification: phone notifications through ntfy or Pushover.
- Slack and Discord: other chat apps.
- Digest: bundle several changes into one message.