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 contact information via WhatsApp messages. Specifically, the Send Contact operation under the Contact resource allows users to send a contact's phone number to a specified WhatsApp recipient.

Common scenarios where this node is beneficial include:

  • Sharing a colleague’s or customer’s contact details automatically during a support or sales workflow.
  • Sending emergency contact numbers in automated alerts.
  • Distributing business contacts or client representatives’ numbers as part of a communication sequence.

For example, you can configure the node to send a contact card containing a phone number to a user’s WhatsApp by specifying the recipient’s WhatsApp number and the contact number to share.

Properties

Name Meaning
Phone Number The recipient's WhatsApp number including country code (e.g., 5511999999999).
Additional Fields Optional settings to customize the message:
- Reply to Message ID ID of a message to which this contact message will reply.
- Delay (seconds) Delay before sending the contact message.
- Disable Link Preview Option to disable link previews in the message.
- Mention Users Comma-separated list of phone numbers to mention in the message.

Output

The node outputs a JSON object representing the response from the WhatsApp API after attempting to send the contact message. This typically includes status information about the message delivery, any message IDs generated, and error details if the request failed.

No binary data output is produced by this operation.

Example output structure (simplified):

{
  "status": "success",
  "messageId": "abc123def456",
  "details": {
    "sentTo": "5511999999999",
    "contactSent": "5511888888888"
  }
}

Dependencies

  • Requires an active connection to the premium WhatsApp API service.
  • Needs an API key credential and authentication token configured within n8n credentials for this WhatsApp API.
  • The node uses an instance identifier to specify which WhatsApp instance to use.
  • Network access to the WhatsApp API endpoint is necessary.

Troubleshooting

  • Invalid Phone Number Format: Ensure that phone numbers include the country code without any special characters or spaces.
  • Authentication Errors: Verify that the API key and token credentials are correctly set up and have not expired.
  • Message Delivery Failures: Check if the recipient’s WhatsApp number is valid and registered on WhatsApp.
  • Delay Not Working: If using the delay field, confirm it is a non-negative number.
  • Mention Users Field: When mentioning users, ensure phone numbers are comma-separated and properly formatted.

Common error messages may include:

  • "Unauthorized": Indicates invalid or missing API credentials.
  • "Invalid number format": The phone number does not meet WhatsApp API requirements.
  • "Instance not found": The specified WhatsApp instance ID is incorrect or inactive.

Resolving these usually involves verifying credentials, input formats, and instance configuration.

Links and References

Discussion