BCDR Flow Trigger icon

BCDR Flow Trigger

Handle WhatsApp Flow data exchange requests with encryption

BCDR Flow Trigger

AI-generated

Summary

Handle and decrypt incoming WhatsApp Flow data exchange POST requests and generate encrypted responses based on configuration and workflow output.

Inputs

  • Acknowledge Errors — Whether to automatically acknowledge errors from the Flow request. Defaults to true.
  • Response Mode (required) — Determines how the Flow response is generated: either 'auto' to send an automatic empty response or 'workflow' to use workflow output to build the response.
  • Response Options — Options to customize the response when 'Response Mode' is set to 'workflow'. Includes specifying the screen to navigate to, JSON data to send, an optional error message, and whether to close the flow (requires flow_token).

Output shape

a single webhook response containing an encrypted Flow response and an output data object of the decrypted Flow request JSON plus metadata

The node listens for POST webhook requests, decrypts incoming encrypted WhatsApp Flow data using the configured business private key, handles health checks (ping) automatically, and returns encrypted responses. When 'Acknowledge Errors' is true, it will automatically acknowledge errors in the request. Depending on 'Response Mode', it either auto-responds or uses workflow-set response options to build the encrypted response. The decrypted request and additional info are output from the node for use in the workflow. Errors on decryption or invalid JSON in response data produce node errors.

Examples

Example 1: Ping health check from WhatsApp Flow

No inputs needed; the node detects 'ping' action and replies with an encrypted 'active' status response automatically.

Example 2: Standard encrypted Flow request with auto response

Set 'Response Mode' to 'Auto Respond' to send an encrypted empty response after decrypting the request, while outputting the decrypted data.

Example 3: Standard encrypted Flow request with workflow response

Set 'Response Mode' to 'From Workflow' and define 'Response Options' to build a custom encrypted response including screen, data JSON, error message, or close flow flag. The response is encrypted inside the node, never exposing key material to the workflow.

Links

Discussion