Actions33
- Chat Actions
- Custom Request Actions
- File Actions
- Group Actions
- Message Actions
- User Actions
Overview
The node provides integration with Telegram via the TelePilot API, enabling various chat-related operations. Specifically, for the Delete Chat operation under the Chat resource, it allows users to delete a specified chat by its ID. This is useful in scenarios where you want to programmatically remove chats from a Telegram account, such as cleaning up old or irrelevant conversations automatically.
Practical examples include:
- Automatically deleting chats after processing their messages.
- Managing chat lists by removing inactive or unwanted chats.
- Integrating Telegram chat management into broader automation workflows.
Properties
| Name | Meaning |
|---|---|
| Chat ID | The unique identifier of the chat to be deleted. This is a required string input. |
Output
The output is a JSON array containing the response from the Telegram API after attempting to delete the chat. The structure typically includes confirmation details or error information related to the deletion request.
Example output JSON (simplified):
{
"_": "ok",
"chat_id": 123456789
}
If the deletion is successful, the response confirms the chat ID that was deleted. If there is an error, the output will contain error details.
The node does not output binary data for this operation.
Dependencies
- Requires an active Telegram API authentication credential (an API key and associated login).
- Depends on the TelePilotNodeConnectionManager to manage Telegram client sessions.
- The node expects the user to be logged in; otherwise, it throws an error prompting login.
- No additional external services are required beyond Telegram's API.
Troubleshooting
Common issues:
- Attempting to delete a chat without being logged in will result in an error instructing the user to log in first.
- Invalid or non-existent chat IDs may cause errors or no effect.
- Session expiration or closure requires re-authentication.
Error messages and resolutions:
"Please login: https://telepilot.co/login-howto": Indicates the Telegram session is not authenticated. Resolve by performing the login process using the appropriate login node or commands."A closed client cannot be reused, create a new Client": The Telegram client session has been closed unexpectedly. Re-login is necessary."Unauthorized": The credentials are invalid or expired. Re-authenticate.- Other Telegram API errors will be passed through; check the message for specifics and ensure the chat ID is correct and accessible.
Links and References
- TelePilot Login Guide — Instructions for logging in and managing Telegram sessions.
- Telegram API Documentation — Official Telegram API reference for deeper understanding of chat operations.