Overview

This node operation interacts with Telegram chats, allowing users to perform various chat-related actions such as retrieving chat history, sending messages (text, photo, video, audio, file), managing chat folders, editing chat details, joining or leaving chats, and handling chat members. It is useful for automating Telegram chat management and messaging workflows within n8n.

Use Case Examples

1. Retrieve chat history for a specific chat ID to analyze conversation flow.
2. Send a photo message to a chat with an optional caption and self-destruct timer.
3. Add or remove chats from folders to organize chat lists automatically.
4. Edit chat folder properties like title, icon, and color to maintain chat organization.

Properties

Output

JSON

• chat_id - The ID of the chat involved in the operation.
• messages - List of messages retrieved from the chat history or related chat operations.
• result - Result object from sending messages or performing chat actions.
• error - Error message if the operation failed.
• success - Boolean indicating if the operation was successful.

Dependencies

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

Troubleshooting

• Ensure the Telegram account is logged in before performing chat operations; otherwise, the node will throw a login error.
• Check that the chat ID provided is valid and that the user has the necessary permissions for actions like getting invite link info or adding members.
• File paths for sending media must exist and be accessible; otherwise, file-related errors will occur.
• If the Telegram session is closed or unauthorized, re-login is required as indicated by error messages referencing session closure or unauthorized access.

Links

• TelePilot Login Guide - Instructions for logging into Telegram via TelePilot node.