Actions21
Overview
The "Send Status" operation of the ZuckZapGo AI node allows users to broadcast WhatsApp status updates visible to their contacts for 24 hours. It supports sending different types of statuses including text, image, video, and audio. This feature is useful for sharing moments, announcements, or updates with all your WhatsApp contacts simultaneously.
Practical examples:
- Sharing a motivational quote as a text status.
- Posting a photo from an event as an image status with a caption.
- Uploading a short video update about a product launch.
- Broadcasting an audio message or voice note as a status update.
This operation is beneficial for businesses or individuals who want to automate status updates on WhatsApp without manual intervention.
Properties
| Name | Meaning |
|---|---|
| Status Type | The type of status to send. Options: Text, Image, Video, Audio. |
| Status Text | The text content for the status (required if Status Type is Text). |
| Background Color | Optional background color for text status in ARGB decimal format. |
| Text Color | Optional text color for text status in ARGB decimal format. |
| Font | Font type for text status, integer between 0 and 10. |
| Media Source | Source of media for image, video, or audio status. Options: Binary Data (from previous node), Base64 encoded media, URL to media file. |
| Binary Property | Name of the binary property containing the media when using Binary Data source (default: "data"). |
| Base64 Media | Base64 encoded media string with data URL prefix (required if Media Source is Base64). |
| Media URL | URL to the media file (required if Media Source is URL). |
| Voice Note (PTT) | For audio status only: whether to send as a voice note (push-to-talk) or as a regular audio file (default: true). |
| Status Caption | Caption text for image, video, or audio status (optional). |
Output
The node outputs a JSON object representing the API response from the WhatsApp status update request. The structure depends on the underlying API but generally includes confirmation of the status being sent and any relevant metadata.
If the status includes media, the output confirms successful upload and broadcasting.
No binary data is output by this operation.
Dependencies
- Requires an active connection to the ZuckZapGo WhatsApp API service.
- Requires an API key credential configured in n8n for authentication with the ZuckZapGo API.
- The node uses internal helper functions to prepare media data from binary buffers or base64 strings before sending.
Troubleshooting
- Binary Property Not Found: If you select "Binary Data" as media source but the specified binary property does not exist in the input item, the node will throw an error like
Binary property "xyz" not found. Ensure the previous node outputs binary data under the correct property name. - Invalid Media Format: Providing incorrectly formatted base64 strings or invalid URLs may cause the API to reject the media. Verify that base64 strings include proper data URL prefixes and URLs are accessible.
- Missing Required Fields: For text statuses, the "Status Text" field is required. For media statuses, the corresponding media source and data must be provided.
- API Errors: Network issues or invalid API credentials can cause failures. Check your API key configuration and network connectivity.
- Voice Note Option: For audio statuses, setting the "Voice Note (PTT)" option incorrectly might affect how the audio is sent. Use true for voice notes and false for regular audio files.
Links and References
- ZuckZapGo GitHub Repository - Official documentation and source code for the ZuckZapGo WhatsApp API integration.