Telegram CoPilot

Overview

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

This node is beneficial for automating group management tasks such as onboarding new members into large Telegram groups or channels without manual intervention. For example, it can be used in scenarios where you want to automatically add users who sign up on your platform to a Telegram community or broadcast channel.

Properties

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 typically includes details about the success or failure of the operation, such as confirmation of added members or error messages if the addition failed.

No binary data output is involved in this operation.

Dependencies

• Requires an active Telegram API authentication credential (an API key and associated login).
• Depends on the TelePilot Node Connection Manager to handle Telegram client sessions.
• The node expects that the Telegram account is logged in and authorized; otherwise, it will prompt for login or throw errors.
• No additional external services are required beyond Telegram's API.

Troubleshooting

• Common Issues:

  • Attempting to add users when the Telegram session is not logged in or has expired will result in errors prompting re-login.
  • Invalid or malformed user IDs may cause the operation to fail.
  • Insufficient permissions in the target chat (e.g., not being an admin) will prevent adding members.

• Error Messages:

  • "Please login": Indicates the Telegram session is not authenticated. Resolve by performing the login process using the appropriate login node or commands.
  • "Session was closed or terminated. Please login again": The client session was closed unexpectedly; re-authentication is needed.
  • Errors related to invalid user IDs or chat IDs usually indicate incorrect input parameters.

• Resolution Tips:

  • Ensure the Telegram credential is correctly configured and logged in.
  • Verify that the chat ID corresponds to a Supergroup or Channel where you have permission to add members.
  • Confirm that user IDs are valid and separated by commas without extra spaces.
  • Use the ChatTrigger node with login commands to maintain active sessions.

Links and References

• TelePilot Login Guide — Instructions for logging in and managing Telegram sessions.
• Telegram API Documentation — Official Telegram API reference for understanding chat and user management.