Telegram Client icon

Telegram Client

Use Telegram Client API

Actions12

Overview

The "Join Chat" operation of this Telegram Client node allows a user to join a specified Telegram chat or channel by providing its ID or username. This is useful in automation workflows where you want the bot or client to programmatically become a member of a group or channel, enabling subsequent interactions such as sending messages, retrieving members, or monitoring content.

Practical examples include:

  • Automatically joining a promotional channel to monitor updates.
  • Joining a group chat before posting announcements.
  • Enabling a workflow to join multiple chats dynamically based on input data.

Properties

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

Output

The output JSON object for the "Join Chat" operation contains:

  • success: Boolean indicating if the join operation was successful (true).
  • joined: Boolean confirming that the chat was joined (true).
  • chatId: The chat ID or username that was joined.

Example output:

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

No binary data is produced by this operation.

Dependencies

  • Requires valid Telegram API credentials including an API ID, API hash, and a session string.
  • The node uses the Telegram Client API via a third-party SDK bundled with the node.
  • Network connectivity to Telegram servers is necessary.
  • Proper permissions for the account/session used to join chats.

Troubleshooting

  • Common issues:

    • Invalid or missing chat ID/username will cause failure to join.
    • Insufficient permissions or restrictions on the Telegram account may prevent joining certain channels or groups.
    • Network or authentication errors if credentials are incorrect or expired.

  • Error messages:

    • "No credentials provided": Ensure that the required Telegram API credentials are configured in n8n.
    • "Operation "joinChat" is not supported": Indicates a misconfiguration; verify the selected operation.
    • Authentication failures: Check that the API ID, API hash, and session are valid and active.
    • Telegram API errors related to chat access: Confirm the chat ID is correct and accessible by the authenticated user.

To resolve errors, verify all inputs, credentials, and network connectivity. Use the node's "Continue On Fail" option to handle errors gracefully in workflows.

Links and References

Discussion