Actions21
Overview
The node "ZuckZapGo AI" integrates with the ZuckZapGo WhatsApp API to perform various WhatsApp messaging and information retrieval operations. It is optimized for AI workflows, enabling automated communication and data fetching from WhatsApp contacts, groups, newsletters, and business profiles.
For the Get User Info operation specifically, the node fetches detailed user information such as presence status, profile data, last seen time, and verification status for a given WhatsApp contact phone number.
Common scenarios:
- Retrieving up-to-date contact details before sending messages.
- Checking user presence or last seen status for customer support automation.
- Verifying user profile information in CRM or marketing workflows.
Practical example:
You want to automatically check if a customer is currently online on WhatsApp and retrieve their profile info before sending a personalized message. Using this node's Get User Info operation, you input the customer's international phone number, and it returns structured user data that your workflow can use to tailor communication.
Properties
| Name | Meaning |
|---|---|
Phone Number (userPhone) |
The target user's phone number in international format (without the +). Required for Get User Info. |
Optimize Response (optimizeResponse) |
Whether to optimize the API response to reduce token usage and improve AI processing. |
Max Response Length (maxResponseLength) |
Maximum number of characters in the response; longer responses will be truncated. |
Include Only Essential Fields (essentialFieldsOnly) |
Whether to include only essential fields in the response to reduce noise. |
Response Format (responseFormat) |
How to format the response for optimal AI understanding. Options: - Optimized: Clean, structured response. - Raw: Complete raw API response. - Summary: Brief summary with key info only. |
Output
The node outputs JSON data containing the user information retrieved from the WhatsApp API endpoint /chat/user/info. The structure includes detailed user profile data such as:
- Presence status (online/offline)
- Profile picture URL
- Last seen timestamp
- Verification status
- Other relevant metadata about the user
If the "Optimize Response" option is enabled, the output may be truncated or filtered to include only essential fields or summarized for easier AI consumption.
No binary data is produced by this operation.
Dependencies
- Requires an active connection to the ZuckZapGo WhatsApp API service.
- Needs an API authentication credential configured in n8n to authorize requests.
- The node uses internal helper functions to prepare media data and make HTTP requests to the API.
Troubleshooting
- Error: Binary property not found — Not applicable for Get User Info but common in media send operations when specified binary data is missing. Ensure the binary property name matches the input data.
- Unknown operation error — Occurs if an unsupported operation value is set. Verify the operation parameter is correctly set to "getUserInfo".
- API request failures — Could be due to invalid phone number format or network issues. Confirm the phone number is in international format without "+" and the API credentials are valid.
- Empty or incomplete user data — May happen if the user does not exist or privacy settings restrict access. Check the phone number correctness and user availability on WhatsApp.
Links and References
- ZuckZapGo GitHub Repository — Official documentation and source code for the API used by this node.