Overview

This node enables Telegram login using a phone number via a ChatTrigger interface, supporting multi-factor authentication (MFA) and session management commands. It facilitates Telegram account login, session control, and interaction with Telegram entities such as users, chats, groups, and messages. Common scenarios include automating Telegram login flows, managing sessions, sending messages, and performing various Telegram API operations programmatically within n8n workflows.

Use Case Examples

1. Automate Telegram login by sending commands like /start, /stop, /clear, and /reset through ChatTrigger.
2. Send messages or files to Telegram chats after successful login.
3. Retrieve user, chat, or group information from Telegram.
4. Manage Telegram sessions and handle MFA during login.

Output

JSON

• text - Textual response or status messages from login commands or operations
• compatibility - Information about feature compatibility or limitations
• url - URL for documentation or help related to login or commands
• success - Indicates success status of an operation
• entity - Telegram entity object such as user, chat, or channel
• error - Error message if an operation fails
• errorType - Type/category of error encountered
• errorDetails
  • message - Detailed error message from Telegram API or internal errors
  • code - Error code from Telegram API
  • stack - Stack trace for debugging errors
• chat_id - Telegram chat identifier related to the operation
• sendAsVoice - Flag indicating if audio is sent as a voice message
• filePath - File path used for sending media files
• fileSize - Size of the media file being sent
• fileExtension - File extension of the media file
• warning - Warnings related to media file compatibility or usage

Dependencies

• Telegram API accessed via TelePilotNodeConnectionManager
• An API key credential for Telegram (telePilotApi)

Troubleshooting

• Ensure the Telegram API credentials (apiId, apiHash, phoneNumber) are correctly configured and valid.
• If login commands fail, verify the ChatTrigger node is properly connected and sending commands as expected.
• Common errors include session closure or unauthorized access; these require re-login using the provided guide URL.
• File sending errors may occur due to file size limits, invalid file paths, or unsupported formats; verify file properties before sending.
• MFA (multi-factor authentication) requires correct input of authentication codes or passwords during login.

Links

• TelePilot Login How-To Guide - Official guide for logging in with phone number using TelePilot and ChatTrigger.