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

# Ejemplos de webhook de actualización del ciclo de vida de grupos de WhatsApp

> Gestiona los resultados de la creación y eliminación de grupos de WhatsApp.

<Note>Para consultar el catálogo exhaustivo derivado del esquema, consulta [todos los ejemplos](/es/api-reference/guides/examples/webhook-examples/webhook-payload-examples).</Note>

## Qué es

Gestiona los resultados de la creación y eliminación de grupos de WhatsApp.

## Antes de comenzar

* Crea un endpoint HTTPS público en tu aplicación.
* Configura un endpoint de webhook de YCloud para los tipos de eventos que necesites.
* Almacena el secreto de firma del endpoint de forma segura.
* Haz que el procesamiento de eventos sea idempotente.

## Cómo funciona

YCloud envía una solicitud HTTP `POST` cuando ocurre el evento. Verifica la firma, registra el evento de forma duradera, devuelve una respuesta `2xx` y procesa las tareas lentas de forma asíncrona.

## Solicitud

Los siguientes escenarios muestran solicitudes enviadas a la URL de tu webhook. Trata el evento `id` como el identificador de entrega y utiliza `type` para enrutar la carga útil.

## Respuesta

Devuelve un estado `2xx` tras aceptar el evento.

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

<Note>Para la configuración de endpoints, la validación de firmas y el comportamiento de reintentos, consulta [Configurar webhooks](/es/api-reference/guides/api-fundamentals/configure-webhooks).</Note>

<br />

## Grupo creado

Cuando un grupo de WhatsApp se crea con éxito, recibirás un webhook con la siguiente estructura de carga útil:

### Solicitud

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

### Respuesta

Confirma la recepción de la entrega tras aceptar el evento de forma duradera.

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

### Explicación

Enruta el evento mediante `type`, deduplícalo mediante `id` y traslada las tareas lentas o propensas a errores a un procesador asíncrono.

## Grupo eliminado

Cuando se elimina un grupo de WhatsApp, recibirás un webhook con la siguiente estructura de carga útil:

### Solicitud

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

### Respuesta

Confirma la recepción de la entrega tras aceptar el evento de forma duradera.

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

### Explicación

* **type**: Siempre `whatsapp.group.lifecycle_update` para eventos del ciclo de vida del grupo
* **whatsappGroup**: Contiene los detalles del resultado del ciclo de vida del grupo
  * **field**: Siempre `group_lifecycle_update`
  * **type**: La acción del ciclo de vida, como `group_create` o `group_delete`
  * **requestId**: El ID de solicitud devuelto por la operación asíncrona de la API de grupos
  * **status**: El estado del resultado normalizado, como `created`, `deleted` o `failed`
  * **groupId**: El ID del grupo de WhatsApp
  * **inviteLink**: El enlace de invitación al grupo, incluido cuando la creación del grupo se realiza con éxito
  * **dedupeKey**: Clave de idempotencia para deduplicar eventos de webhook del ciclo de vida del grupo

<br />


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