Actions48
- Instance Actions
- Message Actions
- Group Actions
- Contact Actions
- Media Actions
- Webhook Actions
- Profile Actions
Overview
This node integrates with the Evolution API to manage WhatsApp contacts and retrieve their status information. Specifically, the "Get Status" operation under the "Contact" resource fetches the status/about text of a specified WhatsApp contact by their phone number.
Use cases include:
- Displaying or logging the current status message of a contact.
- Automating workflows that depend on a contact's status (e.g., filtering contacts based on their status).
- Enriching contact data in CRMs or messaging platforms with up-to-date status information.
Example: You want to check the status message of a customer before sending a personalized message or triggering a follow-up action.
Properties
| Name | Meaning |
|---|---|
| Phone Number | The target contact's phone number including country code, without the "+" sign. |
| Additional Fields | Optional extra parameters such as: - Delay (ms) before sending - Link Preview enabled/disabled - Quoted Message ID for replies - Mentions (comma-separated numbers) |
Note: For the "Get Status" operation, only the "Phone Number" is required; additional fields are not typically used.
Output
The node outputs JSON data containing the response from the Evolution API about the contact's status. The structure generally includes:
- Contact status/about text.
- Possibly other metadata related to the contact's profile status.
The output is an array where each item corresponds to an input item processed, with the json property holding the API response.
No binary data is produced by this operation.
Dependencies
- Requires an API key credential for the Evolution API service.
- Optionally uses another API key credential for a validation service ("N8N Tools API") to verify subscription and access rights before making requests.
- The node expects configuration of:
- Base URL of the Evolution API.
- Instance name identifier for the WhatsApp instance.
- API keys securely stored in n8n credentials.
Troubleshooting
- Invalid subscription or API key error: If the node throws an error indicating invalid subscription or API key, verify that the provided API keys are correct and active.
- Unknown resource or operation errors: These occur if the resource or operation parameter is misspelled or unsupported. Ensure "Contact" resource and "Get Status" operation are selected correctly.
- Network or request failures: Check network connectivity and that the Evolution API endpoint is reachable.
- Empty or missing status in output: Confirm the phone number is registered on WhatsApp and has a status set.
Links and References
- Evolution API Documentation (hypothetical link as no direct link provided)
- WhatsApp Business API concepts for contact status
- n8n documentation on creating custom nodes and using credentials