Facebook Messenger Trigger icon

Facebook Messenger Trigger

Triggers a workflow when a Facebook Messenger event occurs

Facebook Messenger Trigger

AI-generated

Summary

Trigger a workflow upon receiving specific Facebook Messenger events such as new messages, message deliveries, echoes, reads, opt-ins, and postbacks, optionally filtering by first user interaction, message text, or postback payload.

Inputs

  • Events (required) — Select one or more Facebook Messenger event types to trigger the workflow (e.g., messages, message_deliveries, message_echoes, message_reads, messaging_optins, messaging_postbacks).
  • Only First Interaction — Optionally trigger only on the user's first interaction with the page via the Get Started postback button. Requires Get Started button setup on your Facebook page.
  • Postback Payload Filter — When not using 'Only First Interaction', filter postback events to trigger only on those matching this exact payload string. Leave empty to accept all postbacks.
  • Message Text Contains — When not using 'Only First Interaction', trigger only on messages containing this case-insensitive text filter. Leave empty to accept all messages.
  • Validate Signature — Enable validation of the incoming webhook requests' X-Hub-Signature-256 header using your Facebook App Secret to ensure authenticity. Defaults to true.

Output shape

a list of event objects matching the selected types and filters, each containing relevant event details and metadata (senderId, recipientId, timestamps, etc.)

The webhook expects POST requests from Facebook Messenger and returns status responses accordingly. If no events match the filters, the workflow is not triggered, although a webhook response is still sent. When 'Only First Interaction' is enabled, only the GET_STARTED postback triggers workflow execution regardless of other event selections.

Examples

Example 1: Trigger a workflow on every new message received from users containing the word 'hello'.

Events set to 'messages'; 'Message Text Contains' set to 'hello'; 'Only First Interaction' disabled.

Example 2: Trigger only when a user first interacts with the page via the Get Started button.

'Only First Interaction' enabled; other filters ignored.

Links

Discussion