Overview

This node operation creates a private chat with a specified Telegram user. It is useful when you want to programmatically initiate a direct chat with a user by their user ID. For example, it can be used in automation workflows to start conversations with users for customer support or notifications.

Use Case Examples

1. Create a private chat with a user by providing their user ID to send messages or media later.
2. Force the creation of a private chat even if one already exists, ensuring a fresh chat instance.

Properties

Output

JSON

• id - The unique identifier of the created or existing private chat entity.
• entity - The Telegram user entity object representing the private chat.

Dependencies

• Requires Telegram API credentials (API ID, API Hash, and phone number) for authentication.

Troubleshooting

• Client not initialized error: Ensure you are logged in with valid Telegram credentials before executing this operation.
• Entity is not a user error: The provided user ID must correspond to a valid Telegram user entity.
• Session closed or unauthorized errors: These indicate the Telegram session has expired or is invalid; re-login is required using the login flow.
• Force flag misuse: Forcing chat creation may cause unexpected behavior if a chat already exists; use with caution.

Links

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