Telegram CoPilot icon

Telegram CoPilot

Your Personal Telegram CoPilot

Actions34

Message → Send Message with Audio

AI-generated

Overview

This node operation sends an audio message to a specified Telegram chat. It supports sending audio either from a local file path or from binary data provided by a previous node. Users can optionally add a caption to the audio and choose to send it as a voice message with waveform visualization or as a regular audio file. This operation is useful for automating audio message delivery in Telegram chats, such as sending voice notes, music clips, or other audio content programmatically.

Use Case Examples

  1. Sending a voice message to a Telegram chat using a local .ogg file.
  2. Sending an audio file from binary data obtained from a previous node in the workflow.
  3. Adding an optional caption to the audio message for context or description.

Properties

Name Meaning
Chat ID The identifier of the Telegram chat where the audio message will be sent.
Audio Source Determines whether the audio is sourced from a local file path or binary data from a previous node.
Audio File Path The path to the local audio file to be sent. Required if Audio Source is 'Local File Path'.
Audio Caption An optional caption to accompany the audio message.
Reply to messageId The identifier of a message to which this audio message will be a reply.
Binary Property The name of the binary property containing the audio data when using binary data as the audio source.
Send as Voice Message Whether to send the audio as a voice message with waveform visualization (true) or as a regular audio file (false).

Output

JSON

  • operation - The operation performed, here it is 'sendMessageAudio'.
  • success - Indicates whether the audio message was sent successfully.
  • error - Error message if the operation failed.
  • result - The result object returned from the Telegram API after sending the audio message.
  • chat_id - The chat ID where the audio was sent.
  • audioSource - The source of the audio, either 'filePath' or 'binaryData'.
  • sendAsVoice - Boolean indicating if the audio was sent as a voice message.
  • binaryPropertyName - The name of the binary property used if audio source is binary data.
  • audioFilePath - The file path of the audio file sent.
  • audioCaption - The caption text sent with the audio message.
  • reply_to_msg_id - The message ID to which this audio message is a reply.
  • fileSize - Size of the audio file in bytes.
  • fileExists - Boolean indicating if the audio file exists at the specified path.
  • fileExtension - The file extension of the audio file.
  • warning - Warnings related to the audio file format or size.
  • errorDetails - Detailed error information if the Telegram API call fails.

Dependencies

  • Telegram API accessed via an API key credential

Troubleshooting

  • Ensure the Telegram API credentials are correctly configured and the session is active; errors like 'Unauthorized' or 'Session was closed' indicate login issues.
  • Verify the chat ID is correct and the bot/user has permission to send messages to the chat; 'CHAT_WRITE_FORBIDDEN' error indicates permission issues.
  • Check the audio file path or binary data is valid and accessible; errors like 'Audio file not found' or missing binary property indicate input issues.
  • For voice messages, ensure the audio file is in .ogg format and under 20MB to avoid compatibility and size limit errors.
  • If the Telegram API returns errors like 'FILE_REFERENCE_EXPIRED' or 'FILE_ID_INVALID', retry the operation or verify the file source.

Links

Discussion