Telegram CoPilot icon

Telegram CoPilot

袙邪褕 锌械褉褋芯薪邪谢褜薪褘泄 Telegram CoPilot

Actions56

效邪褌 → 袛芯斜邪胁懈褌褜 褍褔邪褋褌薪懈泻芯胁 胁 褔邪褌

AI-generated

Overview

This node interacts with Telegram chats to perform various chat-related operations such as retrieving chat history, sending messages (text, photo, video, audio, file), managing chat members, editing chat folders, handling chat invite links, and more. It is useful for automating Telegram chat management and messaging tasks within workflows, for example, sending automated messages to a chat, retrieving chat history for analysis, or managing chat members programmatically.

Use Case Examples

  1. Automatically send a text message to a Telegram chat when a specific event occurs.
  2. Retrieve the chat history of a Telegram group for logging or analysis.
  3. Add multiple users to a Telegram supergroup or channel automatically.
  4. Edit chat folder properties such as title, icon, and color via automation.

Properties

Name Meaning
Chat ID The unique identifier of the Telegram chat to operate on. Required for most chat-related operations.
User IDs Comma-separated list of user IDs to be added to a Supergroup or Channel. Used specifically for the addChatMembers operation.

Output

JSON

  • chat_id - The ID of the chat involved in the operation.
  • message_ids - IDs of messages involved in operations like delete or forward.
  • result - Result object returned from Telegram API for the performed operation.
  • success - Indicates if the operation was successful.
  • error - Error message if the operation failed.
  • new_transaction - Details of a new star transaction detected in trigger operations.
  • timestamp - Timestamp of the operation or event.

Dependencies

  • Telegram API accessed via TelePilot API credentials including apiId, apiHash, and phoneNumber for authentication.

Troubleshooting

  • Ensure the Telegram account is logged in properly; otherwise, the node will throw login-related errors and suggest using the loginWithPhoneNumber action.
  • Common errors include 'Client is not initialized' if the Telegram client session is not established, and 'Unauthorized' if credentials are invalid or session expired.
  • Errors related to chat permissions such as 'CHAT_ADMIN_REQUIRED' indicate the user must have admin rights to perform certain actions.
  • File-related errors when sending media (e.g., audio or video) may occur if the file path is invalid or the file size exceeds Telegram limits.
  • Use the continueOnFail option to handle errors gracefully in workflows.

Links

Discussion