Telegram

Sends data to Telegram

Overview

This node sends messages and performs various message-related operations on Telegram. It supports sending text messages, animations, audio, documents, locations, media groups, photos, stickers, and videos to a specified chat. It also allows editing, deleting, pinning, and unpinning messages, as well as sending chat actions and answering callback queries. The node can optionally wait for a user response after sending a message. This is useful for automating Telegram interactions such as sending notifications, media, or interactive messages with inline keyboards or reply options.

Use Case Examples

  1. Send a text message to a Telegram chat to notify users about an event.
  2. Send a photo or video to a Telegram group with a caption and inline keyboard for user interaction.
  3. Edit a previously sent message to update its content.
  4. Send a message and wait for a user's response to continue a workflow based on user input.

Properties

Name Meaning
Chat ID Unique identifier for the target chat or username of the target channel. Required to specify where the message or action is targeted.
Text The text content of the message to be sent. Required for sending text messages.
Reply Markup Additional interface options for the message, such as inline keyboards, force reply, or custom reply keyboards.
Force Reply Options to configure the force reply interface, including whether to show it and whether to restrict it to specific users.
Inline Keyboard Defines rows and buttons for an inline keyboard attached to the message, including button text and optional callback data, URLs, or web app links.
Reply Keyboard Defines rows and buttons for a custom reply keyboard, including options to request contact or location and launch web apps.
Reply Keyboard Options Options to resize the keyboard, make it one-time, or show it selectively to specific users.
Reply Keyboard Remove Options to remove the custom keyboard and whether to force reply from specific users only.
Additional Fields Various optional fields to customize the message, such as caption, disable notification, parse mode, reply to message ID, message thread ID, and custom JSON fields for advanced Telegram API options.
Wait for Response Whether to wait for a response from the user after sending the message.
Timeout Timeout in seconds to wait for a user response if 'Wait for Response' is enabled.

Output

Binary

Binary output contains downloaded files from Telegram when retrieving files with download enabled.

JSON

  • json - The JSON response from the Telegram API for the performed operation.
  • binary
    • data - Binary data of downloaded files when file download is enabled.

Dependencies

  • Telegram API with an API key credential

Troubleshooting

  • Ensure the Chat ID is correct; use @get_id_bot on Telegram to find it.
  • When uploading files from binary data, ensure the binary property contains a valid file name; otherwise, the operation will fail.
  • If waiting for a response, set an appropriate timeout to avoid indefinite waiting.
  • Check that the Telegram API credentials are correctly configured and have the necessary permissions.

Links

Discussion