Telegram CoPilot icon

Telegram CoPilot

Your Personal Telegram CoPilot

Overview

This node, named "Telegram CoPilot," integrates with the Telegram API to perform various Telegram-related actions programmatically. 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.

Common scenarios where this node is beneficial include automating Telegram interactions such as managing chats, sending messages, or retrieving user information within workflows. For example, you could automate customer support by creating secret chats with users who request private conversations or integrate Telegram messaging into broader automation pipelines.

Properties

Name Meaning
User ID The unique identifier of the user with whom to create a new secret chat. This must be provided as a string representing the user's Telegram ID.

Output

The output of the node is a JSON array containing the result of the invoked Telegram API method. For the Create New Secret Chat operation, the output JSON will contain the details of the newly created secret chat object returned by Telegram's API.

The structure typically includes fields describing the secret chat session, such as chat identifiers and encryption parameters (depending on Telegram's API response). No binary data output is involved in this operation.

Dependencies

  • Requires an API key credential for authenticating with the Telegram API.
  • Depends on the internal connection manager to handle client sessions and authentication states.
  • Requires proper login/authentication via phone number and code before performing operations.
  • The node uses the Telegram TDLib (Telegram Database Library) under the hood for API calls.

Troubleshooting

  • Session Not Logged In: If the Telegram account session is not logged in or has expired, the node will throw errors prompting re-login. Users should follow the login instructions at https://telepilot.co/login-howto.
  • Unauthorized Errors: These indicate invalid or expired credentials; re-authentication is required.
  • Closed Client Errors: Occur if the client session was closed unexpectedly; the node suggests logging in again.
  • Invalid User ID: Providing an incorrect or non-existent user ID may cause the API call to fail.
  • Network Issues: Connectivity problems can prevent successful API invocation.

To resolve these issues:

  • Ensure the Telegram account is properly logged in using the login commands or nodes.
  • Verify that the user ID is correct and corresponds to a valid Telegram user.
  • Check network connectivity and API credentials.

Links and References

Discussion