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

​
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.
Para la configuración de endpoints, la validación de firmas y el comportamiento de reintentos, consulta Configurar webhooks.

​
Grupo creado

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

​
Solicitud

​
Respuesta

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

​
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

​
Respuesta

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

​
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