WbizTool Send Multi Message

Send bulk WhatsApp messages to multiple recipients via WbizTool

Overview

This node, WbizTool Send Multi Message, enables sending bulk WhatsApp messages to multiple recipients simultaneously using the WbizTool API. It supports sending plain text messages, images with optional text, and files with optional text to a list of phone numbers. This is particularly useful for businesses or services that need to broadcast notifications, promotions, alerts, or documents to many customers or contacts efficiently.

Practical examples:

  • Sending promotional text messages to a customer list.
  • Sharing product images along with descriptions to multiple clients.
  • Distributing important PDF documents or other files to a group of users.

Properties

Name Meaning
Phone Numbers Comma-separated list of recipient phone numbers including country code (without + symbol).
Country Code The country dialing code without the + symbol (e.g., 91 for India, 1 for USA).
Message Type Type of message to send:
- Text
- Image with Text
- File with Text
Message Text The main message text content to send to all recipients.
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 override for the default WhatsApp Client ID from credentials. Leave empty to use default.
Additional Options Collection of extra options:
- Webhook URL: URL to receive delivery status notifications.

Output

The node outputs an array of JSON objects, each corresponding to one input item processed. Each output JSON contains:

  • success: Boolean indicating if the message was sent successfully.
  • status: Numeric status code returned by the WbizTool API (1 indicates success).
  • message: Status message from the API.
  • response: Full raw response from the WbizTool API.
  • input: Details about the request made:
    • targetType: Always "multi" indicating bulk sending.
    • phoneCount: Number of phone numbers targeted.
    • phoneNumbers: Array of cleaned phone numbers.
    • countryCode: The country code used.
    • messageType: Type of message sent.
    • message: The message text sent.
  • statistics: Summary statistics such as total recipients.

If the node encounters an error and is set to continue on failure, it outputs:

  • success: false
  • error: Error message describing what went wrong.

The node does not output binary data.

Dependencies

  • Requires valid credentials for the WbizTool API, including an API key and client ID.
  • Needs network access to the WbizTool API endpoint /send_msg/multi/.
  • Optionally, a webhook URL can be provided to receive delivery status callbacks.
  • No additional external libraries beyond those bundled with n8n are required.

Troubleshooting

  • Empty or invalid phone numbers: The node throws an error if the phone numbers field is empty or no valid numbers are found after splitting and trimming.
  • Missing country code: The country code must be provided and contain only digits; otherwise, an error is thrown.
  • Missing required fields for message types:
    • For image messages, the Image URL must be provided.
    • For file messages, both File URL and File Name must be provided.
  • API errors: If the WbizTool API returns a status other than 1, the node throws an error with the API's message.
  • Credential issues: Ensure the API key and client ID are correctly configured in the credentials.
  • Network issues: Connectivity problems to the WbizTool API will cause failures.
  • To handle errors gracefully, enable "Continue On Fail" in the node settings.

Links and References

Discussion