Actions37
- Message Actions
- Media Actions
- Contact Actions
- Group Actions
- Instance Actions
- Webhook Actions
Overview
This node integrates with a premium WhatsApp API service to send and manage WhatsApp messages programmatically. Specifically, the Send Text operation under the Message resource allows users to send plain text messages to WhatsApp numbers.
Common scenarios where this node is beneficial include:
- Automating customer support or notifications by sending personalized text messages.
- Sending alerts or reminders to users via WhatsApp.
- Integrating WhatsApp messaging into workflows for marketing campaigns or transactional messages.
For example, a business could use this node to automatically send order confirmations or appointment reminders directly to customers' WhatsApp numbers.
Properties
| Name | Meaning |
|---|---|
| Phone Number | The recipient's WhatsApp number including country code (e.g., 5511999999999). |
| Message Text | The text content of the message to be sent. |
| Additional Fields | Optional extra settings: • Reply to Message ID — ID of a message to reply to. • Delay (seconds) — Wait time before sending. • Disable Link Preview — Whether to disable link previews in the message. • Mention Users — Comma-separated phone numbers to mention in the message. |
Output
The node outputs a JSON object containing the response from the WhatsApp API after attempting to send the text message. This typically includes details such as message status, IDs, timestamps, or error information if the request failed.
No binary data output is produced by this operation.
Example output structure (simplified):
{
"status": "success",
"messageId": "abc123",
"timestamp": "2024-06-01T12:00:00Z"
}
Or in case of failure:
{
"error": "Invalid phone number format"
}
Dependencies
- Requires an active connection to the premium WhatsApp API service.
- Needs configuration of API credentials including an API key, API token, instance ID, and base URL within n8n credentials.
- The node sends requests through a proxy endpoint provided by the integration service.
Troubleshooting
- Invalid Phone Number Format: Ensure the phone number includes the correct country code without spaces or special characters.
- Authentication Errors: Verify that the API key, token, and instance ID are correctly configured and valid.
- Message Not Sent / Delays: Check if a delay was set in additional fields; also confirm network connectivity and API service status.
- Link Preview Not Disabled: If links still show previews despite disabling, verify the boolean flag is set correctly.
- Mention Users Not Working: Confirm mentioned phone numbers are formatted properly and separated by commas.
If errors occur, the node returns error messages in the output JSON, which can help diagnose issues.
Links and References
- WhatsApp Business API Documentation
- n8n Documentation on Creating Custom Nodes
- Uazapi Service Website (replace with actual URL if available)