N8N Tools - Uazapi icon

N8N Tools - Uazapi

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

Actions37

Overview

This node enables sending a location message via WhatsApp using the Uazapi premium WhatsApp API integration. It is designed to send geographic coordinates (latitude and longitude) along with an optional location name to a specified WhatsApp number.

Common scenarios where this node is beneficial include:

  • Sharing meeting points or event locations with customers or team members.
  • Sending delivery or pickup locations in customer service workflows.
  • Automating location sharing in logistics or field service operations.

For example, a business can automatically send a customer's order pickup location after confirming the order, improving communication efficiency.

Properties

Name Meaning
Phone Number The recipient's WhatsApp number including country code (e.g., 5511999999999).
Latitude The latitude coordinate of the location to send.
Longitude The longitude coordinate of the location to send.
Location Name Optional name or label for the location (e.g., "Main Office", "Event Venue").
Additional Fields Optional extra settings:
• Reply to Message ID: ID of a message to reply to.
• Delay (seconds): Wait time before sending.
• Disable Link Preview: Whether to disable link previews.
• Mention Users: Comma-separated phone numbers to mention in the message.

Output

The node outputs a JSON object containing the response from the Uazapi WhatsApp API after attempting to send the location message. This typically includes status information about the message delivery.

Example output structure (simplified):

{
  "status": "success",
  "messageId": "string",
  "details": { /* additional info from API */ }
}

No binary data is produced by this operation.

Dependencies

  • Requires an active Uazapi WhatsApp API account with valid credentials:
    • An API key credential.
    • API token.
    • Instance identifier.
  • The node uses these credentials to authenticate requests to the Uazapi API endpoint.
  • Proper configuration of these credentials in n8n is necessary for successful operation.

Troubleshooting

  • Common issues:

    • Invalid or missing phone number format: Ensure the phone number includes the country code without symbols or spaces.
    • Incorrect latitude/longitude values: Coordinates must be valid decimal numbers within their respective ranges.
    • Authentication errors: Verify that API key, token, and instance ID are correctly configured.
    • Network or API endpoint issues: Check internet connectivity and Uazapi service status.

  • Error messages:

    • "Unknown resource": Indicates an unsupported resource was selected; ensure "Message" resource is chosen.
    • API authorization errors: Usually due to invalid credentials; recheck API key and tokens.
    • Validation errors from API: Often caused by missing required fields or invalid data formats; review input properties carefully.

If the node is set to continue on failure, errors will be returned in the output JSON under an error field.

Links and References

Discussion