Telegram Client icon

Telegram Client

Use Telegram Client API

Overview

The node implements a Telegram client that interacts with the Telegram API to perform various messaging operations. Specifically, the "Reply To Message" operation allows users to send a reply message to an existing message in a specified chat or channel. This is useful for maintaining conversation context by directly responding to a particular message.

Common scenarios include:

  • Customer support bots replying to user queries.
  • Automated notifications that respond to specific messages.
  • Chat moderation tools that reply with warnings or information.

Example: Replying to a user's question in a group chat by referencing their original message ID and sending a contextual answer.

Properties

Name Meaning
Chat ID The identifier of the chat or channel where the reply will be sent. Can be a numeric ID or username (e.g., @username or -100xxxx).
Message Text The text content of the reply message to send.
Message ID The ID of the message being replied to.
Options Additional optional settings:
- Silent: Send the message without notification.
- Caption: Caption for media messages (not used in reply).
- Parse Mode: How to parse the message text; options are None, Markdown, or HTML.
- Limit: Maximum number of items to return (not relevant for reply).

Output

The output JSON object for the "Reply To Message" operation includes:

  • success: Boolean indicating if the reply was sent successfully.
  • messageId: The unique ID of the newly sent reply message.
  • replyToMessageId: The ID of the original message being replied to.
  • date: Timestamp of when the reply message was sent.
  • text: The text content of the reply message.

This output confirms the reply action and provides identifiers for further processing or logging.

Dependencies

  • Requires an active Telegram API client session authenticated via credentials containing:
    • A valid Telegram API ID and API hash.
    • A session string for authentication.
  • Uses the Telegram Client SDK internally to connect and interact with Telegram servers.
  • Requires network access to Telegram's API endpoints.
  • No additional environment variables beyond the provided credentials are necessary.

Troubleshooting

  • No credentials provided: The node will throw an error if the required Telegram API credentials are missing or invalid. Ensure credentials are properly configured.
  • Invalid Chat ID or Message ID: Errors may occur if the chat or message IDs do not exist or the bot/user does not have permission to access them.
  • Parse Mode errors: Using unsupported formatting in the message text with Markdown or HTML parse modes can cause message sending failures.
  • Connection issues: Network problems or Telegram API downtime can prevent successful connection or message sending.
  • Permission errors: The authenticated user must have rights to send messages and reply in the target chat/channel.

To resolve errors:

  • Verify credentials and permissions.
  • Confirm chat and message IDs are correct.
  • Use plain text or supported formatting in message text.
  • Check network connectivity.

Links and References

Discussion