Actions11
Overview
This node enables sending audio messages via WhatsApp using the Wuzapi service, optimized for AI workflows. It supports sending audio as a voice note (push-to-talk style) or as a regular audio file. The audio content can be provided in multiple formats: binary data from a previous node, base64-encoded string, or a direct URL to an audio file.
Common scenarios include:
- Sending AI-generated voice responses or notifications.
- Delivering pre-recorded audio clips or alerts to users.
- Automating customer support with voice notes.
- Broadcasting audio announcements to groups or individuals.
Example: Automatically send a voice note greeting to a user after they submit a form, where the audio is generated and passed as base64 data.
Properties
| Name | Meaning |
|---|---|
| Phone Number | Target phone number in international format without the "+" sign (e.g., 5491155553934). |
| Audio Source | Method to provide audio content: - Binary Data: Use binary data from previous node. - Base64: Provide base64 encoded audio in opus format. - URL: Provide a URL to the audio file. |
| Binary Property | Name of the binary property containing the audio when "Binary Data" source is selected (default: "data"). |
| Base64 Audio | Base64 encoded audio string in opus format (required if Audio Source is "Base64"). |
| Audio URL | URL to the audio file (required if Audio Source is "URL"). |
| Voice Note (PTT) | Boolean flag indicating whether to send the audio as a voice note (push-to-talk) or as a regular audio file. Default is true (voice note). |
| Additional Options | Collection of optional settings: - Message ID: Custom message identifier (auto-generated if omitted). - Mentions: Specify users or all group members to mention in the message. |
Output
The node outputs JSON data representing the response from the Wuzapi API after sending the audio message. This typically includes message metadata such as message ID, status, and any relevant identifiers returned by the API.
If an error occurs, the output JSON will contain an error field with the error message.
No binary data is output by this node.
Dependencies
- Requires an API key credential for authenticating with the Wuzapi WhatsApp messaging service.
- The node uses the Wuzapi API endpoints to send messages.
- No additional environment variables are explicitly required beyond the API credential configuration.
Troubleshooting
- Binary Property Not Found: If you select "Binary Data" as the audio source but the specified binary property does not exist in the input data, the node will throw an error like
Binary property "xyz" not found. Ensure the binary data exists and the property name matches exactly. - Invalid Phone Number Format: The phone number must be in international format without the "+" prefix. Including invalid characters or missing country code may cause message sending failures.
- Missing Required Fields: For base64 or URL audio sources, the corresponding fields (
audioBase64oraudioUrl) are required. Omitting them will cause errors. - API Errors: Any issues communicating with the Wuzapi API (e.g., authentication failure, rate limits) will result in error messages returned in the output JSON. Check your API key and network connectivity.
- Mentions Misconfiguration: When using mentions, ensure that user JIDs are correctly formatted and comma-separated. Incorrect formatting may cause mention failures.
Links and References
- Wuzapi Official Documentation (for API details and authentication)
- WhatsApp Messaging Best Practices
- n8n Documentation on Working with Binary Data