Actions33
- Chat Actions
- Custom Request Actions
- File Actions
- Group Actions
- Message Actions
- User Actions
Overview
This node enables interaction with Telegram through the TelePilot API, acting as a personal Telegram assistant within n8n workflows. It supports various Telegram resources and operations, including user management, contacts, chats, messages, files, and groups.
Specifically, for the Chat resource with the Create SuperGroup or Channel operation, the node allows creating a new supergroup chat or channel on Telegram. This is useful for automating the creation of group discussions or broadcast channels directly from your workflow, such as setting up community groups, team channels, or announcement channels programmatically.
Example use cases:
- Automatically create a new Telegram supergroup for a project team when a new project is initiated.
- Create a broadcast channel to send updates to subscribers based on external triggers.
- Set up discussion groups dynamically in response to customer interactions or events.
Properties
| Name | Meaning |
|---|---|
| Title | The title of the new supergroup or channel to be created. |
| Description | A description for the chat or channel, limited to 0-255 characters. |
| Is Channel? | Boolean flag indicating whether to create a channel (true) or a supergroup (false). |
Output
The node outputs an array of JSON objects representing the result of the invoked Telegram API call. For the "Create SuperGroup or Channel" operation, the output JSON contains details about the newly created chat or channel, such as its unique identifiers and metadata returned by Telegram.
No binary data output is associated with this operation.
Dependencies
- Requires an active Telegram API authentication credential (an API key credential) configured in n8n.
- Depends on the TelePilot Node Connection Manager internally to manage Telegram client sessions.
- Requires network access to Telegram's API endpoints.
- Users must be logged in via the login process supported by the node (e.g., phone number login with MFA if enabled).
Troubleshooting
- Not logged in error: If the node throws errors related to unauthorized access or closed client sessions, ensure that you have completed the login process using the appropriate login operation before attempting to create chats.
- API errors: Errors from Telegram API calls may include permission issues (e.g., insufficient rights to create channels), invalid parameters, or rate limits. Review the error message and verify input parameters.
- Description length: Ensure the description does not exceed 255 characters to avoid validation errors.
- Network issues: Connectivity problems can cause failures; verify network access to Telegram servers.
- Continue on Fail: Use the node’s "Continue On Fail" option to handle errors gracefully in workflows.
Links and References
- TelePilot Documentation — Guide for login and usage instructions.
- Telegram Bots API — Official Telegram API reference (general context).
- Telegram Channels and Groups — Explanation of Telegram supergroups and channels.