Overview
This node integrates with a WhatsApp Web API service to send messages programmatically. Specifically, the Chatting - SendText operation allows users to send plain text messages to a specified WhatsApp chat ID. This is useful for automating notifications, alerts, or conversational interactions within WhatsApp.
Common scenarios include:
- Sending automated reminders or updates to customers.
- Broadcasting messages to specific groups or individuals.
- Integrating WhatsApp messaging into workflows such as support ticketing or order confirmations.
Example: Automatically sending a "Your appointment is confirmed" message to a client’s WhatsApp number after booking.
Properties
| Name | Meaning |
|---|---|
| Chat ID | The unique identifier of the WhatsApp chat to which the text message will be sent. |
| Text | The content of the text message to send. |
Output
The node outputs JSON data representing the response from the WhatsApp Web API after sending the message. This typically includes details about the sent message such as message ID, status, timestamps, or any error information returned by the API.
No binary data output is produced for this operation.
Dependencies
- Requires an active connection to a WhatsApp Web API service endpoint.
- Needs an API key credential configured in n8n to authenticate requests.
- The node uses the session identifier from credentials to target the correct WhatsApp session.
- The API URL and session are provided via credentials and used to construct request URIs.
Troubleshooting
- Invalid Chat ID: If the chat ID format is incorrect or the chat does not exist, the API may return an error. Verify the chat ID matches the expected format (e.g.,
xxxxxxx@c.us). - Authentication Errors: Ensure the API key credential is valid and the session is active. Authentication failures will prevent message sending.
- API Endpoint Issues: Network problems or incorrect base URL configuration can cause request failures. Confirm the API URL in credentials is reachable.
- Empty Text: Sending an empty text string may result in an error or no message being sent. Always provide non-empty text content.
Links and References
- WhatsApp Business API Documentation
- n8n HTTP Request Node Documentation
- WhatsApp WebJS GitHub Repository (for underlying API inspiration)