Overview
This node acts as a trigger for WhatsApp group-related events. It listens for specific group events sent via a webhook from a configured WhatsApp instance (either session-based or server-based). When one of the selected group events occurs, the node activates and outputs the event data.
Common scenarios where this node is useful include:
- Automating workflows based on group membership changes, such as welcoming new members or logging when users leave.
- Monitoring group participant updates to maintain synchronized records or trigger notifications.
- Integrating WhatsApp group activity with other systems like CRMs, support desks, or analytics platforms.
For example, you could use this node to automatically send a welcome message whenever a user joins a WhatsApp group or to update a database when participants change.
Properties
| Name | Meaning |
|---|---|
| Remember to configure WhatsApp instance (session or server) to send events to Webhook URL | Informational notice reminding to set up the WhatsApp instance to forward events to this node's webhook URL. |
| Events | The WhatsApp group events to listen for. Options: - Group Join: User joined group - Group Leave: User left group - Group Participants Update: Group participants updated |
Output
The node outputs JSON data representing the WhatsApp group event received. The structure corresponds directly to the webhook payload sent by the WhatsApp instance and includes details about the event type and associated data.
The output JSON is wrapped in an array under the workflowData key, suitable for further processing in n8n workflows.
No binary data output is produced by this node.
Dependencies
- Requires a properly configured WhatsApp instance (either session-based or server-based) that can send group event notifications to the node’s webhook URL.
- The webhook URL must be publicly accessible so that the WhatsApp instance can POST event data.
- No additional external services or API keys are required within the node itself.
Troubleshooting
- No events triggering: Ensure the WhatsApp instance is correctly configured to send group event webhooks to the node’s webhook URL.
- Webhook not reachable: Verify that the webhook URL is publicly accessible and that no firewall or network restrictions block incoming requests.
- Selected events not firing: Confirm that the events you want to listen for are enabled both in the node configuration and supported by your WhatsApp instance.
- Empty output: If the node receives an event not included in the selected "Events" property, it will ignore it and produce no output.
Links and References
- WhatsApp Business API Documentation
- n8n Webhook Node Documentation
- WhatsApp Group Event Types Overview (for reference on event payloads)