Telegram CoPilot icon

Telegram CoPilot

Your Personal Telegram CoPilot

Actions27

Overview

This node integrates with Telegram via the TelePilot API, enabling automation of various Telegram actions. Specifically, the Add Chat Members operation allows users to add multiple members to a Telegram Supergroup or Channel by specifying the chat and user IDs.

Common scenarios for this node include:

  • Automating community management by bulk-adding users to groups or channels.
  • Integrating Telegram group membership changes into workflows triggered by external events.
  • Managing Telegram chats programmatically without manual intervention.

For example, you could use this node to automatically add new customers or subscribers to a Telegram channel after they sign up on your platform.

Properties

Name Meaning
Chat ID The unique identifier of the Telegram chat (Supergroup or Channel) where members will be added. Example: 122323
User IDs Comma-separated list of user IDs to add to the specified chat. Example: 122323,2322222

Output

The node outputs an array of JSON objects representing the response from the Telegram API for the add members request. This typically includes details about the success or failure of adding each user to the chat.

No binary data output is produced by this operation.

Dependencies

  • Requires a valid Telegram API authentication credential (an API key/token) configured in n8n.
  • Depends on the TelePilot Node Connection Manager to handle Telegram client sessions and API calls.
  • Internet connectivity to reach Telegram servers.

Troubleshooting

  • Session Not Logged In / Unauthorized Errors:
    If the node throws errors indicating the session is closed or unauthorized, it means the Telegram account is not logged in or the session expired.
    Resolution: Re-authenticate using the login flow provided by the node (e.g., via the /start command in the ChatTrigger node). Refer to https://telepilot.co/login-howto for detailed instructions.

  • Invalid Chat ID or User IDs:
    Providing incorrect or malformed chat or user IDs may cause the operation to fail.
    Resolution: Verify that the chat ID corresponds to a valid Supergroup or Channel and that user IDs are correct and comma-separated without extra spaces.

  • API Rate Limits or Permissions:
    Adding many users at once or lacking permissions to add members to a chat can cause failures.
    Resolution: Ensure the authenticated Telegram account has admin rights in the target chat and consider adding users in smaller batches.

Links and References

Discussion