Actions23
- ✉️ Message Actions
- 👥 Group Actions
Overview
This node allows sending interactive button messages via the Wazzap API to WhatsApp recipients. It is designed to send a message containing a title, description, media (image or video), and up to 9 customizable buttons that users can interact with. Each button can perform different actions such as replying with a predefined ID, copying text to clipboard, opening a URL, or initiating a phone call.
Common scenarios include:
- Marketing campaigns where users can quickly respond or take action by clicking buttons.
- Customer support messages with quick reply options.
- Sharing multimedia content with actionable buttons for engagement.
Example use case: Sending a promotional video with buttons like "Buy Now" (URL), "Call Support" (call), and "More Info" (reply).
Properties
| Name | Meaning |
|---|---|
📱 Recipient Phone Number (jid) |
The full phone number of the recipient including country code. This identifies who will receive the message. |
📝 Title (title) |
The main title text displayed in the message. |
📝 Description (description) |
Optional subtitle or descriptive text shown below the title. |
📎 Media Type (mediaType) |
Type of media to attach: either "video" or "image". |
🔗 Video or Image URL (url) |
Direct URL link to the media file (video or image) to be sent along with the message. |
🔘 Message Buttons (buttons) |
Up to 9 buttons to add to the message. Each button has a type and associated properties: - Reply: Sends back a custom ID when clicked. - Copy: Copies specified text to clipboard. - URL: Opens a web link. - Call: Initiates a phone call to a given number. Each button requires display text and relevant data depending on its type. |
⚙️ Additional Options (options) |
Optional settings: - Priority Number: Selects which sending number to use (0=default, 999=random, 1–5=specific slot). - Delay Settings: Defines a random delay range (in milliseconds) before sending the message. |
Output
The node outputs a JSON array containing the response from the Wazzap API after attempting to send the button message. The exact structure depends on the API but typically includes status information about the message delivery.
If the node supports binary data output (not indicated here), it would represent media or attachments sent or received, but this node primarily deals with JSON responses.
Dependencies
- Requires an active connection to the Wazzap API service.
- Needs an API authentication credential configured in n8n to authorize requests.
- Internet access to reach the media URLs provided.
- Properly formatted phone numbers including country codes.
Troubleshooting
- Unsupported operation error: If the node throws an error about unsupported operations, verify that the resource is set to "✉️ Message" and operation to "🔘 Send Buttons".
- Invalid phone number: Ensure the recipient phone number includes the correct country code and no extra characters.
- Media URL issues: The media URL must be a direct link accessible publicly; otherwise, the message may fail to send.
- Button configuration errors: Each button must have all required fields filled according to its type (e.g., Reply ID for reply buttons, URL for URL buttons).
- API authentication failures: Check that the API key or token is valid and correctly configured in n8n credentials.
- Delays not working as expected: Confirm delay values are numeric and within reasonable ranges.
Links and References
- Wazzap API Documentation (official API reference)
- WhatsApp Interactive Messages Guide (for understanding button message types)