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 adding multiple users to a Telegram Supergroup or Channel by specifying their user IDs and the target chat ID.

Common scenarios for this operation include:

  • Automating community management by bulk-adding members to groups or channels.
  • Onboarding new users into specific Telegram chats as part of a workflow.
  • Managing membership in Telegram groups programmatically without manual intervention.

Example use case: After collecting user IDs from an external source, you can add them all at once to a Telegram Supergroup to streamline group population.

Properties

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

Output

The output is a JSON array containing the response from the TelePilot API after attempting to add the specified users to the chat. The structure typically includes details about the success or failure of the operation, such as confirmation of added members or error information if any user could not be added.

No binary data output is produced by this operation.

Dependencies

  • Requires an active Telegram API credential configured in n8n with appropriate permissions.
  • Depends on the TelePilot Node Connection Manager to handle Telegram client sessions and API calls.
  • The node requires a valid logged-in Telegram session; otherwise, it will prompt for login or throw errors directing to the login guide.

Troubleshooting

  • Session Closed or Unauthorized Errors:
    If the node throws errors like "A closed client cannot be reused" or "Unauthorized," it means the Telegram session has expired or was terminated. The solution is to re-authenticate using the login process described at https://telepilot.co/login-howto.

  • Invalid Chat ID or User IDs:
    Ensure that the Chat ID corresponds to a valid Supergroup or Channel and that the User IDs are correct Telegram user identifiers. Incorrect values may cause the API call to fail.

  • Permission Issues:
    Adding members to some types of chats may require admin privileges. Make sure the authenticated Telegram account has sufficient rights to add members to the target chat.

  • Rate Limits or API Restrictions:
    Telegram may impose limits on how many users can be added in a short time. If you encounter rate limit errors, consider batching additions or adding delays between requests.

Links and References

Discussion