Actions11
Overview
This node, named "Wuzapi AI," enables sending various types of WhatsApp messages through the Wuzapi service. It is optimized for AI workflows but can be used in any scenario where automated WhatsApp messaging is needed. The node supports sending text, images, documents, audio, video, locations, contacts, stickers, buttons, lists, and polls.
Common use cases include:
- Sending notifications or alerts via WhatsApp.
- Delivering multimedia content such as images, videos, or documents to users.
- Conducting interactive sessions with buttons, lists, or polls.
- Sharing contact information or location details.
- Mentioning specific users or all group members in messages.
For example, a business could use this node to send promotional images with captions, conduct customer polls, or share location details for events.
Properties
| Name | Meaning |
|---|---|
| Phone Number | The recipient's phone number in international format without the "+" sign (e.g., 5491155553934). |
| Additional Options | Collection of optional settings: - Message ID: Custom message identifier (auto-generated if omitted). - Mentions: Specify mention type: • None • Specific Users (comma-separated user JIDs) • All Group Members (groups only) |
| Operation | Type of message to send. Options include: - Send Text - Send Image - Send Document - Send Audio - Send Video - Send Location - Send Contact - Send Sticker - Send Buttons - Send List - Send Poll |
| Message | Text content for text or button messages. Required for these operations. |
| Image Source | Source of image for image messages: - Binary Data - Base64 encoded string - URL link |
| Binary Property (Image) | Name of binary property containing image data when using binary source. |
| Base64 Image | Base64 encoded image string with data URL prefix. Required if image source is base64. |
| Image URL | URL to the image file. Required if image source is URL. |
| Caption | Caption text for image, document, or video messages. Optional. |
| Document Source | Source of document for document messages: - Binary Data - Base64 encoded string - URL link |
| Binary Property (Document) | Name of binary property containing document data when using binary source. |
| Base64 Document | Base64 encoded document string with data URL prefix. Required if document source is base64. |
| Document URL | URL to the document file. Required if document source is URL. |
| File Name | Name of the document file. Required for document messages. |
| Audio Source | Source of audio for audio messages: - Binary Data - Base64 encoded string - URL link |
| Binary Property (Audio) | Name of binary property containing audio data when using binary source. |
| Base64 Audio | Base64 encoded audio string in opus format with data URL prefix. Required if audio source is base64. |
| Audio URL | URL to the audio file. Required if audio source is URL. |
| Voice Note (PTT) | Boolean indicating whether to send audio as a voice note (push-to-talk) or as a regular audio file. |
| Video Source | Source of video for video messages: - Binary Data - Base64 encoded string - URL link |
| Binary Property (Video) | Name of binary property containing video data when using binary source. |
| Base64 Video | Base64 encoded video string with data URL prefix. Required if video source is base64. |
| Video URL | URL to the video file. Required if video source is URL. |
| Latitude | Latitude coordinate for location messages. Required. |
| Longitude | Longitude coordinate for location messages. Required. |
| Location Name | Name or description of the location. Optional. |
| Contact Name | Name of the contact for contact messages. Required. |
| VCard | VCard data string for the contact. Required. |
| Sticker Source | Source of sticker for sticker messages: - Binary Data - Base64 encoded string - URL link |
| Binary Property (Sticker) | Name of binary property containing sticker data when using binary source. |
| Base64 Sticker | Base64 encoded sticker string in WebP format with data URL prefix. Required if sticker source is base64. |
| Sticker URL | URL to the sticker file. Required if sticker source is URL. |
| Button Text | Text displayed on the button for list messages. Required. |
| Description | Description text for list messages. Required. |
| Top Text | Header text shown above the list. Required. |
| Footer Text | Footer text shown below the list. Optional. |
| List Items | Collection of items in the list. Each item requires: - Title (required) - Description (optional) - Row ID (unique identifier, required) |
| Poll Question | Question text for poll messages. Required. |
| Poll Options | Comma-separated list of options for the poll. Required. |
Output
The node outputs an array of JSON objects representing the response from the Wuzapi API for each input item processed. Each output item contains the raw JSON response from the API call confirming the message was sent or detailing any errors.
If the message includes media (images, audio, video, documents, stickers), the node handles the media upload internally and does not output binary data itself.
Dependencies
- Requires an API key credential for authenticating with the Wuzapi service.
- The node uses the Wuzapi API endpoints to send WhatsApp messages.
- No additional environment variables are explicitly required beyond the API credential.
- The node depends on a helper function
prepareMediaDatato format media content before sending.
Troubleshooting
- Binary Property Not Found: If you select a binary source for media but the specified binary property does not exist in the input data, the node will throw an error like
Binary property "data" not found. Ensure the previous node outputs binary data under the correct property name. - Invalid Phone Number Format: The phone number must be in international format without the "+" sign and include the country code. Incorrect formatting may cause message delivery failure.
- Missing Required Fields: For each operation, certain fields are mandatory (e.g., message text for text messages, file name for documents). Omitting these will result in errors.
- Unknown Operation Error: If an unsupported operation value is set, the node throws
Unknown operation: .... Verify the operation parameter is correctly set. - API Errors: Any errors returned by the Wuzapi API will be included in the output JSON. Check the API key validity and quota limits if messages fail to send.
To resolve issues, verify input parameters, ensure proper binary data availability, and confirm API credentials are valid.
Links and References
- Wuzapi Official Website (for API documentation and account setup)
- WhatsApp Business API documentation (general concepts about message types and formats)