> ## 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.updated > Происходит при нарушении политик, блокировке WhatsApp Business Account и других событиях. Используйте `whatsapp.business_account.updated` для обработки этого события на вашей конечной точке вебхука. ## Триггеры Происходит при нарушении политик, блокировке WhatsApp Business Account и других событиях. Подпишитесь на `whatsapp.business_account.updated`, когда [настраиваете конечную точку вебхука](https://docs.ycloud.com/ru/api-reference/guides/api-fundamentals/configure-webhooks.md). ## Синтаксис YCloud отправляет HTTP-запрос `POST` на настроенный вами URL-адрес вебхука. В приведенной структуре показан один из вариантов полезной нагрузки. Значения в угловых скобках являются плейсхолдерами; их типы перечислены в разделе **Параметры**. Необязательные поля и другие варианты описаны ниже. ```json theme={"theme":{"light":"github-light","dark":"github-dark"}} { "id": "", "type": "whatsapp.business_account.updated", "apiVersion": "", "createTime": "", "whatsappBusinessAccount": { "id": "", "name": "", "updateEvent": "", "violationType": "", "restrictions": [ { "restrictionType": "", "expiration": "" } ] } } ``` ## Параметры Проверьте 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.updated`. | | `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`. | Четыре общих поля конверта являются обязательными. Поля полезной нагрузки зависят от варианта события. В таблице каждого объекта статус **Required** действует при наличии его родительского объекта. Необязательные поля могут быть опущены; наличие примера не делает поле обязательным. #### whatsappBusinessAccount | Параметр | Тип | Обязательный | Описание | | - | - | - | - | | `id` | string | Нет | Идентификатор WhatsApp Business Account. | | `name` | string | Нет | Понятное имя для различения аккаунтов WhatsApp Business Account. | | `accountReviewStatus` | string | Нет | Статус проверки WhatsApp Business Account.Значения: `PENDING`, `APPROVED`, `REJECTED`. | | `updateEvent` | string | Нет | Указывает тип события обновления WABA при отправке вам уведомления о [нарушении политик](https://developers.facebook.com/docs/whatsapp/overview/policy-enforcement), блокировке WABA и других событиях.
  • `DISABLED_UPDATE`: WhatsApp Business Account заблокирован.
  • `ACCOUNT_RESTRICTION`: действие WhatsApp Business Account ограничено из-за нарушений политик.
  • `ACCOUNT_VIOLATION`: WhatsApp Business Account нарушает политики.
  • `PARTNER_REMOVED`: WhatsApp Business Account был удален из партнерского подключения.
  • `PARTNER_APP_UNINSTALLED`: партнерское приложение WhatsApp Business Account было удалено.
  • `AUTH_INTL_PRICE_ELIGIBILITY_UPDATE`: WhatsApp Business Account соответствует критериям для тарифа [authentication-international](https://developers.facebook.com/docs/whatsapp/pricing/authentication-international-rates).
  • `BUSINESS_PRIMARY_LOCATION_COUNTRY_UPDATE`: задано [основное местоположение компании](https://developers.facebook.com/docs/whatsapp/pricing/authentication-international-rates#primary-business-location).
  • `BUSINESS_CAPABILITY_UPDATE`: Meta сообщила об изменении лимита регистрации номеров телефонов для Business Portfolio или WABA.
| | `banState` | string | Нет | Статус блокировки WhatsApp Business Account.Значения: `SCHEDULE_FOR_DISABLE`, `DISABLE`, `REINSTATE`. | | `banDate` | string | Нет | Дата блокировки WABA. | | `violationType` | string | Нет | Используется для уведомления о нарушениях, наложенных на WABA. Типы и описания нарушений см. в разделе Meta [Policy enforcement violations](https://developers.facebook.com/documentation/business-messaging/whatsapp/policy-enforcement-violations). Meta может со временем обновлять этот список. Подробные сведения об ограничениях и типах нарушений Utility Direct Send см. в разделе Meta [Webhook for account restriction](https://developers.facebook.com/documentation/business-messaging/whatsapp/direct-send/integrity-and-content-guidelines#webhook-for-account-restriction). | | `restrictions` | object\[] | Нет | Используется для уведомления об ограничениях, наложенных на WABA, если эта WABA нарушает [WhatsApp Business Platform policies](https://developers.facebook.com/docs/whatsapp/overview/policy-enforcement). | | `maxPhoneNumbersPerBusiness` | integer (int32) | Нет | Включается в Webhook `whatsapp.business_account.updated` с `updateEvent=BUSINESS_CAPABILITY_UPDATE`, когда Meta сообщает лимит регистрации номеров телефонов для Business Portfolio. В настоящее время Meta передает это поле отдельно от `maxPhoneNumbersPerWaba`, однако принимающая сторона должна обрабатывать оба поля, если в будущем обновлении они будут передаваться вместе. | | `maxPhoneNumbersPerWaba` | integer (int32) | Нет | Включается в Webhook `whatsapp.business_account.updated` с `updateEvent=BUSINESS_CAPABILITY_UPDATE`, когда Meta сообщает лимит регистрации номеров телефонов для WABA. В настоящее время Meta передает это поле отдельно от `maxPhoneNumbersPerBusiness`, однако принимающая сторона должна обрабатывать оба поля, если в будущем обновлении они будут передаваться вместе. | | `authIntlRateEligibilityCountries` | object\[] | Нет | С 1 июня 2024 года мы обновляем тарифную сетку для сообщений аутентификации и вводим новый международный тариф на аутентификацию (authentication-international). Этот тариф будет действовать в следующих странах:
  • 1 июня 2024 г. – Индонезия (телефонный код страны +62, код страны `ID`)
  • 1 июля 2024 г. – Индия (телефонный код страны +91, код страны `IN`)
См. также [Authentication-International Rates](https://developers.facebook.com/docs/whatsapp/pricing/authentication-international-rates). | | `primaryBusinessLocation` | string | Нет | Ваше основное местонахождение бизнеса — это страна, в которой зарегистрирована ваша компания. С 1 мая 2024 года оно будет отображаться в Business Manager в поле Primary Business Location. [Двухбуквенный код страны по стандарту ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). | > [accordion] whatsappBusinessAccount.restrictions\[] > > | Параметр | Тип | Обязательный | Описание | > | - | - | - | - | > | `restrictionType` | string | Нет | Тип ограничения.Значения: `RESTRICTED_ADD_PHONE_NUMBER_ACTION`, `RESTRICTED_BIZ_INITIATED_MESSAGING`, `RESTRICTED_CUSTOMER_INITIATED_MESSAGING`, `RESTRICTED_DIRECT_SEND_UTILITY_TEMPLATES`. | > | `expiration` | string (date-time) | Нет | Время истечения этого ограничения в формате [RFC 3339](https://datatracker.ietf.org/doc/html/rfc3339). Например, `2022-06-01T12:00:00.000Z`. | > [accordion] whatsappBusinessAccount.authIntlRateEligibilityCountries\[] > > | Параметр | Тип | Обязательный | Описание | > | - | - | - | - | > | `countryCode` | string | Нет | [Двухбуквенный код страны по стандарту ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). | > | `startTime` | string (date-time) | Нет | Дата, начиная с которой на новые открытые переписки категории аутентификации распространяются международные тарифы на аутентификацию, в формате [RFC 3339](https://datatracker.ietf.org/doc/html/rfc3339). Например, `2024-07-01T00:00:00.000Z`. | ## Пример Следующий фрагмент JSON представляет собой тело запроса, доставленное вашему обработчику. Идентификаторы, номера телефонов и другие значения учетных записей приведены в качестве примера. > [accordion] Событие ограничения Utility Direct Send > > Meta ограничила использование Utility Direct Send на 7 дней после повторного неправомерного использования категории. > > ```json theme={"theme":{"light":"github-light","dark":"github-dark"}} > { > "id": "evt_direct_send_restriction_123", > "type": "whatsapp.business_account.updated", > "apiVersion": "v2", > "createTime": "2026-09-17T08:00:00.000Z", > "whatsappBusinessAccount": { > "id": "whatsapp-business-account-id", > "name": "Example business", > "updateEvent": "ACCOUNT_RESTRICTION", > "violationType": "DIRECT_SEND_UTILITY_CATEGORY_ABUSE_STRIKE_1", > "restrictions": [ > { > "restrictionType": "RESTRICTED_DIRECT_SEND_UTILITY_TEMPLATES", > "expiration": "2026-09-24T08:00:00.000Z" > } > ] > } > } > ``` > [accordion] Применимость международного тарифа на аутентификацию > > ```json theme={"theme":{"light":"github-light","dark":"github-dark"}} > { > "id": "evt_djeIQXaQPQyUcRFi", > "type": "whatsapp.business_account.updated", > "apiVersion": "v2", > "createTime": "2024-06-01T00:00:00.000Z", > "whatsappBusinessAccount": { > "id": "106681...", > "updateEvent": "AUTH_INTL_PRICE_ELIGIBILITY_UPDATE", > "authIntlRateEligibilityCountries": [ > { > "countryCode": "IN", > "startTime": "2024-07-01T00:00:00.000Z" > }, > { > "countryCode": "ID", > "startTime": "2024-07-01T00:00:00.000Z" > } > ] > } > } > ``` > [accordion] Обновление основного местонахождения бизнеса > > ```json theme={"theme":{"light":"github-light","dark":"github-dark"}} > { > "id": "evt_djeIQXaQPQyUcRFi", > "type": "whatsapp.business_account.updated", > "apiVersion": "v2", > "createTime": "2024-06-01T00:00:00.000Z", > "whatsappBusinessAccount": { > "id": "106681...", > "updateEvent": "BUSINESS_PRIMARY_LOCATION_COUNTRY_UPDATE", > "primaryBusinessLocation": "US" > } > } > ``` > [accordion] Обновление лимита регистрации номеров телефонов > > ```json theme={"theme":{"light":"github-light","dark":"github-dark"}} > { > "id": "evt_djeIQXaQPQyUcRFi", > "type": "whatsapp.business_account.updated", > "apiVersion": "v2", > "createTime": "2026-09-23T00:00:00.000Z", > "whatsappBusinessAccount": { > "id": "106681...", > "updateEvent": "BUSINESS_CAPABILITY_UPDATE", > "maxPhoneNumbersPerWaba": 25 > } > } > ``` > [accordion] Нарушение в аккаунте > > ```json theme={"theme":{"light":"github-light","dark":"github-dark"}} > { > "id": "evt_djeIQXaQPQyUcRFi", > "type": "whatsapp.business_account.updated", > "apiVersion": "v2", > "createTime": "2024-06-01T00:00:00.000Z", > "whatsappBusinessAccount": { > "id": "106681...", > "updateEvent": "ACCOUNT_VIOLATION", > "violationType": "SCAM" > } > } > ``` > [accordion] Ограничение аккаунта > > ```json theme={"theme":{"light":"github-light","dark":"github-dark"}} > { > "id": "evt_djeIQXaQPQyUcRFi", > "type": "whatsapp.business_account.updated", > "apiVersion": "v2", > "createTime": "2024-06-01T00:00:00.000Z", > "whatsappBusinessAccount": { > "id": "106681...", > "updateEvent": "ACCOUNT_RESTRICTION", > "restrictions": [ > { > "restrictionType": "RESTRICTED_ADD_PHONE_NUMBER_ACTION", > "expiration": "2024-09-01T12:00:00.000Z" > }, > { > "restrictionType": "RESTRICTED_BIZ_INITIATED_MESSAGING", > "expiration": "2024-09-01T12:00:00.000Z" > }, > { > "restrictionType": "RESTRICTED_CUSTOMER_INITIATED_MESSAGING", > "expiration": "2024-09-01T12:00:00.000Z" > } > ] > } > } > ``` > [accordion] Аккаунт отключен > > ```json theme={"theme":{"light":"github-light","dark":"github-dark"}} > { > "id": "evt_djeIQXaQPQyUcRFi", > "type": "whatsapp.business_account.updated", > "apiVersion": "v2", > "createTime": "2024-06-01T00:00:00.000Z", > "whatsappBusinessAccount": { > "id": "106681...", > "updateEvent": "DISABLED_UPDATE", > "banDate": "September 19, 2024", > "banState": "DISABLE" > } > } > ``` > [accordion] Восстановление аккаунта > > ```json theme={"theme":{"light":"github-light","dark":"github-dark"}} > { > "id": "evt_djeIQXaQPQyUcRFi", > "type": "whatsapp.business_account.updated", > "apiVersion": "v2", > "createTime": "2024-06-01T00:00:00.000Z", > "whatsappBusinessAccount": { > "id": "106681...", > "updateEvent": "DISABLED_UPDATE", > "banState": "REINSTATE", > "banDate": "December 27, 2024", > "accountReviewStatus": "APPROVED" > } > } > ``` После проверки подписи и надежного принятия события верните ответ `2xx`. Длительные операции обрабатывайте асинхронно. ```http theme={"theme":{"light":"github-light","dark":"github-dark"}} HTTP/1.1 200 OK ``` Пошаговые сценарии см. в разделе [annotated examples](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.