Evolution API icon

Evolution API

Complete WhatsApp automation with Evolution API
Join our community

Actions48

Overview

The "Check Number" operation of the Contact resource in this node allows you to verify if a given phone number is registered on WhatsApp. This is useful for workflows that need to validate contacts before sending messages or performing other actions, ensuring that the target number is active on WhatsApp.

Practical examples include:

  • Validating customer phone numbers before sending marketing messages.
  • Filtering contact lists to only include WhatsApp users.
  • Automating support workflows by confirming user availability on WhatsApp.

Properties

Name Meaning
Phone Number The phone number with country code (without the "+" sign) to check on WhatsApp.
Additional Fields Optional extra parameters:
• Delay: Delay in milliseconds before sending.
• Link Preview: Enable or disable link preview.
• Quoted Message ID: ID of message to quote/reply to.
• Mentions: Comma-separated list of numbers to mention.

Output

The output JSON contains the response from the API indicating whether the specified phone number is registered on WhatsApp. It typically includes details about the number's status on WhatsApp.

Example structure (simplified):

{
  "numbers": [
    {
      "number": "5511999999999",
      "exists": true,
      "status": "valid"
    }
  ]
}

This confirms if the number exists on WhatsApp (exists: true) and may provide additional metadata.

No binary data is output by this operation.

Dependencies

  • Requires an API key credential for the Evolution API service.
  • Optionally uses another API key credential for an auxiliary validation service ("N8N Tools API") to verify subscription and API key validity before making requests.
  • The node expects configuration of instance name and base URL for the Evolution API.
  • Network access to the Evolution API endpoints is required.

Troubleshooting

  • Invalid Subscription or API Key: If the auxiliary validation fails with HTTP 401 or 403, it indicates invalid or expired API keys. Verify and update your credentials.
  • Unknown Operation or Resource Errors: These occur if unsupported operations or resources are selected. Ensure the operation is set to "Check Number" under the "Contact" resource.
  • Network or Request Failures: Check network connectivity and API endpoint accessibility.
  • Empty or Incorrect Phone Number: Make sure the phone number is provided in the correct format (country code without "+").

Links and References

Discussion