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 video messages via WhatsApp. It allows users to send videos to specified phone numbers, optionally including captions and additional message options such as replying to a specific message, delaying the sending, disabling link previews, or mentioning other users.

Common scenarios where this node is beneficial include:

  • Marketing campaigns where personalized video messages are sent to customers.
  • Customer support workflows that require sending instructional or troubleshooting videos.
  • Automated notifications with video content for events, promotions, or updates.

Practical example: A business can automate sending a product demo video to new leads by specifying their WhatsApp number and attaching a caption describing the product features.

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 video file to be sent.
Caption Optional text caption to accompany the video message.
Additional Fields Optional extra settings:
• Reply to Message ID: ID of a message to reply to.
• Delay (seconds): Time delay 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 WhatsApp API after attempting to send the video 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.

Dependencies

  • Requires an active connection to the premium WhatsApp API service.
  • Needs an API key credential and authentication token configured in n8n credentials.
  • The node uses a proxy endpoint hosted at https://n8ntools.io/api/v1/proxy/uazapi to forward requests to the WhatsApp API.
  • Proper instance ID configuration is required to identify the WhatsApp instance used.

Troubleshooting

  • Invalid Phone Number Format: Ensure the phone number includes the country code without any special characters or spaces.
  • Media URL Issues: The media URL must be accessible and point to a valid video file or be a correctly formatted base64 string.
  • 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 has blocked the sender or if the WhatsApp instance is connected and active.
  • Delay Field Misconfiguration: If using delay, ensure the value is a non-negative number; otherwise, the message might not send as expected.

Common error messages usually relate to invalid parameters, authentication failures, or network issues. Reviewing the error message returned in the JSON output helps diagnose the problem.

Links and References

Discussion