Wuzapi AI icon

Wuzapi AI

Send WhatsApp messages using Wuzapi - optimized for AI workflows

Actions11

Overview

This node, named "Wuzapi AI," enables sending various types of WhatsApp messages through the Wuzapi service. It supports text, images, documents, audio, video, locations, contacts, stickers, buttons, lists, and polls. The node is optimized for AI workflows but can be used in any scenario where automated WhatsApp messaging is needed.

Common use cases include:

  • Sending notifications or alerts via WhatsApp.
  • Delivering multimedia content such as images, videos, or documents to users.
  • Conducting interactive communication using buttons, lists, or polls.
  • Sharing location or contact information automatically.
  • Mentioning specific users or all group members in group chats.

For example, a business could use this node to send personalized promotional messages with images and buttons to customers, or a support system could send location details and contact cards to clients.

Properties

Name Meaning
Phone Number The recipient's phone number in international format without the "+" sign (e.g., 5491155553934).
Message The text message content to send (used in "Send Text" and "Send Buttons" operations).
Additional Options Optional settings including:
- Message ID: Custom identifier for the message (auto-generated if omitted).
- Mentions: Specify users to mention or mention all group members (groups only).

Additional options details (under "Additional Options")

Name Meaning
Message ID Custom message identifier to track or reference the message.
Mentions Configuration to mention specific users by their JIDs or all group members in group chats.
- Mention Type Options: None (no mentions), Specific Users (mention given JIDs), All Group Members (mention everyone).
- User JIDs Comma-separated list of user JIDs to mention when "Specific Users" is selected.

Note: The node supports many other properties depending on the operation chosen (e.g., image source, captions, file names, poll questions/options), but these are outside the scope of the "Send Text" operation.

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 under the json field.

If an error occurs and "Continue On Fail" is enabled, the output will contain an object with an error field describing the issue.

No binary data is output by the "Send Text" operation.

Example output JSON structure:

{
  "json": {
    // Response fields from Wuzapi API after sending the message
  }
}

Dependencies

  • Requires an API key credential for authenticating with the Wuzapi service.
  • The node uses the Wuzapi API endpoints to send WhatsApp messages.
  • No additional environment variables are explicitly required beyond the API credential.
  • The node depends on a helper function to prepare media data for non-text messages (not relevant for "Send Text").

Troubleshooting

  • Error: Binary property "X" not found
    This error appears if a binary property expected for media messages is missing. Not applicable for "Send Text" but relevant for media operations.

  • Unknown operation: X
    Indicates an unsupported or misspelled operation name. Ensure the operation parameter is set correctly.

  • Invalid phone number format
    The phone number must be in international format without the "+" prefix. Verify the input matches this requirement.

  • API request failures
    Network issues or invalid API credentials may cause errors. Check the API key configuration and network connectivity.

  • If "Continue On Fail" is enabled, errors for individual items will be returned in the output JSON under an error field instead of stopping execution.

Links and References

Discussion