Wazzap API icon

Wazzap API

Interact with Wazzap API
Join our community

Actions23

Overview

The node integrates with the Wazzap API to send video messages via WhatsApp. Specifically, the "Send Video" operation under the "Message" resource allows users to send a video file along with a text message to a specified recipient's phone number.

This node is useful in scenarios such as:

  • Automated customer support where video instructions or greetings are sent.
  • Marketing campaigns that include personalized video content.
  • Notifications or alerts that benefit from rich media delivery.

For example, a business can automatically send a welcome video to new customers by providing their phone number, a greeting text, and a URL to the video file.

Properties

Name Meaning
📱 Recipient Phone Number (jid) The full phone number of the recipient, including country code. Example: "+1234567890".
✉️ Text Message (message) The text content to accompany the video message sent to the recipient.
🔗 Video URL (url) A direct URL pointing to the video file to be sent. Must be accessible for download by the API.
🔢 Priority Number (options.priority) Selects which sending number to use: 0 = Default, 999 = Random, 1–5 = Specific number slot.
⏱️ Delay Settings (options.delaySettings) Configures a random delay range before sending the message. Includes:
- Start (MS): minimum delay in milliseconds.
- End (MS): maximum delay in milliseconds.
🔵 Send as Circle Video (options.circle) Boolean flag indicating whether to send the video in a circular (bubble-style) format, similar to stories or status updates. Defaults to true.

Output

The node outputs a JSON array containing the response from the Wazzap API after attempting to send the video message. The exact structure depends on the API but typically includes fields such as message ID, status, timestamps, and any error information if applicable.

No binary data is output by this node; it strictly handles JSON responses related to the message sending operation.

Dependencies

  • Requires an active connection to the Wazzap API service.
  • Needs an API authentication token or key configured in n8n credentials (referred generically as "an API key credential").
  • The video URL must be publicly accessible or accessible by the Wazzap API backend to fetch the video file.

Troubleshooting

  • Common Issues:

    • Invalid or improperly formatted recipient phone number may cause message sending failure.
    • Providing a non-accessible or invalid video URL will result in errors.
    • API authentication failures due to missing or incorrect credentials.
    • Delay settings misconfiguration (e.g., start delay greater than end delay) might cause unexpected behavior.

  • Error Messages:

    • "Unsupported operation." — Occurs if the selected operation-resource combination is not implemented. Verify correct selection.
    • API errors returned from Wazzap (e.g., unauthorized, bad request) should be checked for details in the node’s output.

  • Resolutions:

    • Ensure phone numbers include country codes and are valid.
    • Confirm the video URL is reachable and points directly to a video file.
    • Check and update API credentials in n8n.
    • Validate delay values to ensure start ≤ end.

Links and References

Discussion