whatsapp.business_account.reviewed

Используйте whatsapp.business_account.reviewed, чтобы обрабатывать это событие на вашей конечной точке Webhook.

Триггеры

Срабатывает, когда WhatsApp Business Account прошел проверку. Подпишитесь на whatsapp.business_account.reviewed, когда будете настраивать конечную точку Webhook.

Синтаксис

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

{
  "id": "<ID>",
  "type": "whatsapp.business_account.reviewed",
  "apiVersion": "<API_VERSION>",
  "createTime": "<CREATE_TIME>",
  "whatsappBusinessAccount": {
    "id": "<ID>",
    "decision": "<DECISION>",
    "accountReviewStatus": "<ACCOUNT_REVIEW_STATUS>"
  }
}

Параметры

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

Оболочка события

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

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

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

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

whatsappBusinessAccount

Параметр	Тип	Обязательный	Описание
`id`	string	Нет	Идентификатор WhatsApp Business Account.
`name`	string	Нет	Понятное имя для различения аккаунтов WhatsApp Business Account.
`accountReviewStatus`	string	Нет	Статус проверки WhatsApp Business Account. Значения: `PENDING`, `APPROVED`, `REJECTED`.
`businessVerificationStatus`	string	Нет	Текущий статус подтверждения компании для Meta Business Account, которому принадлежит этот WhatsApp Business Account. Значения: `expired`, `failed`, `ineligible`, `not_verified`, `pending`, `pending_need_more_info`, `pending_submission`, `rejected`, `revoked`, `verified`.
`decision`	string	Нет	Решение по проверке этого WhatsApp Business Account. Одно из следующих: `APPROVED` или `REJECTED`.

Пример

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

{
  "id": "evt_example_whatsapp_business_account_reviewed",
  "type": "whatsapp.business_account.reviewed",
  "apiVersion": "v2",
  "createTime": "2026-05-26T12:00:00.000Z",
  "whatsappBusinessAccount": {
    "id": "whatsapp-business-account-id",
    "decision": "APPROVED",
    "accountReviewStatus": "APPROVED"
  }
}

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

HTTP/1.1 200 OK

Пошаговые сценарии см. в разделе примеры с пояснениями.

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

Руководства

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

Webhook reference

whatsapp.business_account.reviewed

Триггеры

Синтаксис

Параметры

Оболочка события

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

whatsappBusinessAccount

Пример

​Триггеры

​Синтаксис

​Параметры

​Оболочка события

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

​whatsappBusinessAccount

​Пример

Триггеры

Синтаксис

Параметры

Оболочка события

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

whatsappBusinessAccount

Пример