WhatsApp Chat Trigger
AI-generatedOverview
This node triggers workflows in n8n when specific WhatsApp chat events occur. It listens for events such as chat archiving, unarchiving, and deletion sent to a configured webhook URL. This is useful for automating responses or actions based on changes in WhatsApp chats, such as logging chat activity, notifying teams about chat status changes, or syncing chat states with other systems.
Practical examples:
- Automatically log archived chats into a CRM system.
- Notify support staff when a chat is deleted.
- Trigger follow-up workflows when a chat is unarchived.
Properties
| Name | Meaning |
|---|---|
| Remember to configure WhatsApp instance (session or server) to send events to Webhook URL | Informational notice reminding users to set up their WhatsApp instance to send events to the webhook URL configured in this node. |
| Events | The WhatsApp chat events to listen for. Options: Chat Archive, Chat Unarchive, Chat Delete. Users can select one or multiple events to trigger the workflow. |
Output
The node outputs JSON data representing the event payload received from WhatsApp. The output structure contains the full body of the webhook request under the json field. This includes details about the chat event that triggered the workflow.
If the incoming event type matches one of the selected events, the node returns an array with a single JSON object containing the entire webhook body.
No binary data output is produced by this node.
Dependencies
- Requires a properly configured WhatsApp instance (either session-based or server-based) that sends chat event notifications to the webhook URL exposed by this node.
- No external API keys or credentials are handled directly by this node; however, the WhatsApp instance must be authenticated and authorized to send events.
- The webhook path is fixed as
/whatsapp-chatand expects POST requests.
Troubleshooting
- No workflow trigger despite events occurring: Ensure the WhatsApp instance is correctly configured to send events to the webhook URL provided by this node.
- Workflow triggers but no data received: Verify that the selected events in the node properties match the events being sent by WhatsApp.
- Webhook URL not reachable: Confirm that your n8n instance is accessible from the WhatsApp server or session environment.
- Unexpected errors or empty outputs: Check the webhook request payload format matches expected structure; any deviation might cause the node to ignore the event.