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

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

​
Grupo suspendido

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

​
Solicitud

​
Respuesta

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

​
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

​
Respuesta

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

​
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