> ## 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.

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

> Обработка событий изменения статуса WhatsApp Flow.

<Note>Полный каталог на основе схемы см. в разделе [все примеры](/ru/api-reference/guides/examples/webhook-examples/webhook-payload-examples).</Note>

## Что это такое

Обработка событий изменения статуса WhatsApp Flow.

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

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

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

YCloud отправляет HTTP-запрос `POST` при возникновении события. Проверьте подпись, надежно сохраните событие, верните ответ `2xx` и выполняйте длительные операции асинхронно.

## Запрос

В приведенных ниже сценариях показаны запросы, отправляемые на ваш URL вебхука. Используйте событие `id` в качестве идентификатора доставки, а `type` — для маршрутизации полезной нагрузки.

## Ответ

Возвращайте статус `2xx` после успешного принятия события.

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

<Note>Инструкции по настройке эндпоинта, валидации подписи и логике повторных попыток см. в разделе [Настройка вебхуков](/ru/api-reference/guides/api-fundamentals/configure-webhooks).</Note>

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

При изменении статуса WhatsApp Flow (например, с DRAFT на PUBLISHED) вы получите вебхук со следующей структурой полезной нагрузки:

### Запрос

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

### Ответ

Подтвердите получение после надежного сохранения события.

```http theme={"theme":{"light":"github-light","dark":"github-dark"}}
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`


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