Telegram CoPilot icon

Telegram CoPilot

Your Personal Telegram CoPilot
Join our community

Actions33

Overview

This node enables sending a video message to a Telegram chat using a local video file. It is part of a broader Telegram integration that supports various messaging and chat operations. The "Send Message with Video" operation specifically allows users to send videos with optional captions, thumbnails, and streaming support.

Common scenarios where this node is beneficial include:

  • Automating the distribution of video content to Telegram groups or channels.
  • Sending personalized video messages in customer support or marketing workflows.
  • Broadcasting announcements or tutorials via video directly through Telegram.

Example: Automatically send a recorded product demo video to a Telegram channel whenever a new product is launched.

Properties

Name Meaning
Chat ID The unique identifier of the Telegram chat where the video will be sent.
Message Video Local filesystem path to the video file to be sent (e.g., /tmp/my-video.mp4).
File Caption Optional text caption to accompany the video message.
Reply to threadID If set (non-zero), specifies the message thread ID within the chat to send the video as a reply.
Duration Of The Video, In Seconds Length of the video in seconds (optional).
Video Width Width of the video in pixels (optional).
Video Height Height of the video in pixels (optional).
On, If The Video Is Supposed To Be Streamed Boolean flag indicating if the video supports streaming (default true).
Thumbnail Width Width of the thumbnail image in pixels (optional).
Thumbnail Height Height of the thumbnail image in pixels (optional).
JPEG Thumbnail Of The Video (Local File Path) Local path to a JPEG thumbnail image for the video (optional).
Reply to messageId Identifier of a specific message to reply to within the chat (optional).

Output

The node outputs an array of JSON objects representing the response from the Telegram API after sending the video message. This typically includes metadata about the sent message such as message ID, chat details, timestamps, and status.

If the operation succeeds, the output JSON contains the full Telegram message object corresponding to the sent video message.

No binary data output is produced by this operation; it only sends video files from local paths.

Dependencies

  • Requires a valid Telegram API authentication credential (an API key and associated login).
  • Access to the local filesystem to read the specified video file and optional thumbnail image.
  • The Telegram client session must be logged in and active; otherwise, the node will throw errors prompting re-login.
  • The node uses an internal Telegram client manager to handle API calls.

Troubleshooting

  • File Not Found: Ensure the video file path and thumbnail path exist and are accessible by n8n.
  • Unauthorized / Session Closed: If the Telegram session is not logged in or has expired, the node will error out. Re-authenticate using the login flow.
  • Video Size Limits: Large video files may be rejected by Telegram. Check Telegram's file size limits.
  • Invalid Chat ID: Verify the chat ID is correct and the bot/user has permission to send messages there.
  • Streaming Flag Issues: If the video does not support streaming but the flag is set, playback issues may occur on the recipient side.
  • Caption Length: Very long captions might be truncated or rejected by Telegram.

Common error messages:

  • "Please login": Indicates the Telegram session is not authenticated.
  • "File not found at path": The specified video or thumbnail file does not exist.
  • "Cannot send messages to this chat": Permission issue or invalid chat ID.
  • "File reference has expired": Temporary file references used by Telegram have expired; retry sending.

Links and References

This summary focuses exclusively on the "Message" resource and "Send Message with Video" operation as requested.

Discussion