Actions24
- Chat Actions
- Callback Actions
- File Actions
- Message Actions
Overview
This node operation sends an animation file to a specified Telegram chat. It supports sending animations either by referencing an existing file on Telegram servers, providing an HTTP URL, or uploading a binary file directly. The node allows customization of the message with captions, reply markup options (such as inline keyboards or reply keyboards), and other advanced Telegram API options. It is useful for automating the sending of animated content in Telegram chats, such as promotional GIFs, animated instructions, or fun animations in group chats or channels.
Use Case Examples
- Sending a GIF animation to a Telegram group chat by specifying the chat ID and animation file ID.
- Uploading and sending a custom animation stored in binary data from a previous node.
- Adding an inline keyboard to the animation message for interactive user responses.
Properties
| Name | Meaning |
|---|---|
| Chat ID | Unique identifier for the target Telegram chat or username of the target channel. |
| Binary File | Indicates whether the animation file to send should be taken from a binary field input. |
| Input Binary Field | The name of the binary property containing the animation file data to upload, used if Binary File is true. |
| Animation | The animation file to send, specified as a Telegram file ID or an HTTP URL, used if Binary File is false. |
| Reply Markup | Additional interface options for the message, such as inline keyboard, force reply, or custom reply keyboards. |
| Force Reply | Options to configure force reply behavior, including selective reply targeting. |
| Inline Keyboard | Defines rows and buttons for an inline keyboard attached to the message, supporting callback data, URLs, and other button types. |
| Reply Keyboard | Defines rows and buttons for a custom reply keyboard with options like request contact or location. |
| Reply Keyboard Options | Options to resize, hide after use, or selectively show the reply keyboard. |
| Reply Keyboard Remove | Options to remove the custom keyboard and selectively target users. |
| Additional Fields | Additional optional parameters such as caption, disable notification, parse mode, duration, thumbnail, width, height, and custom JSON fields for advanced Telegram API options. |
Output
JSON
animationfile_id- The file ID of the sent animation on Telegram servers.file_unique_id- Unique identifier for the animation file.width- Width of the animation.height- Height of the animation.duration- Duration of the animation in seconds.
caption- Caption text of the animation message.chatid- Unique identifier of the chat where the animation was sent.
message_id- Unique identifier of the sent message.
Dependencies
- Telegram API
- An API key credential for Telegram Bot API
Troubleshooting
- Ensure the chat ID is correct and the bot has permission to send messages to the chat.
- If sending binary data, ensure the binary property contains valid file data and a file name is provided either in the binary metadata or the node's File Name parameter.
- Check that the animation file format is supported by Telegram (e.g., GIF or MP4).
- If using a file ID or URL, verify that the file exists and is accessible.
- Common error messages include invalid chat ID, file not found, or insufficient permissions. Verify credentials and chat permissions to resolve these.
Links
- Telegram Bot API - sendAnimation - Official Telegram API documentation for sending animation messages.