Telegram Client icon

Telegram Client

Use Telegram Client API

Overview

This node integrates with the Telegram Client API to perform various chat-related operations. Specifically, the "Join Chat" operation allows the user to join a Telegram chat or channel by providing its identifier. This is useful in automation workflows where joining a chat programmatically is required, such as subscribing to channels for monitoring messages or participating in group discussions automatically.

Practical example: Automatically joining a Telegram channel when a new user signs up on a platform, enabling them to receive updates and announcements without manual intervention.

Properties

Name Meaning
Chat ID The unique identifier or username of the chat or channel to join (e.g., @username or -100xxxx).

Output

The output JSON object after executing the "Join Chat" operation contains:

  • success: A boolean indicating if the join operation was successful (true).
  • joined: A boolean confirming that the chat was joined (true).
  • chatId: The identifier of the chat or channel that was joined.

Example output:

{
  "success": true,
  "joined": true,
  "chatId": "@examplechannel"
}

Dependencies

  • Requires an active Telegram Client API credential with valid session, API ID, and API hash.
  • The node uses the Telegram Client SDK internally to connect and perform actions.
  • Network connectivity to Telegram servers is necessary.
  • No additional environment variables are explicitly required beyond the API credentials.

Troubleshooting

  • No credentials provided: The node will throw an error if the Telegram API credentials are missing or invalid. Ensure that the API key, session, and other authentication details are correctly configured.
  • Connection issues: If the node cannot connect to Telegram, verify network access and that the credentials have not expired or been revoked.
  • Invalid Chat ID: Providing an incorrect or inaccessible chat/channel ID will cause the join operation to fail. Double-check the chat identifier format and permissions.
  • Operation not supported: Using an unsupported operation value will result in an error. Confirm that "joinChat" is selected for this action.

Links and References

Discussion