> ## 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 configuración de grupos de WhatsApp

> Gestiona las actualizaciones del asunto y la descripció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 las actualizaciones del asunto y la descripció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.
* Guarda 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 escenarios a continuación muestran solicitudes enviadas a tu URL de webhook. Trata el evento `id` como el identificador de entrega y utiliza `type` para enrutar el payload.

## 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 del endpoint, la validación de firmas y el comportamiento de reintentos, consulta [Configurar webhooks](/es/api-reference/guides/api-fundamentals/configure-webhooks).</Note>

<br />

## Configuración actualizada

Cuando la configuración del grupo de WhatsApp se actualiza correctamente, recibirás un webhook con la siguiente estructura de payload:

### Solicitud

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

### Respuesta

Confirma 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 el trabajo lento o propenso a errores a un procesador asíncrono.

## Error al actualizar la configuración

Cuando la actualización de la configuración de un grupo de WhatsApp falla o falla parcialmente, recibirás un webhook con la siguiente estructura de payload:

### Solicitud

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

### Respuesta

Confirma 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.settings_update` para eventos de configuración de grupos
* **whatsappGroup**: Contiene los detalles del resultado de la actualización de la configuración del grupo
  * **field**: Siempre `group_settings_update`
  * **type**: Siempre `group_settings_update`
  * **requestId**: El ID de solicitud devuelto por la operación asíncrona de la API de configuración de grupos
  * **status**: El estado normalizado de actualización de la configuración, ya sea `updated` o `failed`
  * **groupId**: El ID del grupo de WhatsApp
  * **subject** y **description**: Los ajustes de texto del grupo cuando estén presentes
  * **settings**: Resultados de actualización por ajuste individual. `name` puede ser `profile_picture`, `group_subject` o `group_description`
  * **settings\[].updateSuccessful**: Indica si la actualización del ajuste individual se realizó correctamente
  * **settings\[].errors**: Errores devueltos por WhatsApp para el ajuste individual

<br />


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