Actions11
Overview
This node enables sending various types of WhatsApp messages through the Wuzapi service, optimized for AI workflows. It supports sending text, images, documents, audio, video, locations, contacts, stickers, buttons, lists, and polls. The "Send List" operation specifically allows sending interactive list messages where recipients can choose from multiple options presented in a structured list format.
Common scenarios include:
- Sending interactive menus or options to users via WhatsApp.
- Collecting user choices through list selections.
- Enhancing chatbot interactions with rich message formats.
- Automating customer support or marketing campaigns with actionable lists.
Example: A business could send a product catalog as a list message, letting customers select items directly within WhatsApp.
Properties
| Name | Meaning |
|---|---|
| Phone Number | Recipient's phone number in international format (without the "+" sign). |
| Button Text | Text displayed on the button that opens the list message. |
| Description | Description shown below the button, explaining the list purpose. |
| Top Text | Header text displayed above the list items. |
| Footer Text | Text shown below the list (optional). |
| List Items | Collection of list entries; each item includes: |
| - Title: The main title of the list item. | |
| - Description: Additional description for the item (optional). | |
| - Row ID: Unique identifier for the item, used to identify the selection. | |
| Additional Options | Optional settings including: |
| - Message ID: Custom ID for the message (auto-generated if omitted). | |
| - Mentions: Configuration to mention specific users or all group members (groups only). |
Output
The node outputs JSON data representing the response from the Wuzapi API after sending the message. This typically includes metadata about the sent message such as message IDs and status.
If an error occurs during sending, the output JSON will contain an error field with the error message.
No binary data is output by this operation.
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 required beyond the configured API credentials.
Troubleshooting
- Binary Property Not Found: If using binary data sources for media (not applicable for Send List), ensure the specified binary property exists in the input data.
- Invalid Phone Number Format: Phone numbers must be in international format without the "+" prefix. Incorrect formatting may cause message sending failures.
- Missing Required Fields: All required properties (e.g., Button Text, Description, Top Text, List Items) must be provided for the Send List operation.
- Unknown Operation Error: Occurs if an unsupported operation value is set. Verify the operation parameter is correctly set to "sendList".
- API Errors: Network issues or invalid API credentials will result in errors returned from the Wuzapi API. Check API key validity and network connectivity.
To resolve errors, verify all required parameters, confirm correct phone number formatting, and ensure valid API credentials are configured.
Links and References
- Wuzapi Official Website (for API documentation and account setup)
- WhatsApp Business API documentation for understanding message types and formats
- n8n Documentation on creating custom nodes and handling binary data