WhatsApi icon

WhatsApi

Connect with WhatApp HTTP API

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 and Content-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

Discussion