Overview
This node is a trigger that activates when the status of a WhatsApp session changes. It listens for specific session events such as connection or disconnection updates and triggers workflows accordingly. This is useful in scenarios where you want to automate actions based on the state of a WhatsApp session, for example, sending notifications when the session connects or disconnects, or logging session status changes for monitoring purposes.
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 forward events to this webhook. |
| Events | The types of session events to listen for. Options: "Session Status" (updates like connected, disconnected, etc.) |
Output
The node outputs JSON data representing the event received from the WhatsApp session. The output contains the full body of the webhook request under the json field. This typically includes details about the session event such as its type and current status.
No binary data output is produced by this node.
Dependencies
- Requires a configured WhatsApp instance (either session-based or server-based) that sends session event updates to the webhook URL exposed by this node.
- No additional external services or API keys are required within the node itself.
- Proper webhook URL configuration in the WhatsApp instance is essential for receiving events.
Troubleshooting
Common Issue: No workflow trigger occurs despite WhatsApp session changes.
- Cause: The WhatsApp instance may not be correctly configured to send events to the webhook URL.
- Resolution: Verify that the WhatsApp instance is set up to forward session events to the webhook path provided by this node.
Common Error: Workflow does not receive expected event data.
- Cause: The selected event types in the node properties do not include the incoming event.
- Resolution: Ensure the "Events" property includes the relevant session event types you want to listen for.