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 send audio messages via WhatsApp. It allows users to send audio media files to specified phone numbers using either URLs or base64-encoded data. This is useful for automating voice message delivery in customer support, marketing campaigns, notifications, or any scenario where sending audio clips through WhatsApp is beneficial.

For example, a business could use this node to automatically send recorded voice instructions or promotional audio clips to customers after they place an order.

Properties

Name Meaning
Phone Number The recipient's WhatsApp number including country code (e.g., 5511999999999).
Media URL The URL or base64 string of the audio file to be sent.
Additional Fields Optional extra settings:
- Reply to Message ID: ID of a message to reply to.
- Delay (seconds): Delay before sending the audio message.
- Disable Link Preview: Option to disable link previews in messages (true/false).
- Mention Users: Comma-separated list of phone numbers to mention in the message.

Output

The node outputs a JSON object containing the response from the WhatsApp API after attempting to send the audio message. This typically includes status information about the message delivery, such as success confirmation or error details.

No binary data output is produced by this operation.

Example output structure (simplified):

{
  "status": "success",
  "messageId": "abc123",
  "details": { ... }
}

If an error occurs and "Continue On Fail" is enabled, the output will contain an error field with the error message.

Dependencies

  • Requires an API key credential for authenticating with the WhatsApp API service.
  • Needs configuration of:
    • API base URL
    • API token for authorization
    • Instance ID representing the WhatsApp instance to use
  • These credentials and parameters must be set up in n8n prior to using the node.

Troubleshooting

  • Common issues:

    • Invalid or missing phone number format (must include country code).
    • Incorrect or inaccessible media URL/base64 data.
    • Authentication failures due to invalid API token or missing credentials.
    • Network connectivity problems reaching the WhatsApp API endpoint.

  • Error messages:

    • "Unknown resource": Indicates the resource parameter is incorrect; ensure "media" is selected.
    • HTTP 401 Unauthorized: Check API token and credentials.
    • HTTP 400 Bad Request: Verify all required fields are correctly filled, especially phone number and media URL.
    • Timeout or network errors: Confirm internet connection and API availability.

  • To resolve errors, verify input properties, credentials, and network access. Enable "Continue On Fail" to handle errors gracefully within workflows.

Links and References

Discussion