Telegram CoPilot icon

Telegram CoPilot

Your Personal Telegram CoPilot

Actions30

Overview

This node enables sending audio messages via Telegram chats using the TelePilot API. It supports sending audio either from a local file path or from binary data provided by a previous node in the workflow. Users can choose to send the audio as a regular audio file or as a voice message with waveform visualization (commonly used for voice notes). This node is useful for automating Telegram interactions where audio content needs to be shared, such as sending voice memos, music clips, or any audio notifications.

Practical examples:

  • Automatically sending a recorded voice note to a Telegram group when a certain event occurs.
  • Sharing an audio alert or notification file stored locally on your system.
  • Forwarding audio data generated or processed earlier in the workflow directly to a Telegram chat.

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 comes from a local file path (Local File Path) or from binary data output by a previous node (Binary Data).
Audio File Path The full path to the local audio file to send. Required if Audio Source is set to 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 in the input item. Required if Audio Source is set to Binary 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 an array of JSON objects representing the result of the send operation for each input item. For the "Send Message with Audio" operation, each output object includes:

  • operation: The operation performed, here "sendMessageAudio".
  • success: Boolean indicating if the message was sent successfully.
  • error: If an error occurred, a string describing the error.
  • result: The raw response from the Telegram API upon successful sending.
  • Additional metadata such as:
    • chat_id: The target chat ID.
    • audioSource: Source type of the audio (filePath or binaryData).
    • audioFilePath: Path to the audio file used (if applicable).
    • binaryPropertyName: Name of the binary property used (if applicable).
    • sendAsVoice: Whether the audio was sent as a voice message.
    • fileSize, fileExtension, and warnings related to file format or size.
    • Detailed error information if the Telegram API returns an error.

If the node receives binary data as input, it expects the audio content to be present in the specified binary property.

Dependencies

  • Requires a valid Telegram API authentication credential configured in n8n (an API key or token).
  • Access to the local filesystem if sending audio from a local file path.
  • The node uses the TelePilot client library internally to interact with the Telegram API.
  • Node environment must have permission to read the specified audio files.
  • No additional external services beyond Telegram are required.

Troubleshooting

  • Common issues:

    • File not found at the specified local path.
    • Binary data missing or binary property name incorrect.
    • File size exceeding Telegram's limits (20MB for voice messages).
    • Sending voice messages with unsupported audio formats (best to use .ogg).
    • Telegram API errors due to user restrictions or invalid file references.

  • Error messages and resolutions:

    • "Audio file not found at path: ...": Verify the file path is correct and accessible.
    • "No binary data exists on input item" or "Binary property '...' not found": Check that the previous node outputs binary data under the specified property name.
    • "File size exceeds Telegram's limit of 20MB for voice messages": Use smaller audio files or send as a regular audio file instead of voice message.
    • "The recipient has restricted receiving of voice messages. Please try sending as a regular audio file instead.": Set Send as Voice Message to false.
    • "File reference has expired. Please try again." or "Invalid file ID.": Retry sending or verify the file source.
    • "Cannot send messages to this chat. You may not have permission.": Ensure the bot/user has write permissions in the chat.

  • Login-related errors:

    • If the node throws errors about unauthorized access or closed sessions, ensure the Telegram account is logged in properly using the associated login nodes and credentials.

Links and References

Discussion