Ejemplos de webhook de WhatsApp Flow

​

Qué es

​

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

​

Solicitud

​

Respuesta

HTTP/1.1 200 OK

​

Cambio de estado del Flow

​

Solicitud

{
  "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

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