Telegram CoPilotInstall

Overview

The node integrates with Telegram via the TelePilot API, enabling automation of various Telegram actions. Specifically, for the Chat resource and Add Chat Members operation, it allows adding multiple users to a Supergroup or Channel by specifying their 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 add new users to a Telegram Supergroup after they register on your platform.
• Manage membership of channels by syncing user lists from external databases.
• Automate moderation workflows by adding trusted users to private groups.

Properties

Output

The node outputs a JSON array containing the response from the Telegram API after attempting to add the specified users to the chat. The structure typically includes details about the updated chat or confirmation of the added members. No binary data output is involved in this operation.

Example output JSON snippet might look like:

{
  "chat_id": "123456789",
  "added_user_ids": ["111111", "222222"],
  "status": "success"
}

(Note: Actual output depends on Telegram API response format.)

Dependencies

• Requires an active Telegram API authentication credential (an API key and associated login).
• Depends on the TelePilot Node Connection Manager to handle client sessions and API calls.
• The node expects the Telegram account to be logged in and authorized; otherwise, it prompts for login.

Troubleshooting

• Common issues:

  • Attempting to add users when the Telegram session is not logged in or has expired.
  • Providing invalid or incorrectly formatted user IDs.
  • Trying to add users to chats where the bot/account lacks permission.

• Error messages and resolutions:

  • "Session was closed or terminated. Please login again": The Telegram session has ended; re-authenticate using the login flow.
  • "Please login": The node detected no active session; perform login via the provided instructions.
  • Errors related to unauthorized access indicate missing permissions or invalid credentials; verify API keys and account rights.
  • Invalid user IDs or chat IDs may cause API errors; ensure 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 and parameters.
• TelePilot Official Website — Additional resources and support for the TelePilot integration.