Actions23
- Chat Actions
- Callback Actions
- File Actions
- Message Actions
Overview
The "Send Video" operation of the Message resource in this Telegram node allows users to send video files to a specified chat or channel on Telegram. It supports sending videos either by referencing an existing file on Telegram servers (using a file ID), providing an HTTP URL for Telegram to fetch the video, or uploading a video directly from binary data within n8n.
This operation is useful in scenarios where automated workflows need to share video content with Telegram users or channels, such as broadcasting announcements, sharing recorded tutorials, or sending personalized video messages.
Example use cases:
- Automatically sending a welcome video to new members joining a Telegram group.
- Broadcasting promotional videos to a Telegram channel.
- Sending recorded video reports or alerts triggered by other systems.
Properties
| Name | Meaning |
|---|---|
| Chat ID | Unique identifier for the target chat or username of the target channel (in the format @channelusername). Specifies where the video will be sent. |
| Binary File | Boolean flag indicating whether the video data should be taken from a binary field in the input data. |
| Input Binary Field | The name of the binary property containing the video file data to upload. Required if "Binary File" is true. |
| Video | The video file to send when not using binary data. Can be a Telegram file ID (to reuse an existing file), or an HTTP URL for Telegram to fetch the video. |
| Reply Markup | Additional interface options for the message. Options include: Force Reply, Inline Keyboard, None, Reply Keyboard, Reply Keyboard Remove. |
| Force Reply | Configuration for forcing a reply interface to the user, optionally selective to specific users. |
| Inline Keyboard | Adds an inline keyboard next to the message, composed of rows and buttons with customizable text, callback data, URLs, payment buttons, and inline query switches. |
| Reply Keyboard | Adds a custom reply keyboard with rows of buttons that can request contact or location information. |
| Reply Keyboard Options | Options for the reply keyboard such as resizing, one-time display, and selective visibility. |
| Reply Keyboard Remove | Options to remove the custom keyboard, optionally selectively. |
| Additional Fields | Various optional parameters including: |
| - Caption: Text caption for the video (0-1024 characters). | |
| - Disable Notification: Whether to send the message silently without sound notifications. | |
| - Duration: Length of the video clip in seconds. | |
| - File Name: Name of the uploaded file (required if uploading binary data). | |
| - Height & Width: Dimensions of the video. | |
| - Parse Mode: How to parse text fields (Markdown, MarkdownV2, HTML). | |
| - Reply To Message ID: If replying to a specific message, its ID. | |
| - Message Thread ID: Identifier for forum topics. | |
| - Thumbnail: JPEG thumbnail for the video, max 200 kB, max 320x320 px. |
Output
The node outputs JSON data representing the response from the Telegram API after sending the video message. This typically includes details about the sent message such as message ID, chat info, date, and video metadata.
If the video was uploaded from binary data, the node handles the binary stream internally but does not output binary data itself; the output remains JSON describing the sent message.
Dependencies
- Requires a valid Telegram Bot API key credential configured in n8n.
- Uses Telegram Bot API endpoints to send messages and upload media.
- For binary uploads, expects the input data to contain properly formatted binary properties with file names and MIME types.
Troubleshooting
- Missing File Name Error: When uploading video from binary data, a file name must be provided either in the binary property or manually via the "File Name" additional field. Without it, the node throws an error. Solution: Ensure the binary data includes a file name or set it explicitly.
- Invalid Chat ID: If the chat ID or channel username is incorrect or inaccessible by the bot, the API call will fail. Verify the chat ID or username and bot permissions.
- Unsupported Video Format or Size: Telegram has limits on video formats and sizes. Large or unsupported videos may cause errors. Check Telegram's documentation for allowed formats and size limits.
- API Rate Limits: Sending too many messages in a short time may trigger rate limiting by Telegram. Implement delays or error handling to manage this.
- Incorrect Reply Markup Configuration: Misconfigured keyboards or reply markup options may cause API errors. Validate the structure of inline keyboards and reply keyboards carefully.