Skip to main content

Join Chat

Joins a Telegram chat or channel.

Common Properties​

  • Name - The custom name of the node.
  • Color - The custom color of the node.
  • Delay Before (sec) - Waits in seconds before executing the node.
  • Delay After (sec) - Waits in seconds after executing node.
  • Continue On Error - Automation will continue regardless of any error. The default value is false.
info

If the ContinueOnError property is true, no error is caught when the project is executed, even if a Catch node is used.

Inputs​

  • Client Id - The unique identifier of the Telegram client to use for this operation.
  • Chat - The chat or channel to join (can be a username, chat ID, or other chat identifier).
  • Chat Hash - Optional hash for joining private chats (from invitation links like https://t.me/joinchat/hash).

How It Works​

The Join Chat node joins a Telegram chat or channel. When executed, the node:

  1. Validates the provided inputs (Client Id and Chat)
  2. Retrieves the chat or channel entity using the Telegram client
  3. If a Chat Hash is provided, uses it to join a private chat via invitation link
  4. If no Chat Hash is provided, joins the channel directly
  5. Uses the Telegram client to execute the join operation

Requirements​

  • A valid Telegram client session with appropriate permissions
  • Valid Chat identifier
  • Valid Chat Hash (if joining a private chat)
  • Client Id must match an existing Telegram client session

Error Handling​

The node will return specific errors in the following cases:

  • Empty or invalid Client Id
  • Empty or invalid Chat identifier

Usage Notes​

  • The Chat parameter can accept various identifiers such as usernames, chat IDs, or other chat references
  • For private chats, provide the hash from the invitation link (the part after https://t.me/joinchat/)
  • For public channels, the Chat parameter alone is sufficient
  • The Client Id must correspond to an active Telegram client session