whatsapp.phone_number.deleted

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

Триггеры

Происходит при удалении бизнес-номера телефона WhatsApp. Подпишитесь на whatsapp.phone_number.deleted, когда будете настраивать конечную точку вебхука.

Синтаксис

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

{
  "id": "<ID>",
  "type": "whatsapp.phone_number.deleted",
  "apiVersion": "<API_VERSION>",
  "createTime": "<CREATE_TIME>",
  "whatsappPhoneNumber": {
    "id": "<ID>",
    "phoneNumber": "<PHONE_NUMBER>",
    "wabaId": "<WABA_ID>"
  }
}

Параметры

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

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

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

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

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

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

whatsappPhoneNumber

Параметр	Тип	Обязательный	Описание
`id`	string	Нет	Идентификатор номера телефона.
`phoneNumber`	string	Нет	Номер телефона в формате E.164.
`displayPhoneNumber`	string	Нет	Отображаемый номер телефона.
`wabaId`	string	Нет	Идентификатор WhatsApp Business Account.
`updateEvent`	string	Нет	Событие обновления аккаунта, которое вызвало изменение статуса этого номера телефона. Значения: `ACCOUNT_RECONNECTED`, `ACCOUNT_OFFBOARDED`.

Пример

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

{
  "id": "evt_example_whatsapp_phone_number_deleted",
  "type": "whatsapp.phone_number.deleted",
  "apiVersion": "v2",
  "createTime": "2026-05-26T12:00:00.000Z",
  "whatsappPhoneNumber": {
    "id": "1234567890123456",
    "phoneNumber": "+12025550124",
    "wabaId": "whatsapp-business-account-id"
  }
}

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

HTTP/1.1 200 OK

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

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

Руководства

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

Webhook reference

whatsapp.phone_number.deleted

Триггеры

Синтаксис

Параметры

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

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

whatsappPhoneNumber

Пример

​Триггеры

​Синтаксис

​Параметры

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

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

​whatsappPhoneNumber

​Пример

Триггеры

Синтаксис

Параметры

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

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

whatsappPhoneNumber

Пример