whatsapp.flow.status_change

Используйте whatsapp.flow.status_change для обработки этого события на вашей конечной точке Webhook.

Триггеры

Происходит при обновлении статуса WhatsApp Flow. Подпишитесь на whatsapp.flow.status_change, когда будете настраивать конечную точку Webhook.

Синтаксис

YCloud отправляет HTTP-запрос POST на настроенный вами URL Webhook. В следующей структуре показан один из вариантов полезной нагрузки. Значения в угловых скобках являются заполнителями; их типы перечислены в разделе Параметры. Необязательные поля и другие варианты описаны ниже.

{
  "type": "whatsapp.flow.status_change",
  "id": "<ID>",
  "apiVersion": "<API_VERSION>",
  "createTime": "<CREATE_TIME>",
  "flowChanges": {
    "flowId": "<FLOW_ID>",
    "wabaId": "<WABA_ID>",
    "message": "<MESSAGE>",
    "oldStatus": "<OLD_STATUS>",
    "newStatus": "<NEW_STATUS>"
  }
}

Параметры

Проверьте HTTP-заголовок YCloud-Signature перед обработкой тела JSON. См. проверка подписи.

Конверт события

Параметр	Тип	Обязательный	Описание
`id`	string	Да	Уникальный идентификатор события. Минимальная длина: `6`. Максимальная длина: `128`.
`type`	string	Да	Всегда `whatsapp.flow.status_change`.
`apiVersion`	string	Да	Версия API, используемая для формирования этого события.
`createTime`	string (date-time)	Да	Время создания этого события в формате RFC 3339, например `2022-06-01T12:00:00.000Z`.

Полезная нагрузка события

Параметр	Тип	Обязательный	Описание
`flowChanges`	object	Нет	Полезная нагрузка `flowChanges`, специфичная для события.

Четыре общих поля конверта обязательны. Поля полезной нагрузки зависят от варианта события. В каждой таблице объектов значение Обязательный применяется при наличии родительского объекта. Необязательные поля могут быть опущены; наличие в примере не делает поле обязательным.

flowChanges

Параметр	Тип	Обязательный	Описание
`flowId`	string	Да	Уникальный идентификатор Flow.
`wabaId`	string	Да	Идентификатор WhatsApp Business Account.
`message`	string	Нет	Идентификатор сообщения об изменении статуса flow.
`oldStatus`	string	Нет	Предыдущий статус flow.
`newStatus`	string	Да	Новый статус flow.

Пример

Следующий JSON представляет собой тело запроса, доставляемое получателю. Идентификаторы, номера телефонов и другие значения аккаунта приведены в качестве примера.

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

После проверки подписи и надежного сохранения события верните ответ 2xx. Обрабатывайте длительные операции асинхронно.

HTTP/1.1 200 OK

Разборы сценариев см. в разделе примеры с пояснениями.

Начало работы

Руководства

Конечные точки

Webhook reference

whatsapp.flow.status_change

Триггеры

Синтаксис

Параметры

Конверт события

Полезная нагрузка события

flowChanges

Пример

​Триггеры

​Синтаксис

​Параметры

​Конверт события

​Полезная нагрузка события

​flowChanges

​Пример

Триггеры

Синтаксис

Параметры

Конверт события

Полезная нагрузка события

flowChanges

Пример