whatsapp.business_account.updated

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

Триггеры

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

Синтаксис

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

{
  "id": "<ID>",
  "type": "whatsapp.business_account.updated",
  "apiVersion": "<API_VERSION>",
  "createTime": "<CREATE_TIME>",
  "whatsappBusinessAccount": {
    "id": "<ID>",
    "name": "<NAME>",
    "updateEvent": "<UPDATE_EVENT>",
    "violationType": "<VIOLATION_TYPE>",
    "restrictions": [
      {
        "restrictionType": "<RESTRICTION_TYPE>",
        "expiration": "<EXPIRATION>"
      }
    ]
  }
}

Параметры

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

Конверт события

Параметр	Тип	Обязательный	Описание
`id`	string	Да	Уникальный идентификатор события. Минимальная длина: `6`. Максимальная длина: `128`.
`type`	string	Да	Всегда `whatsapp.business_account.updated`.
`apiVersion`	string	Да	Версия API, используемая для формирования этого события.
`createTime`	string (date-time)	Да	Время создания этого события в формате RFC 3339. Например, `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 при отправке вам уведомления о нарушении политик, блокировке 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. `BUSINESS_PRIMARY_LOCATION_COUNTRY_UPDATE`: задано основное местоположение компании. `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. Meta может со временем обновлять этот список. Подробные сведения об ограничениях и типах нарушений Utility Direct Send см. в разделе Meta Webhook for account restriction.
`restrictions`	object[]	Нет	Используется для уведомления об ограничениях, наложенных на WABA, если эта WABA нарушает WhatsApp Business Platform policies.
`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.
`primaryBusinessLocation`	string	Нет	Ваше основное местонахождение бизнеса — это страна, в которой зарегистрирована ваша компания. С 1 мая 2024 года оно будет отображаться в Business Manager в поле Primary Business Location. Двухбуквенный код страны по стандарту ISO 3166-1 alpha-2.

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. Например, `2022-06-01T12:00:00.000Z`.

whatsappBusinessAccount.authIntlRateEligibilityCountries[]

Параметр	Тип	Обязательный	Описание
`countryCode`	string	Нет	Двухбуквенный код страны по стандарту ISO 3166-1 alpha-2.
`startTime`	string (date-time)	Нет	Дата, начиная с которой на новые открытые переписки категории аутентификации распространяются международные тарифы на аутентификацию, в формате RFC 3339. Например, `2024-07-01T00:00:00.000Z`.

Пример

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

Событие ограничения Utility Direct Send

Meta ограничила использование Utility Direct Send на 7 дней после повторного неправомерного использования категории.

{
  "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"
      }
    ]
  }
}

Применимость международного тарифа на аутентификацию

{
  "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"
      }
    ]
  }
}

Обновление основного местонахождения бизнеса

{
  "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"
  }
}

Обновление лимита регистрации номеров телефонов

{
  "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
  }
}

Нарушение в аккаунте

{
  "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"
  }
}

Ограничение аккаунта

{
  "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"
      }
    ]
  }
}

Аккаунт отключен

{
  "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"
  }
}

Восстановление аккаунта

{
  "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/1.1 200 OK

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

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

Руководства

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

Webhook reference

whatsapp.business_account.updated

Триггеры

Синтаксис

Параметры

Конверт события

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

whatsappBusinessAccount

Пример

​Триггеры

​Синтаксис

​Параметры

​Конверт события

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

​whatsappBusinessAccount

​Пример

Триггеры

Синтаксис

Параметры

Конверт события

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

whatsappBusinessAccount

Пример