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 Image" operation specifically allows sending an image message to a specified phone number in international format.
Common scenarios include:
- Automating customer support by sending product images or promotional materials.
- Sharing visual content like photos or infographics in chatbots.
- Sending personalized images with captions to users.
Practical example:
- A marketing automation workflow sends a promotional image with a caption to a list of customers using their phone numbers.
Properties
| Name | Meaning |
|---|---|
| Phone Number | Target recipient's phone number in international format (without the "+" sign). |
| Image Source | Method to provide the image: "Binary Data" (from previous node), "Base64" encoded string, or "URL". |
| Binary Property | Name of the binary property containing the image data when "Binary Data" is selected as source. |
| Base64 Image | Base64 encoded image string including data URL prefix (required if "Base64" is selected). |
| Image URL | URL pointing to the image file (required if "URL" is selected). |
| Caption | Optional caption text to accompany the image message. |
| Additional Options | Collection of extra options: |
| - Message ID | Custom message ID; auto-generated if not provided. |
| - Mentions | Configuration to mention specific users or all group members: |
| - Mention Type | None, Specific Users, or All Group Members. |
| - User JIDs | Comma-separated list of user JIDs to mention (if "Specific Users" is chosen). |
Output
The node outputs JSON data representing the response from the Wuzapi API after sending the image message. This typically includes message metadata such as message ID, status, and any relevant information returned by the API.
If an error occurs, the output JSON will contain an error field with the error message.
The node does not output binary data directly for this operation.
Dependencies
- Requires an active connection to the Wuzapi WhatsApp messaging service.
- Requires an API key credential configured in n8n for authenticating requests to Wuzapi.
- Uses internal helper functions to prepare media data and send HTTP POST requests to Wuzapi endpoints.
Troubleshooting
Binary Property Not Found: If "Binary Data" is selected as the image source but the specified binary property does not exist in the input data, the node throws an error indicating the missing binary property. Ensure the previous node outputs the expected binary data under the correct property name.
Invalid Phone Number Format: The phone number must be in international format without the "+" prefix. Incorrect formatting may cause message delivery failure.
Missing Required Fields: For "Base64" or "URL" image sources, the corresponding fields (
imageBase64orimageUrl) are required. Omitting them will cause errors.API Errors: Any issues communicating with the Wuzapi API (e.g., invalid credentials, network issues) will result in error messages returned in the output JSON. Verify API key validity and network connectivity.
Mentions Misconfiguration: When using mentions, ensure that user JIDs are correctly formatted and comma-separated. Improper mention configuration may lead to unexpected behavior.
Links and References
- Wuzapi Official Website (for API documentation and account setup)
- WhatsApp Business API Documentation (general reference on WhatsApp messaging concepts)