Telegram BotInstall

Summary

Sends an audio file to a specified Telegram chat, supporting file ID, URL, or binary data input with optional caption.

Inputs

• chat_id (required) — Unique identifier for the target chat or username (@channelusername).
• fileSource — How to provide the file: File ID, URL, or Binary Data (defaults to File ID).
• fileId — File ID of the file to send (required if fileSource is 'fileId').
• fileUrl — URL of the file to send (required if fileSource is 'url').
• binaryPropertyName — Name of the binary property containing the file (required if fileSource is 'binary', defaults to 'data').
• caption — Caption for the audio file.
• parse_mode — How to parse the caption (None, Markdown, MarkdownV2, or HTML; defaults to 'none').
• reply_markup — Inline keyboard, reply keyboard, or other reply markup as JSON.
• additionalFields — Additional parameters such as disable_notification, protect_content, reply_to_message_id, message_thread_id, and disable_web_page_preview.

Output shape

A single record containing the sent message object from the Telegram API response.

The response includes the sent message details (e.g., message_id, chat_id).

Examples

Example 1: Send a pre-uploaded audio file by ID to a chat with a caption.

Set fileSource to 'fileId', provide the chat ID and audio file ID, and add a caption.

Example 2: Upload an audio file from binary data in the workflow to a group chat.

Set fileSource to 'binary', map the binary data to the default 'data' property, and set the chat ID.

Example 3: Send an audio file silently to a channel without notifications.

Set fileSource to 'url' or 'fileId', include a caption, and use additionalFields to set disable_notification to true.

Links

• n8n community nodes installation guide