WbizTool Send Message

Send WhatsApp messages via WbizTool

Overview

The WbizTool Send Message node enables sending WhatsApp messages through the WbizTool API. It supports sending messages either to individual phone numbers or to WhatsApp groups. Users can send plain text messages, images with optional text, or files with optional text.

This node is useful in scenarios such as:

  • Automating customer notifications via WhatsApp.
  • Sending alerts or updates to a group of users.
  • Sharing media (images or documents) along with messages for marketing or support purposes.

For example, a business could use this node to send order confirmations to customers individually or broadcast promotional images to a WhatsApp group.

Properties

Name Meaning
Target Type Choose whether to send the message to an individual phone number or a WhatsApp group. Options: Phone Number, Group
Phone Number The recipient's WhatsApp phone number including country code (no "+" symbol). Required if Target Type is Phone Number.
Country Code The country code without "+" symbol (e.g., 91 for India, 1 for USA). Required if Target Type is Phone Number.
Group Name The name of the WhatsApp group to send the message to. Required if Target Type is Group.
Message Type Type of message to send. Options: Text (only text), Image with Text, File with Text
Message Text The main message text content to send. Required for all message types.
Image URL URL of the image to send. Required if Message Type is Image with Text.
File URL URL of the file to send. Required if Message Type is File with Text.
File Name Name of the file being sent. Required if Message Type is File with Text.
WhatsApp Client ID (Optional) Overrides the default WhatsApp Client ID from credentials. Leave empty to use default.
Additional Options Collection of extra options:
- Expire After (Seconds): Message expiry time in seconds (0 means no expiry).
- Webhook URL: URL to receive delivery status notifications.

Output

The node outputs an array of JSON objects, each representing the result of sending a message for each input item. Each output object contains:

  • success: Boolean indicating if the message was sent successfully.
  • messageId: The unique identifier of the sent message (if available).
  • status: Status code returned by the API (1 indicates success).
  • message: A descriptive message from the API response.
  • response: The full raw response from the WbizTool API.
  • input: Echoes back key input parameters used for sending the message:
    • targetType: "phone" or "group"
    • target: The phone number with country code or group name
    • messageType: The type of message sent ("0", "1", or "2")
    • message: The message text sent

If the node encounters an error and is configured to continue on failure, it outputs an object with success set to false and an error field describing the issue.

The node does not output binary data.

Dependencies

  • Requires valid credentials for the WbizTool API, including:
    • An API key credential.
    • A client ID credential.
    • Optionally, a WhatsApp Client ID which can be overridden per message.
  • The node makes HTTP POST requests to the WbizTool API endpoints /send_msg/ for phone messages and /send_msg/group/ for group messages.
  • If using webhook delivery status notifications, a publicly accessible webhook URL must be provided.

Troubleshooting

  • Common Issues:

    • Invalid or missing API credentials will cause authentication failures.
    • Incorrect phone number format (missing country code or including "+") may cause message delivery errors.
    • Specifying a group name that does not exist or is misspelled will result in API errors.
    • Missing required fields depending on message type (e.g., missing image URL for image messages) will cause validation errors.
    • Network connectivity issues can prevent the node from reaching the WbizTool API.

  • Error Messages:

    • WbizTool API Error: <message> indicates the API responded with an error. Check the message for details such as invalid parameters or quota limits.
    • Node operation errors typically include the item index to help identify which input caused the failure.

  • Resolutions:

    • Verify and update API credentials in n8n credentials settings.
    • Ensure phone numbers are formatted correctly without "+" and include the correct country code.
    • Double-check group names and URLs for correctness.
    • Provide all required fields based on the selected message type.
    • Use the "Continue On Fail" option to handle errors gracefully when processing multiple items.

Links and References

Discussion