> ## Documentation Index
> Fetch the complete documentation index at: https://developers.insuranceboosters.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Data Endpoint de WhatsApp Flow

> Responde en tiempo real mientras una persona completa un WhatsApp Flow de Meta.

Usa `whatsapp_flow_data_exchange` cuando un WhatsApp Flow necesite consultar
datos o decidir la siguiente pantalla antes de que la persona termine el
formulario. Para procesar el envío final usa
[`whatsapp_flow_submission`](https://developers.insuranceboosters.com/automatizaciones/triggers/respuesta-whatsapp-flow).

## Configuración

```json theme={null}
{
  "type": "whatsapp_flow_data_exchange",
  "flowId": "<meta-flow-id>"
}
```

El trigger es siempre síncrono. La automatización debe tener exactamente un
paso `code.javascript`, con un `timeoutMs` máximo de `15000`.

## Datos disponibles

El paso recibe un evento normalizado:

```json theme={null}
{
  "source": "whatsapp_flow_data_exchange",
  "tenantId": "<tenant-id>",
  "occurredAt": "2026-11-12T18:00:00.000Z",
  "flow": {
    "id": "<meta-flow-id>",
    "token": "<flow-token>"
  },
  "exchange": {
    "action": "data_exchange",
    "screen": "MODELO",
    "data": {
      "intent": "load_brands",
      "year": "2025"
    },
    "version": "3.0"
  }
}
```

En una acción `INIT`, Meta puede enviar únicamente `action` y `flow_token`.
En ese caso `exchange.data` será `{}` y la plataforma resolverá `flow.id` y
`tenantId` desde la sesión persistida.

Pasa al `input` solo los campos necesarios:

```json theme={null}
{
  "actionKey": "code.javascript",
  "timeoutMs": 15000,
  "input": {
    "action": "{{trigger.body.exchange.action}}",
    "screen": "{{trigger.body.exchange.screen}}",
    "data": "{{trigger.body.exchange.data}}"
  },
  "code": "return { screen: 'MARCA', data: { marcas: [] } };"
}
```

## Contrato de salida

El código debe devolver un objeto con `data` y, cuando haya navegación, `screen`:

```json theme={null}
{
  "screen": "MARCA",
  "data": {
    "marcas": [
      { "id": "NISSAN", "title": "NISSAN" }
    ]
  }
}
```

La plataforma valida la salida y se encarga de cifrarla para Meta. El código de
la automatización no debe implementar RSA, AES ni manejar llaves privadas.

## Reglas operativas

* Solo puede existir una automatización activa de este tipo por tenant y
  `flowId`.
* Desactiva la automatización antes de publicar una versión nueva y vuelve a
  activarla después. Así el ownership del Data Endpoint cambia de forma
  atómica.
* La sesión del Flow debe haber sido enviada y persistida por la plataforma.
* El tenant se obtiene de esa sesión persistida; los valores enviados por el
  cliente no se usan como identidad.
* Usa este trigger para catálogos, validaciones y navegación. Deja cotizaciones,
  registros y mensajes posteriores al trigger de envío final.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.