Overview

This node operation allows managing chats in Telegram via the TelePilot API. It supports various chat-related actions such as retrieving chat history, sending messages (text, photo, video, audio, files), editing messages, deleting messages, forwarding messages, managing chat folders, joining or leaving chats, toggling chat read status, and handling chat invite links. It is useful for automating chat interactions, message management, and chat organization in Telegram.

Use Case Examples

1. Automatically send a photo message to a chat when a new event occurs.
2. Retrieve the chat history of a specific chat for analysis or backup.
3. Add or remove chats from folders to organize Telegram chats automatically.
4. Forward selected messages from one chat to another as part of a workflow.

Properties

Output

JSON

• chat_id - The ID of the chat involved in the operation.
• message_id - The ID of the message involved in message-related operations.
• messages - An array of messages returned when fetching chat history or paid posts.
• result - The result object returned from sending or editing messages.
• error - Error message if the operation failed.
• success - Boolean indicating if the operation was successful.

Dependencies

• TelePilot API credentials (apiId, apiHash, phoneNumber) are required for authentication and client initialization.

Troubleshooting

• Ensure the Telegram account is logged in before performing chat operations; otherwise, the node will throw a login error.
• If the client session is closed or unauthorized, re-login is required using the login operation.
• Errors related to chat permissions (e.g., CHAT_ADMIN_REQUIRED) indicate the user must have appropriate admin rights in the chat.
• File-related operations require valid file paths and formats; voice messages work best with .ogg format and must not exceed Telegram's size limits.
• Common error messages include 'Chat not found', 'User not found', and 'Unauthorized', which should be handled by verifying input IDs and login status.

Links

• TelePilot Login Guide - Instructions on how to log in and authenticate the Telegram account for TelePilot.