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

# Примеры Webhook для обновления жизненного цикла групп WhatsApp

> Обработка результатов создания и удаления групп WhatsApp.

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

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

Обработка результатов создания и удаления групп WhatsApp.

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

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

## Принцип работы

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

## Запрос

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

## Ответ

После принятия события верните статус `2xx`.

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

<Note>Сведения о настройке конечной точки, проверке подписи и механизме повторных попыток см. в разделе [Настройка Webhook](/ru/api-reference/guides/api-fundamentals/configure-webhooks).</Note>

<br />

## Группа создана

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

### Запрос

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "id": "evt_group_lifecycle_123",
  "type": "whatsapp.group.lifecycle_update",
  "apiVersion": "v2",
  "createTime": "2026-05-13T00:00:00.000Z",
  "whatsappGroup": {
    "wabaId": "123456789012345",
    "displayPhoneNumber": "16315551111",
    "phoneNumberId": "1234567890123456",
    "field": "group_lifecycle_update",
    "type": "group_create",
    "requestId": "REQ_1",
    "status": "created",
    "groupId": "Y2FwaV9ncm91cDpFWEFNUExFX0dST1VQX0lE",
    "inviteLink": "https://chat.whatsapp.com/AbCdEfGhIjK",
    "subject": "New Purchase Inquiry",
    "description": "Group for purchase inquiries.",
    "joinApprovalMode": "auto_approve",
    "webhookTime": "2026-05-13T00:00:00.000Z",
    "dedupeKey": "123456789012345|REQ_1|group_lifecycle_update|group_create|created"
  }
}
```

### Ответ

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

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

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

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

## Группа удалена

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

### Запрос

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "id": "evt_group_lifecycle_124",
  "type": "whatsapp.group.lifecycle_update",
  "apiVersion": "v2",
  "createTime": "2026-05-13T00:00:00.000Z",
  "whatsappGroup": {
    "wabaId": "123456789012345",
    "field": "group_lifecycle_update",
    "type": "group_delete",
    "requestId": "REQ_DELETE",
    "status": "deleted",
    "groupId": "Y2FwaV9ncm91cDpFWEFNUExFX0dST1VQX0lE",
    "webhookTime": "2026-05-13T00:00:00.000Z"
  }
}
```

### Ответ

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

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

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

* **type**: всегда `whatsapp.group.lifecycle_update` для событий жизненного цикла групп
* **whatsappGroup**: содержит сведения о результатах жизненного цикла группы
  * **field**: всегда `group_lifecycle_update`
  * **type**: действие жизненного цикла, например `group_create` или `group_delete`
  * **requestId**: идентификатор запроса, возвращенный асинхронной операцией API для групп
  * **status**: нормализованный статус результата, например `created`, `deleted` или `failed`
  * **groupId**: идентификатор группы WhatsApp
  * **inviteLink**: ссылка-приглашение в группу, передается при успешном создании группы
  * **dedupeKey**: ключ идемпотентности для дедупликации событий Webhook жизненного цикла групп

<br />


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