Actions21
Overview
This node enables sending WhatsApp audio messages using the DinastiAPI service. It supports sending audio as either voice notes (push-to-talk style) or regular audio files in OGG Opus format. The audio content can be provided via binary data from a previous node, base64-encoded strings, or direct URLs to audio files.
Common scenarios for this node include:
- Sending personalized voice notes to customers or contacts.
- Broadcasting audio announcements or updates to groups, newsletters, or specific users.
- Automating audio message delivery in customer support or marketing workflows.
For example, you could use this node to send a recorded voice message stored as binary data from an earlier step, or send an audio file hosted on a web server by providing its URL.
Properties
| Name | Meaning |
|---|---|
| Recipient | Phone number, Group ID (@g.us), Newsletter ID (@newsletter), or LID (@lid) identifying the message recipient. |
| Audio Source | Method of providing the audio: Binary Data (from previous node), Base64 (base64 encoded audio string), or URL (link to audio file). |
| Binary Property | Name of the binary property containing the audio data when using Binary Data as source. Default is "data". |
| Base64 Audio | Base64 encoded audio string in OGG Opus format, required if Audio Source is set to Base64. |
| Audio URL | URL to the audio file, required if Audio Source is set to URL. |
| Voice Note (PTT) | Boolean flag indicating whether to send the audio as a voice note (push-to-talk style) or as a regular audio file. Defaults to true (send as voice note). |
| Additional Options | Collection of optional settings including: - Custom message ID - Presence simulation duration (typing/recording indicator) - Message disappearing duration (no expiration, 24h, 7d, 90d) - View once flag (message can only be viewed once) - Context information for replies, forwards, mentions |
Output
The node outputs JSON data representing the response from the DinastiAPI after attempting to send the audio message. This includes status information and any metadata returned by the API.
If the operation fails and "Continue On Fail" is enabled, the output will contain an error object with the error message.
No binary data is output by this node for the "Send Audio" operation.
Dependencies
- Requires an active connection to the DinastiAPI service with a valid API key credential configured in n8n.
- The node uses HTTP requests to communicate with DinastiAPI endpoints.
- For binary audio input, the previous node must provide the audio data in the specified binary property.
Troubleshooting
- Binary Property Not Found: If using binary audio source, ensure the specified binary property exists in the input data; otherwise, an error like
Binary property "data" not foundwill occur. - Invalid Audio Format: Audio must be in OGG Opus format when using base64 or binary sources; other formats may cause failures.
- Invalid Recipient Format: The recipient identifier must be a valid phone number or group/newsletter/LID ID with correct suffixes (
@g.us,@newsletter,@lid). Incorrect formatting may lead to message delivery failure. - Network or Authentication Errors: Ensure the API key credential is valid and network connectivity to DinastiAPI is available.
- Message Size Limits: Large audio files might exceed API limits; consider compressing or shortening audio.
Links and References
- DinastiAPI GitHub Repository - Official documentation and API reference for DinastiAPI.