Overview
This node is a trigger for WhatsApp message events using the WAHA integration. It listens for specific WhatsApp message-related events sent to a configured webhook URL and triggers workflows when those events occur. This is useful for automating responses, logging messages, or reacting to user interactions on WhatsApp in real-time.
Common scenarios include:
- Automatically processing incoming WhatsApp messages.
- Tracking message reactions or deletions.
- Integrating WhatsApp conversations into CRM or support systems.
For example, you could use this node to start a workflow whenever a new WhatsApp message arrives, enabling automated replies or notifications.
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 the webhook URL of this node. |
| Events | The types of WhatsApp message events to listen for. Options: - Message: New message received - Message Any: Any message event - Message Reaction: Message reaction events - Message Revoked: Message revoked/deleted events |
| Events Handled | Informational notice displayed when any of the above events are selected, indicating which events are handled by the node. |
Output
The node outputs JSON data representing the WhatsApp event payload received via the webhook. The output structure corresponds directly to the body of the incoming webhook request, containing detailed information about the WhatsApp message event such as message content, sender, timestamp, and event type.
If multiple events are enabled, the output will contain the event data only if it matches one of the selected event types.
No binary data output is produced by this node.
Dependencies
- Requires a properly configured WhatsApp instance (either session-based or server-based) that sends message events to the webhook URL exposed by this node.
- The webhook URL must be publicly accessible so WhatsApp can post event data.
- No additional API keys or credentials are managed within this node; authentication and connection to WhatsApp happen externally.
Troubleshooting
- No events triggering: Ensure your WhatsApp instance is correctly configured to send events to the webhook URL provided by this node.
- Events not matching selected types: Verify that the "Events" property includes the event types you expect to receive.
- Webhook unreachable: Confirm that the webhook URL is publicly accessible and not blocked by firewalls or network restrictions.
- Unexpected payloads: Check that the WhatsApp instance sends data in the expected format; otherwise, the node may not recognize the event.
Links and References
- WAHA WhatsApp Integration Documentation (example link, replace with actual)
- WhatsApp Business API Webhooks