Telegram CoPilot icon

Telegram CoPilot

Your Personal Telegram CoPilot

Overview

The node "Telegram CoPilot" integrates with the Telegram API to perform various Telegram-related actions programmatically. Specifically, for the Chat resource and Send Chat Action operation, it allows sending chat action notifications to a specified chat. These chat actions represent user activities such as typing, recording a voice note, uploading media, or canceling an ongoing action.

This node is beneficial in scenarios where you want to simulate or indicate user activity within a Telegram chat before sending messages or media, enhancing interactivity and user experience. For example, a bot can show "typing..." status while preparing a response or indicate that a photo is being uploaded.

Properties

Name Meaning
Chat ID The unique identifier of the Telegram chat where the chat action will be sent.
Action The type of chat action to send. Options include:
- Cancel
- Recording voice note
- Typing
- Uploading document
- Uploading photo
- Uploading video
- Uploading voice note

Output

The node outputs a JSON array containing the result of the invoked Telegram API method sendChatAction. The structure typically includes confirmation or status information about the sent chat action. The exact fields depend on Telegram's API response but generally confirm that the action was successfully registered.

No binary data output is produced by this operation.

Dependencies

  • Requires an active Telegram API authentication credential (an API key and associated login).
  • Depends on the internal connection manager to handle Telegram client sessions.
  • The node expects the Telegram account to be logged in and authorized; otherwise, it throws errors prompting re-login.
  • No additional external services beyond Telegram API are required.

Troubleshooting

  • Common Issues:

    • Attempting to send a chat action without a valid logged-in Telegram session will cause errors.
    • Invalid or missing Chat ID or Action parameters will prevent the operation from executing.
    • Network issues or Telegram API rate limits may cause temporary failures.
  • Error Messages:

    • "Please login: https://telepilot.co/login-howto": Indicates the Telegram session is not authenticated. Resolve by performing the login process using the node's login operations.
    • "Session was closed or terminated. Please login again: https://telepilot.co/login-howto": The current session has been closed; re-authentication is required.
    • "Unauthorized": Credentials are invalid or expired; re-login is necessary.

Links and References

Discussion