Actions29
- Sessions Actions
- Chats Actions
- Contacts Actions
- Groups Actions
- Messages Actions
Overview
This node integrates with a WhatsApp HTTP API to check the status or validity of a phone number (referred to as "jid" in WhatsApp terminology). It is useful for scenarios where you need to verify if a given WhatsApp number is active or reachable before sending messages or performing other contact-related operations. For example, businesses can use this node to validate customer numbers during onboarding or prior to marketing campaigns.
Properties
Name | Meaning |
---|---|
Phone | The session ID representing the WhatsApp account to use. Typically linked to the authenticated phone number credential. |
To | The WhatsApp number (JID) to check, formatted like [email protected] . |
Output
The node outputs JSON data containing the response from the WhatsApp API regarding the checked number. This typically includes information about whether the number is valid, registered on WhatsApp, or any related metadata returned by the API. The exact structure depends on the external API's response schema.
No binary data output is indicated.
Dependencies
- Requires an external WhatsApp HTTP API service endpoint.
- Needs an API URL and authentication credentials configured in n8n (e.g., an API key or token).
- The node uses standard HTTP headers (
Accept: application/json
andContent-Type: application/json
) for requests.
Troubleshooting
- Invalid Session ID or Authentication Failure: Ensure that the session ID (Phone property) corresponds to a valid authenticated WhatsApp session and that the API credentials are correctly set.
- Incorrect JID Format: The "To" property must be a valid WhatsApp JID string (e.g.,
[email protected]
). Invalid formats will cause errors. - API Connectivity Issues: Network problems or incorrect API base URL configuration can lead to request failures.
- Unexpected API Responses: If the API changes or returns unexpected data, the node might not handle it properly. Verify API documentation and update configurations accordingly.
Links and References
- WhatsApp Business API Documentation
- n8n HTTP Request Node Documentation (for understanding how API calls are made)