Overview
This node allows scheduling WhatsApp messages for future delivery using the WbizTool service. It supports sending messages either to individual phone numbers or to WhatsApp groups. Users can schedule text messages, images with optional text, or files with optional text to be sent at a specified date and time in a chosen timezone.
Common scenarios include:
- Automating reminders or notifications to customers or team members.
- Scheduling marketing or informational messages to WhatsApp groups.
- Sending documents or images at a planned time without manual intervention.
For example, a business could schedule a promotional message with an image to a group of customers on a specific date and time, or send a file containing a report to an individual contact.
Properties
| Name | Meaning |
|---|---|
| Target Type | Choose whether to schedule the message to an individual phone number or a WhatsApp group. |
| Phone Number | The recipient's WhatsApp phone number with country code (no + symbol). Required if Target Type is "Phone Number". |
| Country Code | Country code without + symbol (e.g., 91 for India, 1 for USA). Required if Target Type is "Phone Number". |
| Group Name | Name of the WhatsApp group. Required if Target Type is "Group". |
| Date | Date to send the message in DD-MM-YYYY format (e.g., 15-01-2024). |
| Time | Time to send the message in HH:MM 24-hour format (e.g., 10:30). |
| Timezone | Timezone for the scheduled message. Options: IST, UTC, EST, PST, GMT, CET. |
| Message Type | Type of message to send. Options: Text, Image with Text, File with Text. |
| Message Text | The message text content to send. |
| 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 | Optionally override the default WhatsApp Client ID from credentials. |
| Additional Options | Collection of extra options; currently supports specifying a Webhook URL for delivery status notifications. |
Output
The node outputs JSON data for each input item indicating the result of the scheduling request:
success: Boolean indicating if the scheduling was successful.scheduledMessageId: Identifier of the scheduled message returned by the API (if available).status: Status code from the API response (1 indicates success).message: Message from the API response describing the result.response: Full raw response from the API.input: Echoes back key input parameters such as target type, recipient, message type, message text, and scheduled time.scheduling: Details about the scheduled date, time, timezone, and combined scheduled time string.
If the node is configured to continue on failure, errors are reported per item with success set to false and an error message.
The node does not output binary data.
Dependencies
- Requires an API key credential for the WbizTool API service.
- Needs network access to the WbizTool API endpoint
/schedule_msg/. - Optional webhook URL can be provided to receive delivery status notifications.
Troubleshooting
- Date Format Error: If the date is not in
DD-MM-YYYYformat, the node throws an error. Ensure the date matches this format exactly. - Time Format Error: If the time is not in
HH:MM24-hour format, an error is thrown. Validate the time input. - Phone Number Validation: Phone numbers must be between 6 and 15 digits after removing non-digit characters. Invalid phone numbers cause errors.
- Country Code Missing: Country code is required when targeting a phone number.
- Group Name Empty: When targeting a group, the group name cannot be empty.
- Missing URLs for Media: For image or file messages, the respective URL and file name (for files) must be provided.
- API Errors: If the WbizTool API returns an error status, the node throws an error with the API message.
- Network Issues: Connectivity problems to the API will cause failures; ensure proper internet access and valid credentials.
To resolve errors, verify all inputs carefully, especially formats and required fields, and check API credentials and network connectivity.
Links and References
- WbizTool Official Website (for API documentation and account setup)
- WhatsApp Business API documentation (general reference for message types and scheduling concepts)