> ## 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 de estado de grupos de WhatsApp

> Gestione las actualizaciones de estado de suspensión de grupos de WhatsApp.

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

## Qué es

Gestione las actualizaciones de estado de suspensión de grupos de WhatsApp.

## Antes de comenzar

* Cree un endpoint HTTPS público en su aplicación.
* Configure un endpoint de webhook de YCloud para los tipos de eventos que necesite.
* Guarde el secreto de firma del endpoint de forma segura.
* Haga que el procesamiento de eventos sea idempotente.

## Cómo funciona

YCloud envía una solicitud HTTP `POST` cuando ocurre el evento. Verifique la firma, registre el evento de forma duradera, devuelva una respuesta `2xx` y procese el trabajo lento de forma asíncrona.

## Solicitud

Los escenarios a continuación muestran las solicitudes entregadas a su URL de webhook. Considere el `id` del evento como el identificador de entrega y use `type` para enrutar el payload.

## Respuesta

Devuelva un estado `2xx` después de 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, consulte [Configurar webhooks](/es/api-reference/guides/api-fundamentals/configure-webhooks).</Note>

<br />

## Grupo suspendido

Cuando se suspende un grupo de WhatsApp, recibirá un webhook con la siguiente estructura de payload:

### Solicitud

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "id": "evt_group_status_123",
  "type": "whatsapp.group.status_update",
  "apiVersion": "v2",
  "createTime": "2026-05-13T00:00:00.000Z",
  "whatsappGroup": {
    "wabaId": "123456789012345",
    "field": "group_status_update",
    "type": "group_suspend",
    "status": "suspended",
    "groupId": "Y2FwaV9ncm91cDpFWEFNUExFX0dST1VQX0lE",
    "webhookTime": "2026-05-13T00:00:00.000Z"
  }
}
```

### Respuesta

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

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

### Explicación

Enrute el evento por `type`, elimine duplicados mediante `id` y traslade el trabajo lento o propenso a errores a un procesador asíncrono.

## Suspensión de grupo levantada

Cuando se levanta la suspensión de un grupo de WhatsApp, recibirá un webhook con la siguiente estructura de payload:

### Solicitud

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "id": "evt_group_status_124",
  "type": "whatsapp.group.status_update",
  "apiVersion": "v2",
  "createTime": "2026-05-13T00:00:00.000Z",
  "whatsappGroup": {
    "wabaId": "123456789012345",
    "field": "group_status_update",
    "type": "group_suspend_cleared",
    "status": "suspend_cleared",
    "groupId": "Y2FwaV9ncm91cDpFWEFNUExFX0dST1VQX0lE",
    "webhookTime": "2026-05-13T00:00:00.000Z"
  }
}
```

### Respuesta

Confirme la recepción 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.status_update` para eventos de estado de suspensión de grupos
* **whatsappGroup**: Contiene los detalles del estado de suspensión del grupo
  * **field**: Siempre `group_status_update`
  * **type**: El tipo de evento de estado, ya sea `group_suspend` o `group_suspend_cleared`
  * **status**: El estado normalizado del grupo, ya sea `suspended` o `suspend_cleared`
  * **groupId**: El ID de grupo de WhatsApp
  * **webhookTime**: La hora en la que WhatsApp activó este webhook

<br />


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