Telegram CoPilot icon

Telegram CoPilot

Your Personal Telegram CoPilot
Join our community

Actions33

Overview

This node integrates with Telegram via the TelePilot API, enabling automated interaction with Telegram chats and messages. Specifically, the Send Message with Audio operation under the Message resource allows sending audio content to a specified chat either as a regular audio file or as a voice message with waveform visualization.

Common scenarios for this node include:

  • Sending voice notes or audio clips to Telegram groups or individual chats automatically.
  • Automating notifications or alerts that include audio messages.
  • Integrating audio responses in chatbots or customer support workflows on Telegram.

For example, you could use this node to send a recorded meeting summary as an audio file to a team chat, or to deliver voice reminders to users.

Properties

Name Meaning
Chat ID The unique identifier of the Telegram chat where the audio message will be sent.
Audio Source Choose whether the audio is provided as a local file path or as binary data from a previous node. Options: Local File Path, Binary Data.
Audio File Path The file system path to the local audio file to send (required if Audio Source is Local File Path).
Audio Caption Optional text caption to accompany the audio message.
Binary Property The name of the binary property containing the audio data when using binary input (default is "data").
Send as Voice Message Boolean flag indicating whether to send the audio as a voice message with waveform visualization (true) or as a regular audio file (false).
Reply to messageId Optional message ID to which this audio message should reply.

Output

The node outputs a JSON array with one object per execution containing detailed information about the send operation:

  • operation: Always "sendMessageAudio" for this operation.
  • success: Boolean indicating if the message was sent successfully.
  • error: If an error occurred, a short description of the error.
  • result: The full response object returned by the Telegram API upon successful sending.
  • chat_id: The target chat ID.
  • audioSource: Indicates whether the audio came from a file path or binary data.
  • binaryPropertyName: If applicable, the binary property name used.
  • audioFilePath: The local file path used (if applicable).
  • fileSize: Size of the audio file in bytes.
  • fileExtension: Extension of the audio file (e.g., "ogg", "mp3").
  • warning: Warnings such as format recommendations for voice messages.
  • errorType: Categorized error type for easier troubleshooting.
  • errorDetails: Detailed error info including stack trace and context if an error occurs.

If the audio is sent as a voice message, it includes waveform visualization on Telegram clients; otherwise, it is sent as a standard audio file.

Dependencies

  • Requires a valid Telegram API authentication credential (an API key/token) configured in n8n.
  • Access to the local filesystem if using local file paths for audio.
  • The node uses the TelePilot client library internally to communicate with Telegram's API.
  • Node expects the input binary data to be properly formatted and accessible if using binary input.

Troubleshooting

Common Issues

  • File not found: If the specified local audio file path does not exist, the node will error out.
  • File size limit exceeded: Voice messages have a 20MB size limit; larger files will cause errors.
  • Unsupported audio format for voice messages: Voice messages work best with .ogg files; other formats may trigger warnings or compatibility issues.
  • Missing binary data: When using binary input, the specified binary property must exist and contain a valid file path.
  • Unauthorized / Session closed: If the Telegram session is not logged in or has expired, the node will throw errors prompting re-login.
  • User restrictions: Errors like "User restricted receiving of video messages" indicate the recipient has blocked certain message types.

Error Messages and Resolutions

Error Message Explanation & Resolution
Audio file not found at path: ... The local file path is incorrect or inaccessible. Verify the path and permissions.
File size exceeds Telegram's limit for voice messages The audio file is too large for voice messages. Use a smaller file or send as a regular audio file instead.
Binary property "..." not found The specified binary property does not exist on the input item. Check the binary property name spelling.
Please login The Telegram session is not authenticated. Use the login flow with the ChatTrigger node before sending messages.
The recipient has restricted receiving of voice messages The recipient does not accept voice messages. Try sending as a regular audio file instead.
File reference has expired Temporary file references are no longer valid. Retry sending the file.
Cannot send messages to this chat You lack permission to send messages to the target chat. Check chat permissions or bot rights.

Links and References

Discussion