WhatsApp Web API Trigger (WWebJS)
AI-generatedSummary
Trigger workflow on selected WhatsApp events such as new messages, status changes, or QR code, with optional authentication and filtering.
Inputs
- events (required) — Which events should trigger this workflow. Leave empty to receive all events.
- authentication — How to authenticate incoming webhook requests
- headerName — Name of the header containing the authentication token
- headerValue — Expected value of the authentication header
- hmacSecret — Secret key used to validate the HMAC signature
- signatureHeader — Name of the header containing the HMAC signature
- filters — Additional filters to narrow down which events trigger the workflow
Output shape
a JSON array of webhook payload objects
On successful processing returns an array of payload objects; authentication or filter failures cause the node to emit an error response with no body, so successful executions always produce an array.
Examples
Example 1: Trigger on new incoming messages containing the word 'start'
events: ['message']; filters: {bodyContains: 'start'}
Example 2: Require HMAC signature authentication
authentication: 'hmacSignature'; hmacSecret: '
Example 3: Only trigger on messages from group chats
events: ['message']; filters: {groupsOnly: true}