> ## 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

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

<Note>Полный каталог, сформированный на основе схемы, см. в разделе [Все примеры](/ru/api-reference/guides/examples/webhook-examples/webhook-payload-examples).</Note>

## Что это такое

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

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

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

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

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

## Запрос

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

## Ответ

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

```http theme={"theme":{"light":"github-light","dark":"github-dark"}}
HTTP/1.1 200 OK
```

<Note>Информацию о настройке эндпоинта, проверке подписи и механизме повторных попыток см. в разделе [Настройка вебхуков](/ru/api-reference/guides/api-fundamentals/configure-webhooks).</Note>

<br />

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

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

### Запрос

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

### Пояснение

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

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

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

### Запрос

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "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 theme={"theme":{"light":"github-light","dark":"github-dark"}}
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 для отдельной настройки

<br />


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