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

> Происходит при удалении WhatsApp Business Account.

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

## Триггеры

Происходит при удалении WhatsApp Business Account.

Подпишитесь на `whatsapp.business_account.deleted`, когда будете [настраивать конечную точку Webhook](https://docs.ycloud.com/ru/api-reference/guides/api-fundamentals/configure-webhooks.md).

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

## Синтаксис

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

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "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. См. раздел [проверка подписи](https://docs.ycloud.com/ru/api-reference/guides/api-fundamentals/configure-webhooks.md).

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

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

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

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

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

#### whatsappBusinessAccount

| Параметр | Тип | Обязательный | Описание |
| - | - | - | - |
| `id` | string | Нет | Идентификатор WhatsApp Business Account. |
| `name` | string | Нет | Удобное имя для различения аккаунтов WhatsApp Business. |
| `removedReason` | string | Нет | Исходная причина из события удаления WhatsApp Business Account. Известные значения включают:<ul><li>`ACCOUNT_DISCONNECTED`: аккаунт был отключен из-за мер принудительного характера или из-за явного удаления аккаунта WhatsApp.</li><li>`BUSINESS_DOWNGRADE`: номер телефона был зарегистрирован в обычном приложении WhatsApp.</li><li>`CHANGE_NUMBER`: номер телефона WhatsApp был изменен.</li><li>`COMPANION_INACTIVITY`: связанное устройство было неактивно около 30 дней.</li><li>`PRIMARY_INACTIVITY`: основное устройство было неактивно около 30 дней.</li><li>`USER_RE_REGISTERED`: WhatsApp был повторно зарегистрирован на новом устройстве.</li></ul>Неизвестные значения возвращаются в исходном виде. |
| `removedInitiatedBy` | string | Нет | Исходный инициатор из события удаления WhatsApp Business Account. Известные значения включают:<ul><li>`USER`: удаление инициировано пользователем WhatsApp.</li><li>`SYSTEM`: удаление инициировано системой Meta.</li></ul>Неизвестные значения возвращаются в исходном виде. |
| `removedTime` | string (date-time) | Нет | Время получения события удаления WhatsApp Business Account в формате [RFC 3339](https://datatracker.ietf.org/doc/html/rfc3339). Например, `2026-05-19T12:00:00.000Z`. |

## Пример

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

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

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "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 theme={"theme":{"light":"github-light","dark":"github-dark"}}
HTTP/1.1 200 OK
```

Пошаговые сценарии см. в [примерах с пояснениями](https://docs.ycloud.com/ru/api-reference/guides/examples/webhook-examples/whatsapp-business-account-updated-webhook-examples).


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