Actions72
- Messages Actions
- Bots Actions
- Updates Actions
- Chats Actions
- Get Chat
- Get Chat Administrators
- Get Chat Member
- Get Chat Member Count
- Leave Chat
- Set Chat Title
- Set Chat Description
- Set Chat Photo
- Delete Chat Photo
- Set Chat Permissions
- Export Chat Invite Link
- Create Chat Invite Link
- Edit Chat Invite Link
- Revoke Chat Invite Link
- Approve Chat Join Request
- Decline Chat Join Request
- Set Chat Administrator Custom Title
- Ban Chat Member
- Unban Chat Member
- Restrict Chat Member
- Promote Chat Member
- Set Chat Sticker Set
- Delete Chat Sticker Set
- Pin Chat Message
- Unpin Chat Message
- Unpin All Chat Messages
- Files Actions
- Inline Queries Actions
- Callback Queries Actions
Overview
The node "N8N Tools Telegram" enables interaction with the Telegram Bot API, allowing users to perform various operations related to Telegram messaging, chats, bots, files, inline queries, and callback queries. Specifically, for the Messages resource and the Send Photo operation, this node sends a photo message to a specified Telegram chat.
This is useful in scenarios where automated workflows need to send images to Telegram users or groups, such as sending alerts with screenshots, sharing product photos, or broadcasting event images.
Example use cases:
- Sending a promotional image to a customer support group.
- Automatically sharing a photo captured by a security camera to a Telegram channel.
- Delivering visual reports or charts to a team chat.
Properties
| Name | Meaning |
|---|---|
| Chat ID | The unique identifier for the target Telegram chat where the photo will be sent. |
| Photo Data | JSON object containing the details of the photo to send. This typically includes fields like photo (file ID or URL), caption, and other optional parameters supported by Telegram's sendPhoto method. |
Output
The output of the node is a JSON object representing the response from the Telegram Bot API after sending the photo. This usually contains information about the sent message, including message ID, date, chat details, and the photo metadata.
If the operation succeeds, the output JSON reflects the Telegram message object for the sent photo.
The node does not output binary data directly; it handles photo sending via Telegram's API which manages the file upload or referencing internally.
Dependencies
- Requires an active Telegram Bot API token configured as credentials in n8n.
- Requires a valid subscription and API key for the "N8N Tools API" service, which validates usage before forwarding requests to Telegram.
- The node uses HTTP requests to communicate with both the N8N Tools API and Telegram Bot API endpoints.
Troubleshooting
- Invalid subscription or API key error: If you receive errors indicating invalid subscription or API key, verify that your API key credential for the N8N Tools API is correct and active.
- Malformed Photo Data: Ensure the JSON provided in the "Photo Data" property is correctly formatted according to Telegram's sendPhoto API requirements. Invalid JSON or missing required fields can cause failures.
- Chat ID issues: Confirm that the Chat ID is correct and that the bot has permission to send messages to that chat.
- Network or API errors: Check network connectivity and Telegram Bot API status if requests fail unexpectedly.
- Continue on Fail: If enabled, the node will continue processing subsequent items even if one fails, returning error details in the output JSON.