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 send and manage WhatsApp messages. Specifically, the Message - Send Text operation allows users to send plain text messages to WhatsApp numbers programmatically. This is useful for automating customer notifications, alerts, reminders, or any scenario where sending a direct text message via WhatsApp is beneficial.

For example, a business can use this node to automatically send order confirmations or appointment reminders to customers' WhatsApp numbers without manual intervention.

Properties

Name Meaning
Phone Number The recipient's WhatsApp number including country code (e.g., 5511999999999).
Message Text The text content of the message to be sent.
Additional Fields Optional extra settings:
- Reply to Message ID: ID of a message to reply to (for threaded conversations).
- Delay (seconds): Time delay before sending the message.
- Disable Link Preview: Whether to disable link previews in the message (true/false).
- Mention Users: Comma-separated phone numbers to mention/tag in the message.

Output

The node outputs a JSON object containing the response from the Uazapi WhatsApp API after attempting to send the text message. This typically includes status information about the message delivery, message IDs, timestamps, or error details if the request failed.

No binary data output is produced by this operation.

Example output structure (simplified):

{
  "status": "success",
  "messageId": "abc123def456",
  "timestamp": "2024-06-01T12:00:00Z"
}

If an error occurs, the output JSON will contain an error field describing the issue.

Dependencies

  • Requires an active Uazapi WhatsApp API account.
  • Needs configuration of credentials including:
    • An API key credential for authentication.
    • API URL endpoint.
    • API token.
    • Instance ID representing the WhatsApp instance.
  • The node uses an internal proxy service (https://n8ntools.io/api/v1/proxy/uazapi) to forward requests to the Uazapi API.

Troubleshooting

  • Common Issues:

    • Invalid or missing phone number format: Ensure the phone number includes the country code without spaces or symbols.
    • Authentication errors: Verify that the API key, token, and instance ID are correctly configured.
    • Network or proxy issues: Confirm connectivity to the proxy URL and that no firewall blocks the requests.
    • Rate limits or quota exceeded on the Uazapi service.

  • Error Messages:

    • "Unknown resource": Indicates an invalid resource parameter; ensure "message" is selected.
    • API response errors will be passed through in the output JSON under the error field.
    • If the node is set to continue on fail, errors will not stop execution but will be reported per item.

Links and References

Discussion