CHACHAT Check Number Node

Node for validating if a phone number works

Overview

This node validates whether a given phone number is functional or valid by sending it to an external phone number validation API. It is useful in scenarios where you need to verify user input phone numbers before proceeding with further processing, such as contact management, messaging workflows, or customer verification processes.

For example, you might use this node to:

  • Check if a phone number entered in a form is active and reachable.
  • Validate phone numbers before sending SMS campaigns.
  • Filter out invalid phone numbers from a list to improve data quality.

Properties

Name Meaning
Phone Number The phone number to be validated.

Output

The node outputs JSON data returned from the external phone number validation API. This JSON typically contains details about the validity and status of the phone number checked.

The output structure is:

{
  "json": {
    // API response fields indicating phone number validation results
  }
}

No binary data output is produced by this node.

Dependencies

  • Requires an external API service for phone number validation.
  • Needs an API key credential (referred generically as an API authentication token) with at least:
    • A base URL for the API endpoint.
    • An authorization token.
    • A session identifier.
  • Uses the HTTP POST method to send requests to the /v1/checkNumber endpoint of the API.

Troubleshooting

  • Common issues:

    • Invalid or missing API credentials will cause authentication failures.
    • Network connectivity problems can prevent reaching the API endpoint.
    • Incorrect phone number format may lead to validation errors or unexpected API responses.

  • Error messages:

    • If the API returns an error, the node throws an error including the item index for easier debugging.
    • If continueOnFail is disabled, the node stops execution on the first failure.
    • To handle intermittent API errors gracefully, enable the "Continue On Fail" option in the node settings.

Links and References

  • Refer to your phone number validation API provider's documentation for detailed information on request/response formats and authentication setup.
  • n8n documentation on HTTP Request Node for understanding how API calls are generally made within n8n.

Discussion