Overview
This node integrates with the Evolution API to send WhatsApp messages through AI agents. It supports sending plain text messages, media messages, and retrieving QR codes for WhatsApp instances. The primary use case is automating WhatsApp communication by sending messages programmatically from n8n workflows.
A common scenario would be sending notifications, alerts, or customer support messages via WhatsApp automatically. For example, after a form submission, the node can send a confirmation message to the user's WhatsApp number.
Properties
| Name | Meaning |
|---|---|
| Instance | The name of the WhatsApp instance to use for sending the message. |
| Phone Number | The recipient's phone number including country code (e.g., 5511999999999). |
| Message | The text content of the message to be sent. |
Output
The node outputs an array of JSON objects, each representing the result of sending a message or performing the selected operation. Each object contains:
success: Boolean indicating if the operation was successful.result: The raw response data returned from the Evolution API.message: A human-readable status message confirming the action, e.g., "Message sent successfully to [phone number]".
If the operation fails and "Continue On Fail" is enabled, the output will include an object with success: false and an error message describing the failure.
Dependencies
- Requires an active Evolution API account with valid credentials (API URL and API key).
- The node needs these credentials configured in n8n to authenticate requests.
- Uses the Axios HTTP client internally to make REST API calls to the Evolution API endpoints.
Troubleshooting
Common issues:
- Invalid or missing API credentials will cause authentication failures.
- Incorrect instance names or phone numbers may lead to errors from the API.
- Network connectivity problems can prevent successful API calls.
Error messages:
"The operation \"[operation]\" is not supported!"indicates an unsupported operation was requested.- API error responses are passed through in the
errorfield when "Continue On Fail" is enabled.
Resolutions:
- Verify that the API key and URL are correctly set in the credentials.
- Ensure the WhatsApp instance name matches one registered in the Evolution API.
- Confirm phone numbers include the correct country code and format.
- Check network access and firewall settings to allow outbound HTTPS requests.
Links and References
- Evolution API official documentation (for WhatsApp messaging): [Not provided in source]
- Axios HTTP client: https://axios-http.com/
- n8n documentation on credentials and error handling: https://docs.n8n.io/