N8N Tools - Uazapi icon

N8N Tools - Uazapi

Complete Uazapi integration - Premium WhatsApp API with advanced messaging and automation

Actions37

Overview

This node integrates with a premium WhatsApp API service to perform various operations related to WhatsApp contacts, messages, media, groups, instance management, and webhooks. Specifically, for the Contact resource with the Check Number operation, it checks whether a given phone number is registered on WhatsApp.

This functionality is useful in scenarios where you want to verify if a phone number is active on WhatsApp before attempting to send messages or add contacts. For example, businesses can use this to validate customer numbers before launching marketing campaigns or automating customer support workflows.

Properties

Name Meaning
Phone Number The WhatsApp phone number including country code (e.g., 5511999999999) to check existence.
Additional Fields Optional extra parameters:
- Reply to Message ID: ID of message to reply to
- Delay (seconds): Delay before sending message
- Disable Link Preview: Whether to disable link previews in messages
- Mention Users: Comma-separated phone numbers to mention

Output

The output JSON contains the response from the WhatsApp API indicating whether the specified phone number exists on WhatsApp. The exact structure depends on the API but typically includes fields such as:

  • Confirmation of number existence
  • Possibly additional metadata about the contact status

No binary data is output by this operation.

Dependencies

  • Requires an API key credential for the WhatsApp API service.
  • Needs configuration of:
    • API base URL
    • API token for authorization
    • Instance identifier for the WhatsApp session

These credentials and configurations must be set up in n8n prior to using the node.

Troubleshooting

  • Common Issues:

    • Invalid or missing phone number format (must include country code).
    • API authentication failures due to incorrect or expired tokens.
    • Network connectivity issues preventing access to the WhatsApp API endpoint.

  • Error Messages:

    • Errors returned from the API will be included in the output JSON under an error field if "Continue On Fail" is enabled.
    • Typical errors include unauthorized access, invalid parameters, or rate limiting.

  • Resolutions:

    • Verify phone number formatting.
    • Check and update API credentials.
    • Ensure network access to the API endpoint.
    • Enable "Continue On Fail" to handle errors gracefully in workflows.

Links and References

Discussion