Para consultar el catálogo exhaustivo derivado del esquema, consulte todos los ejemplos.
Qué es
Explore guías paso a paso de webhooks específicos para cada evento, requisitos previos y ejemplos de payload.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 HTTPPOST cuando ocurre el evento. Verifique la firma, registre el evento de forma duradera, devuelva una respuesta 2xx y procese las tareas lentas de forma asíncrona.
Solicitud
Los escenarios a continuación muestran las solicitudes entregadas a su URL de webhook. Trate elid del evento como el identificador de entrega y use type para enrutar el payload.
Respuesta
Devuelva un estado2xx tras aceptar el evento.
Para la configuración de endpoints, la validación de firmas y el comportamiento de reintentos, consulte Configurar webhooks.
Eventos de mensajes y plantillas
Revisión de plantillas
Gestione estados de plantilla aprobados, rechazados, pausados, deshabilitados y archivados.
Estado del mensaje
Gestione mensajes salientes enviados, entregados, leídos y fallidos.
Mensajes entrantes
Analice mensajes de texto, multimedia, ubicación, contacto, interactivos, de comercio y del sistema.
Actualizaciones de pagos
Procese cambios en las transacciones de pago de WhatsApp.
Eventos de eco y transferencia de agentes
Para los agentes incorporados a través de la API REST pública, utilice estas guías específicas para cada evento. Los agentes creados desde la consola utilizan un flujo de sincronización de bandeja de entrada independiente.Mensaje de eco creado
Almacene ecos salientes de texto y multimedia.
Mensaje de eco actualizado
Gestione actualizaciones de estado de entregado, leído, enviado tarde y fallido.
Transferencia de agente actualizada
Observe la transferencia de control y comprenda sus límites de correlación.
Eventos de cuenta, aplicación y Flow
Actualizaciones de cuenta comercial
Gestione cambios de elegibilidad, ubicación, infracciones, restricciones y estado de la cuenta.
Historial de Business App
Sincronice el historial de mensajes entrantes y salientes.
Ecos de mensajes de Business App
Sincronice los mensajes enviados desde la aplicación WhatsApp Business.
Estado de Flow
Procese cambios de estado en el ciclo de vida de Flow.
Eventos de llamadas y grupos
Conexión de llamada
Gestione ofertas y respuestas SDP para llamadas de WhatsApp.
Estado de llamada
Gestione estados de llamada sonando, aceptada y rechazada.
Finalización de llamada
Gestione la finalización de llamadas completadas y fallidas.
Ciclo de vida del grupo
Gestione la creación y eliminación de grupos.
Participantes del grupo
Gestione cambios de participantes y solicitudes de unión.
Configuración del grupo
Gestione cambios en el asunto y la descripción del grupo.
Estado del grupo
Gestione la suspensión y el restablecimiento de grupos.
Eventos de contacto
Contacto creado
Procese contactos recién creados.
Contacto eliminado
Elimine o concilie contactos eliminados.
Atributos de contacto modificados
Procese cambios de perfil, atributos personalizados y etiquetas.
Contacto dado de baja
Gestione registros de exclusión voluntaria recién creados.
Contacto suscrito de nuevo
Gestione registros de exclusión voluntaria eliminados.
Abrir el catálogo completo de payloads
Explore cada tipo de evento y todos los ejemplos de payload nombrados de la especificación OpenAPI.