Telegram Client icon

Telegram Client

Use Telegram Client API

Actions12

Overview

This node integrates with the Telegram Client API, enabling automation of various Telegram chat operations. Specifically, the "Join Chat" operation allows the user to join a specified Telegram chat or channel programmatically. This is useful in scenarios where automated workflows need to add the bot or user to groups or channels without manual intervention.

Practical examples include:

  • Automatically joining announcement channels when a new workflow starts.
  • Adding the bot to specific group chats based on triggers.
  • Managing membership in multiple Telegram channels as part of a larger automation process.

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 action 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"
}

Dependencies

  • Requires an active Telegram Client API credential including session data and API keys.
  • Uses the Telegram Client SDK internally to connect and perform actions.
  • The node must be configured with valid Telegram API credentials (session string, API ID, and API hash).

Troubleshooting

  • No credentials provided: The node will throw an error if the required Telegram API credentials are missing. Ensure credentials are properly set up in n8n.
  • Operation not supported: If an unsupported operation name is used, an error will be thrown.
  • Connection issues: Network problems or invalid credentials can cause connection failures. Verify API keys and network access.
  • Permission errors: The Telegram account or bot may lack permission to join certain chats or channels. Confirm the account has necessary rights.
  • Error disconnecting client: Errors during client disconnection are logged but do not stop execution; these usually do not affect the main operation.

Links and References

Discussion