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 Poll" operation allows creating interactive polls in WhatsApp groups by specifying a question and multiple options.
Common scenarios include:
- Conducting quick surveys or polls within WhatsApp groups.
- Engaging users with interactive content like buttons or lists.
- Automating customer support or marketing messages with rich media.
- Sharing location or contact information seamlessly.
Example use case for "Send Poll":
You want to ask a group "What's your favorite color?" with options "Red, Blue, Green, Yellow". This node sends that poll to the specified WhatsApp group, allowing members to vote directly.
Properties
| Name | Meaning |
|---|---|
| Phone Number | Target phone number in international format (without +). For groups, this is the group ID with suffix. |
| Poll Question | The question text displayed at the top of the poll. |
| Poll Options | Comma-separated list of options participants can choose from. |
| Additional Options | Collection of optional settings: |
| - Message ID | Custom identifier for the message; auto-generated if omitted. |
| - Mentions | Configuration to mention specific users or all group members: |
| - Mention Type | None, Specific Users, or All Group Members (groups only). |
| - User JIDs | Comma-separated list of user IDs to mention (only if "Specific Users" selected). |
Output
The node outputs JSON data representing the response from the Wuzapi API after sending the message. The structure includes details about the sent message such as message ID and status.
If an error occurs, the output JSON contains an error field with the error message.
No binary data is output by this node.
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 API credential.
Troubleshooting
- Binary Property Not Found: If using binary data sources for media, ensure the specified binary property exists in the input data. Otherwise, an error will be thrown.
- Invalid Phone Number Format: Phone numbers must be in international format without the "+" prefix and include the WhatsApp domain suffix (e.g.,
5491155553934@s.whatsapp.net). - Unknown Operation Error: Occurs if an unsupported operation is selected. Verify the operation name matches one of the supported options.
- API Request Failures: Network issues or invalid credentials may cause request failures. Check API key validity and network connectivity.
- Mention Configuration Errors: When mentioning specific users, ensure the JIDs are correctly formatted and comma-separated.
To resolve errors, verify input parameters carefully and consult the Wuzapi API documentation for message formatting requirements.
Links and References
- Wuzapi Official Website (for API documentation and account setup)
- WhatsApp Business API documentation (general reference for message types and formats)