N8N Tools - Uazapi icon

N8N Tools - Uazapi

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

Actions37

Overview

This node integrates with the Uazapi WhatsApp API to retrieve detailed contact information for a specified WhatsApp phone number. It is useful in scenarios where you need to fetch metadata about a contact, such as their profile details or status, directly within an n8n workflow. For example, you might use this node to verify contact details before sending messages or to enrich your CRM data with up-to-date WhatsApp contact info.

Properties

Name Meaning
Phone Number The WhatsApp phone number including country code (e.g., 5511999999999) for which to get info.
Additional Fields Optional extra parameters that can be provided but are not specifically used in this operation.

Output

The node outputs a JSON object containing the response from the Uazapi API's /v1/contacts/info endpoint. This typically includes detailed contact information such as:

  • Contact's WhatsApp profile details
  • Status or presence information
  • Any other metadata returned by the API about the contact

The output is structured as:

{
  "json": {
    // Contact information fields as returned by the API
  },
  "pairedItem": {
    "item": <index_of_input_item>
  }
}

No binary data is produced by this operation.

Dependencies

  • Requires an active Uazapi WhatsApp API account.
  • Needs an API key credential and authentication token configured in n8n credentials for Uazapi.
  • The node uses the instance ID of the WhatsApp instance managed via Uazapi.
  • Network access to the Uazapi endpoints and the proxy service at https://n8ntools.io/api/v1/proxy/uazapi.

Troubleshooting

  • Common issues:

    • Invalid or missing phone number format: Ensure the phone number includes the country code without any symbols or spaces.
    • Authentication errors: Verify that the API key and token credentials are correctly set and have not expired.
    • Instance ID misconfiguration: Confirm the correct WhatsApp instance ID is used.
    • Network connectivity problems: Check if the n8n server can reach the Uazapi endpoints and the proxy URL.

  • Error messages:

    • "Unknown resource: contact": Occurs if the resource parameter is incorrectly set; ensure it is exactly "contact".
    • API authorization errors: Usually indicate invalid or missing credentials; reconfigure the API key and token.
    • Rate limiting or quota exceeded errors: May require checking your Uazapi plan limits.

Links and References

Discussion