Overview

This node interacts with Telegram chats to perform various chat-related operations such as retrieving chat history, sending messages (text, photo, video, audio, files), managing chat members, editing messages, deleting messages, forwarding messages, toggling chat unread status, joining/opening/closing chats, managing chat folders, handling chat invite links, and accessing chat revenue transactions and active stories. It is useful for automating Telegram chat management and messaging workflows within n8n.

Use Case Examples

1. Automatically send a message to a Telegram chat when a specific event occurs.
2. Retrieve the chat history of a Telegram chat for analysis or backup.
3. Add or remove members from a Telegram chat automatically based on external triggers.
4. Forward messages from one chat to another as part of a workflow.

Properties

Output

JSON

• new_transaction - Details of a new star transaction detected in the chat (for trigger operations).
• timestamp - Timestamp of the new transaction or event.
• owner_id - Owner ID related to star revenue status updates.
• status - Status of star revenue or transactions.
• chat_id - The chat ID involved in the operation.
• message_id - The message ID involved in message-specific operations.
• result - Result of the invoked Telegram API operation, varies by operation type.
• success - Indicates success status for operations like sending media messages.
• error - Error message if the operation failed.
• errorDetails - Detailed error information for troubleshooting.

Dependencies

• Requires Telegram API credentials including apiId, apiHash, and phoneNumber for authentication.

Troubleshooting

• Common errors include client session issues such as 'A closed client cannot be reused' or 'Unauthorized' which require re-login.
• Errors related to permissions like 'CHAT_ADMIN_REQUIRED' when accessing invite link info or members.
• File-related errors such as missing files or exceeding Telegram's size limits for media messages.
• Handling of MFA (multi-factor authentication) during login with phone number.
• Ensure correct chat IDs and message IDs are used to avoid 'Chat not found' or 'User not found' errors.

Links

• TelePilot Login Guide - Instructions for logging in and managing Telegram sessions with TelePilot.