Telegram CoPilot icon

Telegram CoPilot

Your Personal Telegram CoPilot

Actions27

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 account and another user.

Practical examples include:

  • Automatically starting a secret chat with a user after certain triggers or events.
  • Setting up private communication channels without manual intervention.
  • Integrating Telegram secret chats into broader workflows such as customer support or notifications.

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, including its identifiers and metadata as 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) configured in n8n.
  • Depends on the TelePilot Node Connection Manager to handle Telegram client sessions and API calls.
  • The node expects the Telegram account to be logged in; otherwise, it will throw errors prompting login.
  • Internet connectivity to reach Telegram servers.

Troubleshooting

  • Common issues:

    • Attempting to create a secret chat without being logged in will cause errors. Ensure the Telegram account is authenticated using the login operations before invoking this action.
    • Invalid or missing User ID parameter will cause the operation to fail.
    • Session expiration or closure may require re-login.

  • Error messages:

    • "Session was closed or terminated. Please login again: https://telepilot.co/login-howto"
      Indicates that the Telegram client session has been closed. Resolve by performing the login procedure again.
    • "Please login: https://telepilot.co/login-howto"
      Indicates unauthorized access due to missing or expired credentials. Re-authenticate your Telegram account.
    • Errors related to invalid user IDs or network issues will propagate from the Telegram API and should be checked accordingly.

Links and References

Discussion