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 media messages, specifically images, through WhatsApp. The "Send Image" operation under the "Media" resource allows users to send an image message to a specified WhatsApp number, optionally including a caption and additional message options.

Common scenarios where this node is beneficial include:

  • Sending promotional or informational images to customers.
  • Sharing product photos or event flyers automatically.
  • Delivering visual content in customer support or notification workflows.

For example, a business could automate sending a product image with a caption describing a new offer directly to a customer's WhatsApp number.

Properties

Name Meaning
Phone Number WhatsApp number with country code (e.g., 5511999999999) to which the image will be sent.
Media URL URL or base64 string of the image file to send.
Caption Optional text caption to accompany the image message.
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 WhatsApp API after attempting to send the image message. This typically includes status information about the message delivery, message IDs, or error details if the request failed.

No binary data output is produced by this operation.

Example output structure (simplified):

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

Dependencies

  • Requires an active connection to the premium WhatsApp API service.
  • Needs valid API credentials configured in n8n, including an API key, API token, instance ID, and API URL.
  • The node sends requests via a proxy endpoint that requires an API key credential for authentication.

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 correctly formatted (either a direct URL or base64). If the media cannot be fetched, the message will fail.
  • API Authentication Errors: Verify that all required API credentials are correctly set up and have not expired.
  • Message Delivery Failures: Check if the recipient's WhatsApp account is active and able to receive messages.
  • Delay Field Misuse: If using the delay option, ensure the value is a non-negative number; otherwise, the message might send immediately or cause errors.

Common error messages usually relate to invalid parameters, authentication failures, or network issues. Reviewing the error message returned in the output JSON can guide corrective actions.

Links and References

Discussion