Actions33
- Chat Actions
- Custom Request Actions
- File Actions
- Group Actions
- Message Actions
- User Actions
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
- TelePilot Login Guide — Instructions for authenticating your Telegram account.
- Telegram Bot API Documentation — Official Telegram API reference (general context).
- TelePilot Official Site — For more details on TelePilot features and support.