Примеры вебхуков обновления настроек группы WhatsApp

Полный каталог, сформированный на основе схемы, см. в разделе Все примеры.

Что это такое

Обработка обновлений темы и описания группы WhatsApp.

Перед началом работы

Создайте публичный HTTPS-эндпоинт в вашем приложении.
Настройте эндпоинт вебхука YCloud для необходимых типов событий.
Обеспечьте безопасное хранение секрета подписи эндпоинта.
Сделайте обработку событий идемпотентной.

Как это работает

YCloud отправляет HTTP-запрос POST при возникновении события. Проверьте подпись, надежно сохраните событие, верните ответ 2xx и выполняйте длительные операции асинхронно.

Запрос

Ниже приведены сценарии запросов, отправляемых на ваш Webhook URL. Используйте идентификатор события id как идентификатор доставки, а type — для маршрутизации полезной нагрузки.

Ответ

Возвращайте статус 2xx после успешного принятия события.

HTTP/1.1 200 OK

Информацию о настройке эндпоинта, проверке подписи и механизме повторных попыток см. в разделе Настройка вебхуков.

Настройки обновлены

При успешном обновлении настроек группы WhatsApp вы получите вебхук со следующей структурой полезной нагрузки:

Запрос

{
  "id": "evt_group_settings_123",
  "type": "whatsapp.group.settings_update",
  "apiVersion": "v2",
  "createTime": "2026-05-13T00:00:00.000Z",
  "whatsappGroup": {
    "wabaId": "123456789012345",
    "field": "group_settings_update",
    "type": "group_settings_update",
    "requestId": "REQ_2",
    "status": "updated",
    "groupId": "Y2FwaV9ncm91cDpFWEFNUExFX0dST1VQX0lE",
    "subject": "Updated Purchase Inquiry",
    "description": "Updated group description.",
    "settings": [
      {
        "name": "group_subject",
        "text": "Updated Purchase Inquiry",
        "updateSuccessful": true
      },
      {
        "name": "group_description",
        "text": "Updated group description.",
        "updateSuccessful": true
      }
    ],
    "webhookTime": "2026-05-13T00:00:00.000Z"
  }
}

Ответ

Подтверждайте доставку после надежного сохранения события.

HTTP/1.1 200 OK

Пояснение

Маршрутизируйте событие по type, устраняйте дубликаты с помощью id и передавайте медленные или потенциально сбойные задачи в асинхронный обработчик.

Не удалось обновить настройки

Если обновление настроек группы WhatsApp завершилось ошибкой или частичной ошибкой, вы получите вебхук со следующей структурой полезной нагрузки:

Запрос

{
  "id": "evt_group_settings_124",
  "type": "whatsapp.group.settings_update",
  "apiVersion": "v2",
  "createTime": "2026-05-13T00:00:00.000Z",
  "whatsappGroup": {
    "wabaId": "123456789012345",
    "field": "group_settings_update",
    "type": "group_settings_update",
    "requestId": "REQ_SETTINGS",
    "status": "failed",
    "groupId": "Y2FwaV9ncm91cDpFWEFNUExFX0dST1VQX0lE",
    "subject": "New subject",
    "settings": [
      {
        "name": "group_subject",
        "text": "New subject",
        "updateSuccessful": false,
        "errors": [
          {
            "code": 131201,
            "title": "Invalid group subject"
          }
        ]
      }
    ],
    "webhookTime": "2026-05-13T00:00:00.000Z"
  }
}

Ответ

Подтверждайте доставку после надежного сохранения события.

HTTP/1.1 200 OK

Пояснение

type: Всегда whatsapp.group.settings_update для событий настроек группы
whatsappGroup: Содержит сведения о результате обновления настроек группы
- field: Всегда group_settings_update
- type: Всегда group_settings_update
- requestId: Идентификатор запроса, возвращенный асинхронной операцией API настроек группы
- status: Нормализованный статус обновления настроек, либо updated, либо failed
- groupId: Идентификатор группы WhatsApp
- subject и description: Текстовые настройки группы, если они указаны
- settings: Результаты обновления по каждой настройке. name может принимать значения profile_picture, group_subject или group_description
- settings[].updateSuccessful: Указывает, успешно ли прошло обновление отдельной настройки
- settings[].errors: Ошибки, возвращенные WhatsApp для отдельной настройки

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

Руководства

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

Webhooks

Примеры вебхуков обновления настроек группы WhatsApp

Что это такое

Перед началом работы

Как это работает

Запрос

Ответ

Настройки обновлены

Запрос

Ответ

Пояснение

Не удалось обновить настройки

Запрос

Ответ

Пояснение

​Что это такое

​Перед началом работы

​Как это работает

​Запрос

​Ответ

​Настройки обновлены

​Запрос

​Ответ

​Пояснение

​Не удалось обновить настройки

​Запрос

​Ответ

​Пояснение

Что это такое

Перед началом работы

Как это работает

Запрос

Ответ

Настройки обновлены

Запрос

Ответ

Пояснение

Не удалось обновить настройки

Запрос

Ответ

Пояснение