Actions30
- Chat Actions
- Custom Request Actions
- File Actions
- Group Actions
- Message Actions
- User Actions
Overview
This node integrates with Telegram via the TelePilot API, enabling automation of various Telegram messaging and chat management tasks. Specifically, the "Send Message with Video" operation allows users to send a video file as a message to a specified Telegram chat.
Common scenarios for this node include:
- Automatically sending video updates or announcements to Telegram groups or channels.
- Sharing recorded video content or tutorials directly through Telegram chats.
- Integrating video message sending into broader workflows, such as notifications triggered by external events.
For example, a user could automate sending a daily video briefing to a team chat by specifying the local path to the video file and the target chat ID.
Properties
| Name | Meaning |
|---|---|
| Chat ID | The unique identifier of the Telegram chat where the video message will be sent. |
| Message Video | The local filesystem path to the video file that will be sent in the message. |
| File Caption | An optional text caption to accompany the video message. |
| Reply to messageId | (Optional) The message ID in the chat to which this video message should reply. |
Output
The node outputs an array of JSON objects representing the response from the Telegram API after sending the video message. Each output item corresponds to the result of the invoked Telegram method and typically includes details about the sent message, such as message ID, chat information, and status.
If the operation is successful, the output JSON contains the Telegram message object confirming the video was sent. If there are errors, the output may contain error details describing what went wrong.
The node does not output binary data for this operation; it only sends a local video file specified by path.
Dependencies
- Requires an active Telegram API authentication credential (an API key and associated login).
- Depends on the TelePilot Node Connection Manager to handle Telegram client sessions and API calls.
- Access to the local filesystem path where the video file resides is necessary.
- The Telegram account used must have permission to send messages to the target chat.
Troubleshooting
- File Not Found: If the specified video file path does not exist or is inaccessible, the node will fail. Ensure the file path is correct and accessible by n8n.
- Authentication Errors: If the Telegram session is not logged in or has expired, the node will throw errors indicating the need to log in again. Use the login operations to authenticate.
- Permission Issues: Errors like "CHAT_WRITE_FORBIDDEN" indicate the bot or user does not have permission to send messages to the chat. Verify chat permissions.
- File Size Limits: Telegram imposes size limits on media files. Large videos exceeding these limits may cause failures.
- Caption Length: Very long captions might be truncated or rejected by Telegram.
- Reply to Invalid Message: Specifying a
reply_to_msg_idthat does not exist or is invalid can cause errors.
Links and References
- Telegram Bot API Documentation
- TelePilot Official Guide (for login and session management)
- Telegram Limits and Restrictions
This summary focuses on the "Send Message with Video" operation under the "Message" resource, based on the provided source code and property definitions.