Wuzapi AI icon

Wuzapi AI

Send WhatsApp messages using Wuzapi - optimized for AI workflows

Overview

This node enables sending WhatsApp messages through the Wuzapi service, optimized for AI workflows. It supports multiple message types including text, images, documents, audio, video, locations, contacts, stickers, buttons, lists, and polls. The "Send Video" operation specifically allows sending video messages to a specified phone number in international format.

Common scenarios include:

  • Automating customer support by sending multimedia messages.
  • Broadcasting promotional videos or updates.
  • Sharing location or contact information dynamically.
  • Creating interactive messages with buttons, lists, or polls.

For example, you can send a video greeting to a client by providing a video URL or binary data, optionally adding a caption and mentioning specific users in a group chat.

Properties

Name Meaning
Phone Number Recipient's phone number in international format (without +).
Video Source Method to provide the video:
• Binary Data (from previous node)
• Base64 encoded video
• URL to video file
Binary Property Name of the binary property containing the video (used if Video Source is Binary Data).
Base64 Video Base64 encoded video string (H.264 codec, AAC audio), required if Video Source is Base64.
Video URL URL to the video file, required if Video Source is URL.
Caption Optional caption text to accompany the video message.
Additional Options Collection of extra options:
• Message ID: Custom message identifier (auto-generated if empty)
• Mentions: Specify users or all group members to mention in the message

Additional Options - Mentions

  • Mention Type:
    • None: No mentions
    • Specific Users: Mention specific user JIDs (comma-separated)
    • All Group Members: Mention all members in a group chat
  • User JIDs: Comma-separated list of user JIDs to mention (only if Mention Type is Specific Users)

Output

The node outputs an array of JSON objects representing the response from the Wuzapi API for each input item processed. Each output item contains the API response data confirming the message was sent or error details if failed.

If the operation fails and "Continue On Fail" is enabled, the output will contain an error object with the error message for that item.

No binary data is output by this node; it only sends media content.

Dependencies

  • Requires an API key credential for authenticating with the Wuzapi WhatsApp messaging service.
  • The node uses the Wuzapi API endpoints to send messages.
  • No additional environment variables are needed beyond the configured API credential.

Troubleshooting

  • Binary Property Not Found: If using binary data as video source, ensure the specified binary property exists in the input data. Error message: Binary property "<propertyName>" not found.
  • Invalid Phone Number Format: Phone number must be in international format without the "+" prefix.
  • Missing Required Fields: For base64 or URL video sources, the corresponding field must be provided and non-empty.
  • Unknown Operation: If an unsupported operation value is set, the node throws Unknown operation: <operation>.
  • API Request Failures: Network issues or invalid credentials may cause request failures. Check API key validity and network connectivity.
  • Enable "Continue On Fail" to allow processing of subsequent items even if some fail.

Links and References

Discussion