Overview
This node allows sending WhatsApp messages to groups using the WbizTool service. It supports sending plain text messages, images with optional text, and files with optional text to a specified WhatsApp group. This is useful for automating group communications such as announcements, alerts, or sharing media/files within team or community WhatsApp groups.
Practical examples include:
- Sending daily status updates or reminders to a project group.
- Sharing promotional images or flyers with a marketing group.
- Distributing important documents or PDFs to a client or partner group.
Properties
| Name | Meaning |
|---|---|
| Group Name | The name of the WhatsApp group to which the message will be sent. |
| Message Type | Type of message to send: - Text (only text message) - Image with Text - File with Text |
| Message Text | The main text content of the message to send to the group. |
| Image URL | (Required if Message Type is "Image with Text") URL of the image to send. |
| File URL | (Required if Message Type is "File with Text") URL of the file to send. |
| File Name | (Required if Message Type is "File with Text") Name of the file being sent. |
| WhatsApp Client ID | Optional override for the default WhatsApp Client ID from credentials. |
| Additional Options | Collection of optional settings: - 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 JSON contains:
success: Boolean indicating if the message was sent successfully.messageId: The ID of the sent message (if available).status: Status code returned by the API (1 indicates success).message: Response message from the API.response: Full raw response from the WbizTool API.input: Echoes back the input parameters used for sending the message, including target type ("group"), target group name, message type, and message text.- In case of failure,
errorfield contains the error message.
No binary data output is produced by this node.
Dependencies
- Requires valid credentials for the WbizTool API, including an API key and client ID.
- The node uses the WbizTool API endpoint
/send_msg/group/to send messages. - Optional webhook URL can be configured to receive delivery status callbacks.
- No additional external dependencies beyond the WbizTool API and n8n credential setup.
Troubleshooting
- Group name cannot be empty: Ensure the "Group Name" property is filled with a valid group name.
- Image URL is required for image messages: When sending an image message, provide a valid image URL.
- File URL and File Name are required for file messages: Both must be provided when sending a file.
- WbizTool API Error: If the API returns an error status, check the API key and client ID credentials, verify the group name exists, and ensure URLs are accessible.
- Network issues or invalid URLs may cause failures; verify connectivity and URL correctness.
- If the node fails but "Continue On Fail" is enabled, errors will be reported per item without stopping the workflow.
Links and References
- WbizTool Official Website (for API documentation and account setup)
- WhatsApp Business API Documentation (general reference on WhatsApp messaging concepts)