Actions17
Overview
This node enables sending WhatsApp video messages with interactive buttons using the Z-API service. It is designed to facilitate rich user engagement by combining video content with clickable buttons, which can be used for quick replies or call-to-action prompts.
Common scenarios include:
- Marketing campaigns where a product video is sent along with buttons for users to select options or request more information.
- Customer support interactions where a tutorial video is shared with buttons to navigate FAQs or contact agents.
- Event invitations with a video teaser and RSVP buttons.
Example: Sending a promotional video of a washing machine with buttons labeled "Buy Now", "More Info", and "Contact Support" to a customer’s WhatsApp number.
Properties
| Name | Meaning |
|---|---|
| Instance | Your Z-API instance ID used to identify your WhatsApp API instance. |
| Token | Your Z-API token for authenticating API requests. |
| Client Token | Your Z-API client token for additional authentication headers. |
| Phone | The recipient's phone number or group ID where the message will be sent. |
| Message | The text message that accompanies the video and buttons. |
| Video URL | The URL of the video file to send alongside the buttons. |
| Buttons | A collection of interactive buttons to attach to the video message. Each button has: |
| - Button ID: Unique identifier for the button. | |
| - Button Label: Text displayed on the button. |
Output
The node outputs a JSON array containing the response from the Z-API service for each input item processed. The JSON typically includes status information about the message delivery.
No binary data output is produced by this operation.
Dependencies
- Requires access to the Z-API WhatsApp service.
- Needs valid credentials: an instance ID, a token, and a client token.
- Network connectivity to
https://api.z-api.ioendpoints. - Proper configuration of these credentials in n8n or provided as node parameters.
Troubleshooting
- Invalid Credentials: If authentication tokens or instance IDs are incorrect, the API will reject requests. Verify all tokens and instance IDs.
- Invalid Phone Number: Ensure the phone number or group ID is correctly formatted and registered on WhatsApp.
- Video URL Issues: The video URL must be publicly accessible and in a supported format. Private or inaccessible URLs will cause failures.
- Button Configuration Errors: Each button must have a unique ID and label. Missing or duplicate IDs may cause errors.
- API Rate Limits: Excessive requests might be throttled by Z-API; consider adding delays or handling rate limit responses.
- Network Errors: Check internet connectivity and firewall settings if requests fail to reach the API.
Common error messages usually relate to authentication failure, invalid parameters, or resource not found. Reviewing the API response body helps diagnose issues.
Links and References
- Z-API Official Documentation
- WhatsApp Business API Overview
- n8n HTTP Request Node Documentation (for understanding underlying request mechanics)