whatsapp.business_account.deleted

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

Триггеры

Происходит при удалении WhatsApp Business Account. Подпишитесь на whatsapp.business_account.deleted, когда будете настраивать конечную точку Webhook. Используйте whatsappBusinessAccount.id для идентификации удаленного аккаунта. Поля удаления являются необязательными. Сохраняйте неизвестные значения removedReason и removedInitiatedBy. Поле removedTime фиксирует время получения события удаления, а не точное время удаления.

Синтаксис

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

{
  "id": "<ID>",
  "type": "whatsapp.business_account.deleted",
  "apiVersion": "<API_VERSION>",
  "createTime": "<CREATE_TIME>",
  "whatsappBusinessAccount": {
    "id": "<ID>",
    "name": "<NAME>",
    "removedReason": "<REMOVED_REASON>",
    "removedInitiatedBy": "<REMOVED_INITIATED_BY>",
    "removedTime": "<REMOVED_TIME>"
  }
}

Параметры

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

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

Параметр	Тип	Обязательный	Описание
`id`	string	Да	Уникальный идентификатор события. Минимальная длина: `6`. Максимальная длина: `128`.
`type`	string	Да	Всегда `whatsapp.business_account.deleted`.
`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.
`removedReason`	string	Нет	Исходная причина из события удаления WhatsApp Business Account. Известные значения включают: `ACCOUNT_DISCONNECTED`: аккаунт был отключен из-за мер принудительного характера или из-за явного удаления аккаунта WhatsApp. `BUSINESS_DOWNGRADE`: номер телефона был зарегистрирован в обычном приложении WhatsApp. `CHANGE_NUMBER`: номер телефона WhatsApp был изменен. `COMPANION_INACTIVITY`: связанное устройство было неактивно около 30 дней. `PRIMARY_INACTIVITY`: основное устройство было неактивно около 30 дней. `USER_RE_REGISTERED`: WhatsApp был повторно зарегистрирован на новом устройстве. Неизвестные значения возвращаются в исходном виде.
`removedInitiatedBy`	string	Нет	Исходный инициатор из события удаления WhatsApp Business Account. Известные значения включают: `USER`: удаление инициировано пользователем WhatsApp. `SYSTEM`: удаление инициировано системой Meta. Неизвестные значения возвращаются в исходном виде.
`removedTime`	string (date-time)	Нет	Время получения события удаления WhatsApp Business Account в формате RFC 3339. Например, `2026-05-19T12:00:00.000Z`.

Пример

Следующий фрагмент JSON представляет собой тело, доставленное вашему получателю. Идентификаторы, номера телефонов и другие значения аккаунта приведены для наглядности. Считайте whatsappBusinessAccount.id для идентификации аккаунта. Если они присутствуют, removedReason, removedInitiatedBy и removedTime описывают удаление. Сохраняйте неизвестные значения причины и инициатора.

{
  "id": "evt_business_account_deleted_123",
  "type": "whatsapp.business_account.deleted",
  "apiVersion": "v2",
  "createTime": "2026-05-26T12:00:00.000Z",
  "whatsappBusinessAccount": {
    "id": "whatsapp-business-account-id",
    "name": "Example business",
    "removedReason": "ACCOUNT_DISCONNECTED",
    "removedInitiatedBy": "USER",
    "removedTime": "2026-05-26T12:00:00.000Z"
  }
}

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

HTTP/1.1 200 OK

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

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

Руководства

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

Webhook reference

whatsapp.business_account.deleted

Триггеры

Синтаксис

Параметры

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

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

whatsappBusinessAccount

Пример

​Триггеры

​Синтаксис

​Параметры

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

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

​whatsappBusinessAccount

​Пример

Триггеры

Синтаксис

Параметры

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

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

whatsappBusinessAccount

Пример