Telegram CoPilot icon

Telegram CoPilot

Your Personal Telegram CoPilot
Join our community

Actions26

Overview

This node, named "Telegram CoPilot," provides integration with the Telegram API to perform various user-related operations. Specifically for the User resource and the Get User operation, it retrieves detailed information about a Telegram user by their user ID.

Common scenarios where this node is beneficial include:

  • Fetching user details in Telegram bots or automation workflows.
  • Integrating Telegram user data into CRM or support systems.
  • Automating user management tasks based on Telegram user info.

Practical example:

  • You have a workflow triggered by a Telegram message and want to get full details of the sender (user) to personalize responses or log user activity.

Properties

Name Meaning
User ID The unique identifier of the Telegram user whose information you want to retrieve. Example: "122323".

Output

The output is a JSON array containing the user information object returned from the Telegram API. This object includes all available details about the specified user, such as username, first name, last name, status, profile photos, and other metadata provided by Telegram.

No binary data output is produced by this operation.

Example output structure (simplified):

[
  {
    "id": 122323,
    "first_name": "John",
    "last_name": "Doe",
    "username": "johndoe",
    "status": { /* user status info */ },
    "profile_photo": { /* photo info */ },
    ...
  }
]

Dependencies

  • Requires an active Telegram API authentication credential (an API key credential).
  • Depends on the TelePilotNodeConnectionManager service internally managing Telegram client sessions.
  • The node requires the user to be logged in via the login mechanism provided by the node (e.g., phone number login with MFA support).
  • Network access to Telegram servers is necessary.

Troubleshooting

  • Error: "Session was closed or terminated. Please login again"
    This indicates that the Telegram client session has expired or been closed. The user must re-authenticate using the login process described at https://telepilot.co/login-howto.

  • Error: "Please login"
    The node attempted an operation without an active authenticated session. Ensure the login step is completed successfully before calling user operations.

  • Unexpected authState errors
    These may occur if the login flow is interrupted or incomplete. Follow the login instructions carefully and provide required codes or passwords when prompted.

  • Invalid User ID
    If the provided User ID does not exist or is malformed, the Telegram API will return an error. Verify the User ID is correct.

Links and References

Discussion