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 interactive WhatsApp messages featuring quick reply buttons. It allows users to send a text message accompanied by multiple quick reply buttons that recipients can tap to respond easily. This is particularly useful for automating customer support, surveys, or any scenario where you want to guide the recipient’s response with predefined options.

For example, a business could send a message like "How can we help you today?" with buttons labeled "Order Status", "New Order", and "Speak to Agent". The recipient taps one button, triggering a streamlined interaction flow.

Properties

Name Meaning
Phone Number WhatsApp number of the recipient including country code (e.g., 5511999999999).
Message Text The main text content of the message displayed above the quick reply buttons.
Buttons A collection of quick reply buttons, each with:
- Button Text: The label shown on the button.
- Button ID: A unique identifier for the button used to track which button was pressed.
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: Option to disable link previews in the message.
- Mention Users: Comma-separated phone numbers to mention/tag in the message.

Output

The node outputs a JSON object containing the response from the WhatsApp API after sending the quick reply message. This typically includes details such as message IDs, status, and any metadata returned by the API confirming the message dispatch.

No binary data output is involved in this operation.

Example output structure (simplified):

{
  "messageId": "string",
  "status": "sent",
  "details": { /* additional API response info */ }
}

Dependencies

  • Requires an active connection to the premium WhatsApp API service.
  • Needs an API authentication token and instance identifier configured in the node credentials.
  • The node sends requests through a proxy endpoint hosted at https://n8ntools.io/api/v1/proxy/uazapi.
  • Proper configuration of API keys and tokens in n8n credentials is necessary.

Troubleshooting

  • Common Issues:

    • Invalid phone number format: Ensure the phone number includes the country code without spaces or special characters.
    • Missing or invalid API credentials: Verify that the API key, token, and instance ID are correctly set.
    • Button array empty or improperly formatted: Make sure at least one button with both text and unique ID is provided.
    • Network or proxy errors: Check connectivity to the proxy URL and the WhatsApp API service.

  • Error Messages:

    • "Unknown resource": Occurs if the resource parameter is incorrect; ensure it is set to "message".
    • API authorization errors: Usually indicate invalid or expired tokens; refresh credentials.
    • Validation errors from API: Typically due to missing required fields like phone number or message text; verify all mandatory inputs.

Links and References

This summary focuses exclusively on the "Message" resource with the "Send Quick Reply" operation as requested.

Discussion