WhatsApp Group Trigger
AI-generatedOverview
The "WhatsApp Group Trigger" node listens for specific WhatsApp group events and triggers a workflow when those events occur. It is designed to integrate with a configured WhatsApp instance that sends event data to the node's webhook URL. This node is useful for automating responses or actions based on group membership changes or participant updates in WhatsApp groups.
Common scenarios include:
- Automatically welcoming new users who join a WhatsApp group.
- Logging or notifying when users leave a group.
- Reacting to changes in group participants, such as role updates or removals.
For example, you could use this node to trigger a message to the group whenever someone joins or leaves, or to update an external database with the current list of group participants.
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 event received from the WhatsApp instance. The structure of the output JSON corresponds directly to the body of the incoming webhook request, which contains details about the triggered group event.
The output is provided as an array with a single element containing the full event data under the json field.
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 user must ensure the WhatsApp instance is set up to POST event data to the webhook path exposed by this node (
whatsapp-group). - No additional API keys or credentials are managed within this node; all authentication and connection setup is handled externally.
Troubleshooting
- No events triggering: Ensure the WhatsApp instance is correctly configured to send events to the webhook URL provided by this node. Verify network connectivity and that the webhook path matches.
- Event not recognized: If an event is received but does not trigger the workflow, check that the event type is included in the selected "Events" property options.
- Empty output: If the webhook receives an event not listed in the "Events" property, the node will return no data and not trigger the workflow.
- Webhook errors: Confirm that the WhatsApp instance sends valid POST requests with the expected JSON payload format.
Links and References
- WhatsApp Business API Documentation
- n8n Webhook Node Documentation
- General guidance on setting up webhooks with WhatsApp instances should be consulted from the WhatsApp provider or service used.