Telegram CoPilot icon

Telegram CoPilot

Your Personal Telegram CoPilot

Overview

The Telegram CoPilot node for n8n allows you to interact with the Telegram API, automating various user, chat, group, and message operations.
For the User resource and the Get User Full Info operation, this node retrieves comprehensive information about a specific Telegram user by their User ID.

Common scenarios:

  • Enriching contact data in your workflows by fetching detailed Telegram user profiles.
  • Automating user management or monitoring activities based on Telegram user information.
  • Integrating Telegram user data into CRM or support systems.

Example use case:
You have a list of Telegram User IDs and want to fetch full profile details for each, then store or process that information further in your workflow.


Properties

Display Name Type Description
User ID String ID of the user whose full info you want to retrieve. This is required. Example: "122323"

Output

The output will be a JSON object containing the full information about the specified Telegram user. The structure depends on the Telegram API's getUserFullInfo response, but typically includes fields such as:

{
  "id": 123456789,
  "bio": "User bio text",
  "is_blocked": false,
  "can_be_called": true,
  "has_private_calls": false,
  "user_photo": {
    // ...photo details...
  },
  "public_forwards": true,
  "bot_info": null,
  // ...other fields depending on Telegram API...
}
  • All fields are directly returned from Telegram's getUserFullInfo method.
  • No binary data is produced by this operation.

Dependencies

  • External Service: Requires access to the Telegram API via the TelePilot integration.
  • Credentials: You must configure the telePilotApi credential in n8n, which includes your Telegram API ID, API Hash, and phone number.
  • n8n Configuration: Ensure the TelePilot node and its dependencies are installed and properly configured.

Troubleshooting

Common issues:

  • Invalid User ID: If the provided User ID does not exist or is incorrect, the node may return an error or an empty result.
  • Authentication errors: If your Telegram session is expired or not authenticated, you may see errors like:
    • "Please login: https://telepilot.co/login-howto"
    • "Session was closed or terminated. Please login again: https://telepilot.co/login-howto"
  • API Limitations: If the Telegram API restricts access to certain user information (e.g., due to privacy settings), some fields may be missing or null.

How to resolve:

  • Double-check the User ID value.
  • Ensure your Telegram credentials are valid and you are logged in.
  • If you encounter session errors, follow the login instructions at https://telepilot.co/login-howto.

Links and References

Discussion