Telegram CoPilot icon

Telegram CoPilot

Your Personal Telegram CoPilot

Overview

This node integrates with Telegram via the TelePilot API, enabling automation of various Telegram user-related actions. Specifically for the User resource and the Create New Secret Chat operation, it allows creating a new secret chat with a specified user by their user ID. This is useful in scenarios where you want to programmatically initiate secure, encrypted conversations between your Telegram bot or account and another user.

Practical examples include:

  • Automatically starting a secret chat with a user after they perform a certain action.
  • Setting up private, encrypted communication channels for sensitive information exchange.
  • Integrating Telegram secret chats into broader workflows that require confidentiality.

Properties

Name Meaning
User ID The unique identifier of the Telegram user with whom to create the new secret chat.

Output

The node outputs an array of JSON objects representing the result of the invoked Telegram API call. For the Create New Secret Chat operation, the output JSON contains details about the newly created secret chat, such as its identifiers and metadata returned by the Telegram API.

No binary data output is produced by this operation.

Dependencies

  • Requires an active Telegram API authentication credential (an API key credential with necessary permissions).
  • Depends on the TelePilot Node Connection Manager to handle client sessions and API calls.
  • The node expects the Telegram account to be logged in; otherwise, it will throw errors prompting login.
  • No additional external services are required beyond Telegram's API.

Troubleshooting

  • Error: "Please login" — Indicates the Telegram session is not authenticated. Resolve by using the login flow provided by the node’s login operations or following the guide at https://telepilot.co/login-howto.
  • Session closed or terminated — The node detects a closed client session and requires re-login.
  • Unauthorized errors — Usually caused by invalid or expired credentials; re-authenticate your Telegram API credentials.
  • If the node fails silently or returns unexpected results, ensure the User ID is valid and corresponds to an existing Telegram user.
  • Network issues or Telegram API rate limits may cause temporary failures; retrying after some time can help.

Links and References

Discussion