Actions32
- Bot Actions
- Callback Actions
- Chat Actions
- File Actions
- Message Actions
- Payment Actions
- Sticker Actions
Overview
The "Send Audio" operation of the Message resource in this node allows users to send audio files to a specified chat via the Bale Messenger API. This is useful for automating the delivery of voice messages, music clips, or any audio content within chat conversations. For example, a user could automate sending recorded customer support responses, podcast snippets, or alerts as audio messages directly into a chat.
Properties
| Name | Meaning |
|---|---|
| Chat ID | Unique identifier for the target chat where the audio will be sent. |
| Binary Data | Boolean indicating whether the audio file data should be taken from a binary field in the input. |
| Binary Property | The name of the binary property containing the audio data to upload (used if Binary Data is true). |
| File ID | Identifier of an existing audio file on Bale servers to send instead of uploading new data. |
| Caption | Optional text caption to accompany the audio message (0-1024 characters). |
| Reply Markup | Additional interface options for the message, such as inline keyboard, reply keyboard, or none. |
| Inline Keyboard | Configuration for an inline keyboard that appears next to the message (if Reply Markup is set to Inline Keyboard). |
| Reply Keyboard | Configuration for a custom reply keyboard with buttons (if Reply Markup is set to Reply Keyboard). |
| Reply Keyboard Remove | Options to remove a custom keyboard from the client (if Reply Markup is set to Reply Keyboard Remove). |
| Reply To Message ID | If replying to a specific message, the ID of that original message. |
| File Name | Filename to assign to the uploaded audio file (used if Binary Data is true). |
Output
The output JSON contains the response from the Bale Messenger API after sending the audio message. It typically includes details about the sent message such as message ID and status. No binary data is output by this operation.
Dependencies
- Requires an API authentication token credential for Bale Messenger.
- Uses the official Bale Messenger Bot API endpoint at
https://tapi.bale.ai/bot. - Relies on the
node-telegram-bot-apilibrary internally for API interactions. - The node expects the audio file either as a binary input or as a file ID referencing an existing file on Bale servers.
Troubleshooting
- Invalid Chat ID: Ensure the Chat ID is correct and the bot has permission to send messages to that chat.
- Binary Data Issues: If using binary data, verify the binary property name matches the actual binary input field and that the data is properly formatted.
- File ID Not Found: When using a File ID, confirm the file exists on Bale servers and the ID is valid.
- Caption Length: Captions longer than 1024 characters may cause errors; keep captions within limits.
- Reply Markup Misconfiguration: Incorrectly structured keyboards can cause API errors; use the provided UI options carefully.
- API Errors: Network issues or invalid credentials will result in failed requests; check API token validity and network connectivity.
Links and References
- Bale Messenger Bot API Documentation (general reference for API methods)
- n8n Documentation - Creating Custom Nodes (for understanding node development concepts)