botonic-react & plugin-flow-builder: add support to whatsapp templates with flow action buttons #BLT-2485

[Iru89]

Description

Adds support for WhatsApp template FLOW buttons in Botonic and Flow Builder. The new button payload supports a flow token and optional action data, with runtime variable interpolation.

Context

WhatsApp templates that launch Meta Flows require an ACTION parameter. Previously, Botonic did not model or serialize this button subtype, so Flow Builder could not send these templates correctly.

Approach taken / Explain the design

• Extends the WhatsApp template types with FLOW and ACTION support, plus strongly typed template components.
• Maps flow_button_action_values from Flow Builder content to the WhatsApp API payload, resolving bot-context variables in flow_token and flow_action_data.
• Omits action data for data_exchange flows, validates required FLOW configuration, and handles PHONE_NUMBER buttons explicitly.
• Adds coverage for navigation and data-exchange flows, missing configuration, empty flow tokens, and component serialization.

To document / Usage example

Configure the template locale with a value for each FLOW button index:

flow_button_action_values: {
  '0': {
    flow_token: '{ticketId}',
    flow_action_data: { ticket_id: '{ticketId}' },
  },
}

flow_action_data is sent for navigation flows and omitted for data_exchange flows.

Testing

The pull request...

• has unit tests for the new WhatsApp template types and serialization
• has Flow Builder integration tests covering FLOW button payload generation and validation
• has passing CI checks for botonic-react and botonic-plugin-flow-builder test suites

[chatgpt-codex-connector]

Codex usage limits have been reached for code reviews. Please check with the admins of this repo to increase the limits by adding credits.
Credits must be used to enable repository wide code reviews.