Ejemplos de Webhook de actualización de configuración de grupos de WhatsApp

Para consultar el catálogo exhaustivo derivado del esquema, consulta todos los ejemplos.

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

Para la configuración del endpoint, la validación de firmas y el comportamiento de reintentos, consulta Configurar webhooks.

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

{
  "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/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

{
  "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/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

Primeros pasos

Guías

Endpoints

Webhooks

Ejemplos de Webhook de actualización de configuración de grupos de WhatsApp

Qué es

Antes de comenzar

Cómo funciona

Solicitud

Respuesta

Configuración actualizada

Solicitud

Respuesta

Explicación

Error al actualizar la configuración

Solicitud

Respuesta

Explicación

​Qué es

​Antes de comenzar

​Cómo funciona

​Solicitud

​Respuesta

​Configuración actualizada

​Solicitud

​Respuesta

​Explicación

​Error al actualizar la configuración

​Solicitud

​Respuesta

​Explicación

Qué es

Antes de comenzar

Cómo funciona

Solicitud

Respuesta

Configuración actualizada

Solicitud

Respuesta

Explicación

Error al actualizar la configuración

Solicitud

Respuesta

Explicación