Overview
The Wuzapi User node interacts with the Wuzapi WhatsApp API to retrieve and manage user information and presence status. It supports multiple operations such as checking if users have WhatsApp, fetching detailed user info, retrieving avatars, getting contacts, and setting global presence.
This node is useful in scenarios where you want to automate WhatsApp user data retrieval or presence management within workflows. For example:
- Verifying which phone numbers are registered on WhatsApp before sending messages.
- Fetching profile pictures of users for display or processing.
- Managing your WhatsApp presence status programmatically.
- Retrieving contact lists from your WhatsApp account.
Properties
| Name | Meaning |
|---|---|
| Operation | The action to perform. Options: Check Users, Get Avatar, Get Contacts, Get User Info, Set Presence |
| Phone Numbers | Comma-separated list of phone numbers to check or get info for (used in "Check Users" and "Get User Info" operations) |
| Phone Number | Single phone number to get avatar for (used in "Get Avatar" operation) |
| Preview | Whether to get a thumbnail (true) or full picture (false) for the avatar |
| Save as Binary | Whether to save the avatar image as binary data instead of just returning a URL |
| Binary Property Name | Name of the binary property to store the avatar image when saving as binary |
| Presence Type | Global presence status to set. Options: Available (online), Unavailable (offline) |
Output
The output JSON structure depends on the selected operation:
- Check Users / Get User Info: Returns an array of user objects containing details about each phone number queried.
- Get Avatar: Returns an object with avatar data, typically including a URL or base64 image data. If "Save as Binary" is enabled, the avatar image is saved as binary data under the specified property name.
- Get Contacts: Returns a list of all contacts associated with the WhatsApp account.
- Set Presence: Returns confirmation of the presence status update.
When saving avatars as binary, the node outputs the image data in binary format with appropriate MIME type and file extension, enabling further processing or storage within n8n.
Dependencies
- Requires an active connection to the Wuzapi WhatsApp API via an API key credential.
- The node uses internal helper functions to validate phone numbers and make authenticated HTTP requests to the Wuzapi endpoints.
- No additional external dependencies beyond the configured API credential.
Troubleshooting
- Invalid Phone Numbers: Ensure phone numbers are provided in the correct international format without spaces or special characters. The node validates and trims input but malformed numbers may cause errors.
- API Authentication Errors: Verify that the API key credential is correctly configured and has sufficient permissions.
- Avatar Download Issues: When saving avatars as binary, if the returned data is a URL, you must use an HTTP Request node to download the image separately.
- Operation Not Supported: Selecting an unsupported operation or missing required parameters will result in errors. Double-check the operation and required fields.
- Continue On Fail: If enabled, the node will continue processing other items even if one fails, returning error details in the output.
Links and References
- Wuzapi WhatsApp API Documentation (example link, replace with actual)
- n8n Documentation on Creating Custom Nodes
- n8n Community Forum for support and examples