Overview
This node allows sending WhatsApp status messages using the ZuckZapGo API. It supports multiple types of status content including text, image, video, and audio. The "Send Audio Status" operation specifically enables users to post audio clips as WhatsApp status updates.
Typical use cases include:
- Sharing voice notes or audio clips as status updates.
- Broadcasting audio announcements or messages to a WhatsApp audience.
- Automating status updates with audio content from various sources (binary data, base64 strings, or URLs).
For example, a user can send a recorded voice note stored in binary form from a previous node or provide a URL to an audio file to be posted as a WhatsApp status.
Properties
| Name | Meaning |
|---|---|
| Audio Source | Select the source of the audio: • Binary Data (from previous node) • Base64 encoded audio string • URL to audio file |
| Binary Property | Name of the binary property containing the audio (used if Audio Source is Binary Data) |
| Base64 Audio | Base64 encoded audio string with data URL prefix (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 |
| Caption | Optional caption text for the audio status |
| Additional Options | Collection of optional parameters: • Message ID: Custom message identifier • Audience: Comma-separated list of recipient JIDs • Exclude List: Comma-separated list of JIDs to exclude from viewing |
Output
The node outputs JSON data representing the response from the ZuckZapGo API after attempting to send the audio status. This typically includes metadata about the sent status message.
If the node encounters an error during execution, it outputs a JSON object with an error field describing the issue.
The node does not output binary data itself; it only sends audio data to the API.
Dependencies
- Requires an API key credential for authenticating with the ZuckZapGo API.
- Uses the ZuckZapGo API endpoint
/status/send/audioto send audio statuses. - The node expects properly formatted audio data depending on the selected source (binary, base64, or URL).
- The helper function
prepareMediaDatais used internally to prepare binary media for upload.
Troubleshooting
- Binary Property Not Found: If the selected binary property does not exist in the input data, the node throws an error like
Binary property "xyz" not found. Ensure the binary data exists and the property name matches exactly. - Missing Required Fields: When using base64 or URL as audio source, the corresponding field (
audioBase64oraudioUrl) must be provided and non-empty. - Invalid Audio Format: The audio MIME type defaults to
audio/oggif not specified. Using unsupported formats may cause API errors. - API Errors: Network issues or invalid API credentials will cause request failures. Verify API key validity and network connectivity.
- Audience and Exclude List Formatting: These fields expect comma-separated lists of valid WhatsApp JIDs. Incorrect formatting may lead to unexpected behavior.
To resolve errors, check input data correctness, ensure required properties are set, and verify API credentials.
Links and References
- WhatsApp Status Feature
- ZuckZapGo API Documentation (replace with actual URL if available)