Telegram CoPilot icon

Telegram CoPilot

Your Personal Telegram CoPilot

Overview

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

Common scenarios for this node include:

  • Managing group memberships automatically based on external triggers.
  • Adding users to channels or supergroups as part of onboarding workflows.
  • Automating community management tasks in Telegram.

For example, you could use this node to add new subscribers from a CRM system into a Telegram channel automatically.

Properties

Name Meaning
Chat ID The unique identifier of the target 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 output is a JSON array containing the response from the Telegram API after attempting to add the specified users to the chat. The structure depends on the Telegram API's response but typically includes information about the success or failure of adding each member.

No binary data output is produced by this operation.

Dependencies

  • Requires an active Telegram API authentication credential (an API key/token).
  • Depends on the TelePilot Node Connection Manager to handle client sessions and API calls.
  • The node expects that the Telegram account is logged in and authorized; otherwise, it will throw login-related errors.

Troubleshooting

  • Error: "Please login"
    This indicates the Telegram session is not authenticated. Use the login flow with phone number and code via the ChatTrigger node before using this operation.

  • Error: "Session was closed or terminated"
    The client session has expired or been closed. Re-login is required.

  • Invalid Chat ID or User IDs
    Ensure the chat ID corresponds to a valid Supergroup or Channel and that user IDs are correct and comma-separated without extra spaces.

  • Permission Issues
    If the bot/account does not have permission to add members to the chat, the API call will fail. Verify permissions in Telegram.

  • Rate Limits or API Restrictions
    Adding many users at once may hit Telegram limits. Consider batching additions if errors occur.

Links and References

Discussion