Actions28
- Messages Actions
- Media Actions
- Templates Actions
- Contacts Actions
- Analytics Actions
- Webhooks Actions
Overview
This node integrates with the WhatsApp Business API via the N8N Tools platform, providing a comprehensive set of operations across multiple WhatsApp resources. Specifically for the Contacts resource and the Check Contact operation, it allows users to verify whether a given phone number is registered on WhatsApp.
Common scenarios where this node is beneficial include:
- Validating customer phone numbers before sending messages to avoid errors or message failures.
- Filtering contact lists to ensure only valid WhatsApp users are targeted in campaigns.
- Automating workflows that depend on WhatsApp user verification.
Practical example:
- Before sending a promotional message, use the "Check Contact" operation to confirm the recipient's phone number is active on WhatsApp, ensuring higher delivery success rates.
Properties
| Name | Meaning |
|---|---|
| Phone Number | The phone number to check, provided in international format (e.g., 5511999999999). |
Output
The node outputs JSON data representing the result of the contact check operation. This typically includes information indicating whether the specified phone number is registered on WhatsApp and possibly additional metadata about the contact status.
If multiple items are processed, the output is an array of such JSON objects, each corresponding to an input item.
No binary data output is involved in this operation.
Dependencies
- Requires an active subscription and valid API key credential for the N8N Tools API service.
- Needs proper configuration of credentials within n8n for accessing the WhatsApp Business API through N8N Tools.
- The node performs an initial validation call to the N8N Tools API to verify subscription and API key validity before executing operations.
Troubleshooting
- Invalid subscription or API key error: If the node throws an error indicating invalid subscription or API key, verify that the API key credential is correctly configured and active.
- HTTP request failures: Network issues or incorrect API URLs can cause failures; ensure the API URL and network connectivity are correct.
- Malformed phone number: Ensure the phone number is in the correct international format without extra characters or spaces.
- Continue On Fail behavior: If enabled, the node will continue processing other items even if one fails, returning error details per failed item.
Links and References
- WhatsApp Business API Documentation
- N8N Official Documentation
- N8N Tools Platform (for API subscription and key management)