WhatsApp Trigger

Listen for WhatsApp messages and events

WhatsApp Trigger

AI-generated

Summary

Receives WhatsApp server webhook events and starts the workflow for matching connection events or messages. Configure the event type and, optionally, comma-separated keywords; incoming messages are emitted as one item containing their message data.

Inputs

  • triggerOn — Choose all messages, text-only messages, media-only messages, group messages, direct messages, or connection status changes. Defaults to all messages.
  • filterKeywords — Optional comma-separated keywords. For messages, the trigger fires when the message text contains any keyword, compared case-insensitively; leaving this blank disables keyword filtering. This filter is not applied to connection events.
  • Polling Interval — Shown for embedded credential mode, with a default of 5 seconds. The source returns an error item in embedded mode; it does not poll for messages.

Output shape

One workflow item per matching webhook event, containing the event object in json; non-matching events return no items.

Message webhooks in the legacy format are converted to a message object with fields including messageId, sessionId, chatId, isGroup, messageText, and hasMedia. Connection event data is passed through as received. External mode webhook registration is attempted when webhooks are enabled in credentials; without that, polling returns no items.

Links

Discussion