Overview

This node interacts with the Telegram API to perform various user-related operations such as retrieving user information, creating private or secret chats, and managing user entities. It is useful for automating Telegram user management tasks within workflows, such as fetching detailed user info or initiating chats programmatically.

Use Case Examples

1. Retrieve basic user information by user ID.
2. Get full detailed information about a user.
3. Create a private chat with a specified user.
4. Initiate a new secret chat with a user.

Properties

Output

JSON

• id - The unique identifier of the Telegram user or chat entity.
• firstName - The first name of the user (if available).
• lastName - The last name of the user (if available).
• username - The Telegram username of the user (if available).
• phoneNumber - The phone number associated with the user (if available).
• status - The current status of the user (online, offline, etc.).
• fullInfo - Detailed user information returned by the GetFullUser API call.
• chatInfo - Information about private or secret chats created with the user.

Dependencies

• Telegram API accessed via an API key credential (telePilotApi)

Troubleshooting

• Client not initialized error: Ensure the Telegram account is logged in via the login operation before performing user operations.
• Entity is not a user error: Occurs if the provided user ID does not correspond to a valid Telegram user entity.
• Session closed or terminated error: Indicates the Telegram session has expired or disconnected; re-login is required.
• Unauthorized error: The API credentials are invalid or expired; re-authenticate the Telegram account.

Links

• TelePilot Login Guide - Instructions on how to log in and authenticate the Telegram account for this node.