Telegram CoPilotInstall

Overview

The "Join Chat" operation in the Telegram CoPilot node allows a user to join a specified Telegram chat by its unique chat ID. This is useful when automating interactions with Telegram groups or channels where the bot or user needs to become a member before performing further actions such as sending messages, retrieving chat history, or managing members.

Practical scenarios include:

• Automatically joining a group or channel to monitor messages or participate.
• Integrating Telegram chats into workflows that require membership for access.
• Preparing the environment for subsequent operations like sending messages or managing chat content.

Properties

Output

The node outputs a JSON array containing the response from the Telegram API after attempting to join the chat. The structure typically includes details about the chat joined, such as chat metadata and status. The exact fields depend on Telegram's API response but generally confirm successful joining or provide error information.

No binary data output is involved in this operation.

Dependencies

• Requires an active Telegram API authentication credential (an API key credential) configured in n8n.
• Depends on the TelePilotNodeConnectionManager to manage Telegram client sessions.
• The Telegram account must be logged in and authorized; otherwise, the node will throw errors prompting login.

Troubleshooting

• Common Issues:

  • Attempting to join a chat without proper authorization or an active session will fail.
  • Providing an invalid or non-existent chat ID will result in an error.
  • Session expiration or closure requires re-login via the login flow.

• Error Messages:

  • "Session was closed or terminated. Please login again: https://telepilot.co/login-howto"
    Indicates the Telegram session is no longer valid; re-authentication is needed.
  • "Please login: https://telepilot.co/login-howto"
    Means the node cannot perform the action because the Telegram account is not logged in.
  • Errors related to invalid chat IDs or permissions will come directly from Telegram's API responses.

To resolve these issues, ensure the Telegram credentials are correctly set up, the session is active, and the chat ID is valid.

Links and References

• Telegram CoPilot Login Guide — Instructions for logging in and managing Telegram sessions.
• Telegram API Documentation — Official Telegram API reference for understanding chat-related methods.