Overview
This node allows sending WhatsApp messages via a SaaS API service. It is designed to send text messages to specified phone numbers using a configured device name registered in the WhatsApp API service. This node is useful for automating WhatsApp communications such as notifications, alerts, or customer engagement messages directly from n8n workflows.
Practical examples include:
- Sending order confirmation messages to customers.
- Notifying team members about system alerts.
- Broadcasting promotional messages to a list of contacts.
Properties
| Name | Meaning |
|---|---|
| Device Name | The identifier of the device configured in your WhatsApp API that will send the message. |
| Phone Number | The recipient's phone number in international format (e.g., +5511999999999). |
| Message | The text content of the WhatsApp message to be sent. |
Output
The node outputs an array of JSON objects, each representing the response from the WhatsApp API for each message sent. The JSON output contains the API response data confirming the message delivery status or any error information returned by the service.
No binary data is produced by this node.
Dependencies
- Requires an API key credential for authenticating with the WhatsApp SaaS API service.
- The node makes HTTP POST requests to the endpoint
https://app.supersimplewhats.com/v1/messages/send/{deviceName}/{phoneNumber}. - Proper configuration of the device name in the external WhatsApp API service is necessary.
- Network access to the WhatsApp SaaS API endpoint must be available.
Troubleshooting
- Invalid Device Name: If the device name is incorrect or not registered, the API will likely return an error. Verify the device name matches the one configured in the WhatsApp API service.
- Incorrect Phone Number Format: Ensure the phone number includes the country code and is formatted correctly (e.g., +5511999999999).
- Authentication Errors: Missing or invalid API credentials will cause authentication failures. Confirm the API key credential is set up properly in n8n.
- API Rate Limits or Service Downtime: If messages fail intermittently, check for rate limiting or service availability issues on the WhatsApp SaaS API side.
- Error Messages: The node returns the raw API response in the output JSON; inspect this for detailed error descriptions to guide troubleshooting.
Links and References
- WhatsApp Business API Documentation
- SSW WhatsApp SaaS API - Official Site (for device setup and API details)