Overview
The Wuzapi User node interacts with the Wuzapi WhatsApp API to retrieve and manage user-related information. It supports operations such as checking if phone numbers have WhatsApp accounts, fetching detailed user info, retrieving avatars, getting contacts, and setting global presence status.
This node is useful in scenarios where you want to verify WhatsApp users, gather profile data, or manage presence programmatically within an automation workflow. For example, a business could use it to validate customer phone numbers before sending messages or update their online presence status dynamically.
Properties
| Name | Meaning |
|---|---|
| Operation | The action to perform. Options: - Check Users: Verify if users have WhatsApp - Get Avatar: Retrieve user profile picture - Get Contacts: Fetch all contacts - Get User Info: Get detailed user information - Set Presence: Set global user presence status |
| Phone Numbers | Comma-separated list of phone numbers to check or get info for (used in "Check Users" and "Get User Info" operations). Example: 5491155553934,5491155553935 |
| Phone Number | Single phone number to get avatar for (used in "Get Avatar" operation). Example: 5491155553934 |
| Preview | Boolean flag to choose between thumbnail (true) or full picture (false) when getting avatar |
| Save as Binary | Boolean flag indicating whether to save the avatar image as binary data in the output (only for "Get Avatar") |
| Binary Property Name | Name of the binary property to store the avatar image if saved as binary (default: "avatar") |
| Presence Type | Global presence status to set (used in "Set Presence" operation). Options: - Available: Show as online - Unavailable: Show as offline |
Output
The node outputs JSON data corresponding to the selected operation:
- Check Users / Get User Info: Returns an array of user objects with details about each phone number.
- Get Avatar: Returns avatar data including a URL or base64 image data. If "Save as Binary" is enabled, the avatar image is stored as binary data under the specified binary property name.
- Get Contacts: Returns a list of contacts.
- Set Presence: Returns confirmation of the presence status update.
When saving avatars as binary, the binary data includes:
- Base64 encoded image data
- MIME type (e.g.,
image/jpeg) - File extension and file name based on the phone number and image type
Dependencies
- Requires connection to the Wuzapi WhatsApp API via an API key credential.
- Uses internal helper functions for phone number validation and API requests.
- No additional external dependencies beyond the configured API authentication.
Troubleshooting
- Invalid Phone Numbers: Ensure phone numbers are correctly formatted and validated; otherwise, the API may reject them.
- API Request Failures: Network issues or invalid credentials can cause errors. Verify API key validity and network connectivity.
- Avatar Download Issues: If saving avatars as binary, ensure the returned data is a valid base64 string. If the avatar URL is HTTP(S), use an HTTP Request node to download the image separately.
- Operation Mismatch: Using properties not relevant to the chosen operation (e.g., providing multiple phone numbers for avatar retrieval) will not work as expected.
Links and References
- Wuzapi WhatsApp API Documentation (example placeholder, replace with actual link if available)
- n8n Documentation on Creating Custom Nodes