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 manage webhook configurations for a WhatsApp instance. Specifically, the Set Webhook operation allows users to configure a URL where WhatsApp event notifications (such as incoming messages or status updates) will be sent via webhooks.

Common scenarios include:

  • Setting up a webhook URL to receive real-time WhatsApp message events and automate responses.
  • Integrating WhatsApp messaging events into other systems like CRMs, helpdesks, or analytics platforms.
  • Automating workflows triggered by WhatsApp interactions without polling the API.

Example use case:

  • A business wants to automatically log all incoming WhatsApp messages into their CRM system. They set the webhook URL to point to an endpoint that processes these events and creates CRM records accordingly.

Properties

Name Meaning
Webhook URL The URL endpoint where WhatsApp webhook events will be sent.
Additional Fields Optional extra settings:
• Reply to Message ID — ID of a message to reply to.
• Delay (seconds) — Delay before sending a message.
• Disable Link Preview — Whether to disable link previews in messages.
• Mention Users — Comma-separated phone numbers to mention in messages.

Output

The node outputs a JSON object representing the response from the Uazapi API after setting the webhook. This typically includes confirmation details about the webhook configuration.

The output structure is:

{
  "json": {
    // Response data from Uazapi API about the webhook setup
  },
  "pairedItem": {
    "item": <index_of_input_item>
  }
}

No binary data is produced by this operation.

Dependencies

  • Requires an active Uazapi WhatsApp API account with valid credentials including:

    • An API key credential.
    • API token.
    • Instance identifier.
    • Base API URL.

  • The node uses these credentials to authenticate requests to the Uazapi service.

  • No additional environment variables are required beyond the configured credentials.

Troubleshooting

  • Common issues:

    • Invalid or unreachable webhook URL: Ensure the URL is publicly accessible and correctly formatted.
    • Authentication errors: Verify that the API key, token, and instance ID are correct and have necessary permissions.
    • Network connectivity problems: Confirm that n8n can reach the Uazapi API endpoints and the webhook URL server.

  • Error messages:

    • Errors returned from the Uazapi API will be included in the node output if "Continue On Fail" is enabled.
    • Typical error messages may indicate invalid parameters, unauthorized access, or server errors.
    • To resolve, check credentials, input parameters, and network accessibility.

Links and References

Discussion