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

# Ejemplos de webhook de WhatsApp Flow

> Gestiona eventos de cambio de estado de WhatsApp Flow.

<Note>Para ver el catálogo exhaustivo derivado del esquema, consulta [todos los ejemplos](/es/api-reference/guides/examples/webhook-examples/webhook-payload-examples).</Note>

## Qué es

Gestiona eventos de cambio de estado de WhatsApp Flow.

## Antes de comenzar

* Crea un endpoint HTTPS público en tu aplicación.
* Configura un endpoint de webhook de YCloud para los tipos de eventos que necesites.
* Almacena el secreto de firma del endpoint de forma segura.
* Haz que el procesamiento de eventos sea idempotente.

## Cómo funciona

YCloud envía una solicitud HTTP `POST` cuando ocurre el evento. Verifica la firma, registra el evento de forma duradera, devuelve una respuesta `2xx` y procesa las tareas lentas de forma asíncrona.

## Solicitud

Los escenarios a continuación muestran las solicitudes entregadas a la URL de tu webhook. Trata el `id` del evento como el identificador de entrega y usa `type` para enrutar el payload.

## Respuesta

Devuelve un estado `2xx` tras aceptar el evento.

```http theme={"theme":{"light":"github-light","dark":"github-dark"}}
HTTP/1.1 200 OK
```

<Note>Para la configuración de endpoints, validación de firmas y comportamiento de reintentos, consulta [Configurar webhooks](/es/api-reference/guides/api-fundamentals/configure-webhooks).</Note>

## Cambio de estado del Flow

Cuando un WhatsApp Flow cambia su estado (por ejemplo, de DRAFT a PUBLISHED), recibirás un webhook con la siguiente estructura de payload:

### Solicitud

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "type": "whatsapp.flow.status_change",
  "id": "evt_1234567890abcdef",
  "apiVersion": "v2",
  "createTime": "2025-09-11T07:24:52.000Z",
  "flowChanges": {
    "flowId": "1097420589034000",
    "wabaId": "123456789012345",
    "message": "Flow Webhook 3 changed status from DRAFT to PUBLISHED",
    "oldStatus": "DRAFT",
    "newStatus": "PUBLISHED"
  }
}
```

### Respuesta

Confirma la entrega tras aceptar el evento de forma duradera.

```http theme={"theme":{"light":"github-light","dark":"github-dark"}}
HTTP/1.1 200 OK
```

### Explicación

* **type**: Siempre `whatsapp.flow.status_change` para eventos de cambio de estado de flow
* **flowChanges**: Contiene los detalles del cambio de estado del flow
  * **flowId**: El ID único del Flow cuyo estado cambió
  * **wabaId**: ID de la cuenta de WhatsApp Business asociada con el flow
  * **message**: Descripción legible por humanos del cambio de estado
  * **oldStatus**: El estado anterior del flow
  * **newStatus**: El estado actual del flow

### Valores comunes de estado del Flow

* `DRAFT`
* `PUBLISHED`
* `DEPRECATED`
* `BLOCKED`
* `THROTTLED`


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