Telegram CoPilotInstall

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. This is useful for managing group memberships programmatically, such as onboarding new members in bulk or automating community management tasks.

Practical examples:

• Automatically adding new users to a Telegram channel after they subscribe on a website.
• Managing membership of large groups by syncing with external user databases.
• Automating invitations to event-specific Telegram groups.

Properties

Output

The node outputs an array of JSON objects representing the response from the Telegram API for the add members request. The exact structure depends on the Telegram API response but typically includes confirmation of added members or error details if the operation failed.

No binary data output is produced by this operation.

Dependencies

• Requires a valid Telegram API authentication token configured in the node credentials.
• Depends on the TelePilot Node Connection Manager to handle Telegram client sessions.
• Requires the Telegram account to be logged in and authorized; otherwise, the node will throw errors prompting re-login.

Troubleshooting

• Common issues:

  • Attempting to add members when the Telegram session is not logged in or has expired.
  • Providing invalid or malformed chat or user IDs.
  • Insufficient permissions to add members to the specified chat (e.g., not an admin).

• Error messages and resolutions:

  • "Session was closed or terminated. Please login again": The Telegram session has expired or been closed. Re-authenticate using the login process.
  • "Please login": The node detected an unauthorized state. Perform login via the provided instructions.
  • Errors related to invalid user or chat IDs usually indicate incorrect input values; verify IDs are correct and correspond to existing Telegram entities.

Links and References

• TelePilot Login Guide — Instructions for authenticating your Telegram account.
• Telegram Bot API Documentation — General reference for Telegram API methods (note: TelePilot uses TDLib under the hood, which differs slightly).