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 Send Video operation, this node sends a video message to a specified Telegram chat.
This node is beneficial in automation workflows where sending multimedia content via Telegram is required, such as:
- Sending promotional or informational videos to customers.
- Delivering tutorial or update videos automatically to a group or individual.
- Broadcasting event highlights or announcements through Telegram channels or groups.
Example use case: Automatically send a welcome video to new members joining a Telegram group.
Properties
| Name | Meaning |
|---|---|
| Chat ID | Telegram Chat ID where the video will be sent. |
| Video Data | JSON object containing the Telegram video message data. This includes parameters like video file, caption, duration, width, height, supports_streaming, etc., as defined by Telegram Bot API's sendVideo method. |
Output
The node outputs an array of JSON objects corresponding to each input item processed. Each output JSON contains the response from the Telegram Bot API for the sendVideo request, which typically includes details about the sent message (message ID, date, chat info, video metadata, etc.).
If an error occurs during processing and the node is set to continue on failure, the output JSON will contain an error field with the error message.
No binary data output is indicated for this operation.
Dependencies
- Requires a valid Telegram Bot API token configured as credentials in n8n.
- Requires a subscription and API key for the external "N8N Tools API" service, which validates usage before forwarding requests to Telegram.
- The node uses the external "N8N Tools API" endpoint (
/api/v1/validate) to verify the API key and subscription status before executing Telegram API calls. - Proper network access to both the N8N Tools API and Telegram Bot API endpoints is necessary.
Troubleshooting
- Invalid subscription or API key error: If the validation request to the N8N Tools API returns 401 or 403, it indicates invalid or expired credentials. Verify that the API key and subscription are active and correctly configured.
- Unknown operation error: If an unsupported operation name is provided, the node throws an error indicating the unknown operation. Ensure the operation parameter matches one of the supported values.
- JSON parsing errors: Input properties like
videoDatamust be valid JSON strings. Malformed JSON will cause parsing failures. Validate JSON syntax before running the node. - Telegram API errors: Errors returned from Telegram (e.g., invalid chat ID, file not found) will propagate. Check the error messages for guidance on fixing issues like incorrect chat IDs or missing video files.
Links and References
- Telegram Bot API - sendVideo
- n8n Documentation - Creating Custom Nodes
- N8N Tools API Documentation (for subscription and API key management)