Actions85
- Instances Actions
- Client Actions
- Message Actions
- Chat Actions
- Contact Actions
- Number Actions
- Group Actions
- Channel Actions
- Label Actions
- Story Actions
Overview
This node interacts with the WaAPI API to retrieve detailed information about a specific WhatsApp contact by their unique WhatsApp ID. It is useful in scenarios where you need to fetch contact details such as profile information, status, or other metadata associated with a WhatsApp user within an automation workflow.
Practical examples include:
- Enriching customer data in a CRM by fetching up-to-date WhatsApp contact info.
- Validating if a WhatsApp contact exists before sending messages.
- Automating support workflows that require retrieving contact details dynamically.
Properties
| Name | Meaning |
|---|---|
| Id | Instance ID (a numeric identifier for the node instance). |
| Contact Id | The WhatsApp ID of the contact in the format number@c.us (e.g., 1234567890@c.us). |
Output
The node outputs JSON data containing the retrieved contact information from the WaAPI service. This typically includes fields such as the contact's WhatsApp ID, profile name, status, and possibly other metadata returned by the API.
If the node supports binary data output, it would represent media or profile pictures related to the contact, but based on the provided code and properties, the primary output is structured JSON data about the contact.
Dependencies
- Requires an active connection to the WaAPI API service.
- Needs an API key credential configured in n8n to authenticate requests to WaAPI.
- The base URL for API requests is
https://waapi.app/api/v1. - The node uses standard HTTP headers for JSON communication (
Accept: application/json,Content-Type: application/json).
Troubleshooting
Common issues:
- Invalid or missing API key credential will cause authentication failures.
- Providing an incorrectly formatted WhatsApp ID (not matching
number@c.us) may result in errors or no data found. - Network connectivity problems can prevent successful API calls.
Error messages:
- Authentication errors usually indicate invalid or expired API credentials; verify and update the API key.
- "Contact not found" or similar messages suggest the specified WhatsApp ID does not exist or is incorrect.
- Timeout or network errors require checking internet connectivity and API service status.
Links and References
- WaAPI Official Documentation (for API details and contact data structure)
- n8n Documentation (for general node usage and credential setup)