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

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

Что это такое

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

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

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

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

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

Запрос

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

Ответ

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

HTTP/1.1 200 OK

Сведения о настройке конечной точки, проверке подписи и механизме повторных попыток см. в разделе Настройка Webhook.

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

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

Запрос

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

Пояснение

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

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

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

Запрос

{
  "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/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 жизненного цикла групп

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

Руководства

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

Webhooks

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

Что это такое

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

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

Запрос

Ответ

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

Запрос

Ответ

Пояснение

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

Запрос

Ответ

Пояснение

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

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

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

​Запрос

​Ответ

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

​Запрос

​Ответ

​Пояснение

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

​Запрос

​Ответ

​Пояснение

Что это такое

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

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

Запрос

Ответ

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

Запрос

Ответ

Пояснение

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

Запрос

Ответ

Пояснение