Telegram Client icon

Telegram Client

Use Telegram Client API
Join our community

Actions12

Overview

The node implements a Telegram client that allows sending media messages to Telegram chats or channels. Specifically, the Send Media Message operation enables users to send various types of media files such as photos, videos, audio, voice notes, and documents to a specified chat or channel.

This node is beneficial in scenarios where automated workflows need to share multimedia content on Telegram, for example:

  • Sending promotional images or videos to a marketing channel.
  • Sharing audio recordings or voice notes with a group.
  • Distributing documents or reports automatically to team chats.

Practical example: Automatically sending a daily photo update from a security camera feed to a Telegram group.

Properties

Name Meaning
Chat ID The target chat or channel identifier (e.g., @username or -100xxxx) where the media will be sent.
File Path Or URL The local path or remote URL of the media file to send.
Media Type The type of media being sent. Options: Photo, Video, Audio, Voice, Document.
Options Additional optional settings:
• Silent: Send message without notification (true/false).
• Caption: Text caption for the media.
• Parse Mode: How to parse the caption text; options are None, Markdown, HTML.
• Limit: Maximum number of items to return (not relevant for sending media but part of options collection).

Output

The output JSON object for the Send Media Message operation includes:

  • success: Boolean indicating if the message was sent successfully.
  • messageId: The unique identifier of the sent message.
  • date: The timestamp when the message was sent.
  • mediaType: The type of media sent (photo, video, audio, voice, document).

If the operation fails, the output will contain an error message describing the failure.

Dependencies

  • Requires a valid Telegram API authentication credential including session string, API ID, and API hash.
  • Uses the Telegram Client SDK internally to connect and interact with the Telegram API.
  • Requires network connectivity to Telegram servers.
  • No additional environment variables beyond the required Telegram API credentials.

Troubleshooting

  • No credentials provided: The node will throw an error if the Telegram API credentials are missing or invalid. Ensure you have configured the necessary API authentication details.
  • File not found or inaccessible: If the file path or URL is incorrect or unreachable, sending the media will fail. Verify the file location and permissions.
  • Unsupported media type: Only the specified media types (photo, video, audio, voice, document) are supported. Using other types may cause errors.
  • Telegram API errors: Errors returned by Telegram (e.g., chat not found, permission denied) will be surfaced. Check the chat ID and your bot/user permissions.
  • Connection issues: Network problems or Telegram server downtime can cause connection failures. Retry later or check network status.
  • When continueOnFail is enabled, the node will continue processing subsequent items even if one fails, returning error details in the output.

Links and References

Discussion