Примеры вебхуков для WhatsApp Flow

​

Что это такое

​

Перед началом работы

• Создайте общедоступную конечную точку HTTPS в своем приложении.
• Настройте эндпоинт Webhook в YCloud для необходимых типов событий.
• Обеспечьте безопасное хранение секретного ключа подписи эндпоинта.
• Сделайте обработку событий идемпотентной.

​

Как это работает

​

Запрос

​

Ответ

HTTP/1.1 200 OK

​

Изменение статуса Flow

​

Запрос

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

​

Ответ

HTTP/1.1 200 OK

​

Пояснение

• type: всегда whatsapp.flow.status_change для событий изменения статуса flow
• flowChanges: содержит сведения об изменении статуса flow
  • flowId: уникальный идентификатор Flow, статус которого изменился
  • wabaId: идентификатор аккаунта WhatsApp Business, связанного с flow
  • message: понятное человеку описание изменения статуса
  • oldStatus: предыдущий статус flow
  • newStatus: текущий статус flow

​

Распространенные значения статуса Flow

• DRAFT
• PUBLISHED
• DEPRECATED
• BLOCKED
• THROTTLED