Los Webhooks te permiten recibir notificaciones automáticas cada vez que pasa algo relevante en tu cuenta MOGU (un viaje que se crea, una reserva nueva, un pago completado, etc.). Tu sistema podrá reaccionar al instante, sin necesidad de consultar periódicamente la plataforma.
¿Dónde encuentro los Webhooks?
Desde tu cuenta de MOGU, ve a Configuración (el icono del engranaje en el menú lateral) y haz clic en la pestaña Integraciones. Ahí verás la sección Herramientas de desarrollo con la opción Webhooks.
ℹ️ Esta funcionalidad está solo disponible para nuestros clientes Enterprise. Si aún no lo eres, contacta con [email protected] para actualizar tu plan.
Añadir endpoint
Haz clic en Añadir endpoint y rellena el formulario en dos pasos.
Paso 1 de 2: Nuevo endpoint
Nombre: un identificador que te ayude a reconocer este endpoint (por ejemplo, "Mi integración")
URL del endpoint: la dirección de tu servidor que recibirá los eventos. Solo se admiten URLs HTTPS.
Eventos a suscribir: selecciona al menos un evento de la lista.
Cuando esté todo listo, haz clic en Crear endpoint.
Paso 2 de 2: Guarda el secret de firma
¡Importante! Al crear el endpoint verás el secret de firma. ⚠️ Este secret no se volverá a mostrar. Cópialo ahora y guárdalo en un lugar seguro. Tu equipo técnico lo necesitará para verificar que cada evento viene de MOGU.
Pulsa el icono de portapapeles para copiar el secret.
Marca la casilla "He guardado el secret en un lugar seguro".
Haz clic en Hecho.
❗ Si no copias el secret ahora, tendrás que rotarlo para generar uno nuevo.
Ver y gestionar tu endpoint
Cada endpoint aparece con:
El Nombre
Los Eventos a los que está suscrito.
Un indicador de estado: Activo (verde) o Pausado (naranja).
El Último envío con su resultado (
200 OKsi fue exitoso, o el código de error recibido).
Enviar un evento de test
Para comprobar que tu endpoint está bien conectado:
En la tarjeta del endpoint, haz clic en Enviar test.
MOGU enviará un evento sintético (
webhook.test) a tu URL.Verás el resultado en pantalla: si tu servidor respondió correctamente o si hubo algún error.
💡 Puedes enviar un test incluso si el endpoint está pausado. Es útil para validar cambios de URL.
Pausar o reactivar un endpoint
Si necesitas dejar de recibir eventos temporalmente (por mantenimiento, despliegues, etc.):
Pausar: usa el interruptor de la tarjeta. Confirma en el diálogo "¿Pausar este endpoint?". Dejarás de recibir eventos hasta que lo reactives.
Reactivar: vuelve a pulsar el interruptor y confirma. Los eventos se entregarán de nuevo al instante.
⚠️ Los eventos generados mientras el endpoint esté pausado no se reenvían al reactivarlo.
Editar un endpoint
Haz clic en Editar para cambiar:
El nombre.
La URL (debe seguir siendo HTTPS).
La lista de eventos suscritos.
El secret de firma se mantiene: no necesitas reconfigurar nada en tu servidor salvo que cambies la URL.
Rotar el secret de firma
Si sospechas que tu secret se ha comprometido, o simplemente quieres rotarlo periódicamente:
Haz clic en Rotar secret.
Confirma en el diálogo.
Copia el nuevo secret y entrégaselo a tu equipo técnico.
ℹ️ Tu equipo tiene 24 horas para actualizar el secret antes de que el anterior expire. Durante ese periodo, ambos secrets son válidos, para que puedas migrar sin interrumpir la entrega de eventos.
Eliminar un endpoint
Si ya no necesitas un endpoint:
Haz clic en Eliminar.
Confirma la acción.
❗ Esta acción no se puede deshacer. Tu sistema dejará de recibir eventos de MOGU de forma inmediata.
¿Qué eventos puedo recibir?
Viajes: creación, edición y cambios guardados en el builder.
Reservas: nuevas reservas, cancelaciones y cambios de viajeros.
Pagos: pagos completados, fallidos y devueltos.
📘 Consulta el catálogo completo de eventos, la estructura de cada payload y ejemplos de código en nuestra documentación técnica: https://api-docs.moguplatform.com/webhooks
Para tu equipo técnico
Esta guía está pensada para configurar y gestionar Webhooks desde la interfaz. Si tu equipo necesita integrar los eventos en vuestro sistema, encontrará en la documentación para desarrolladores todos los detalles:
Estructura completa del payload de cada evento.
Cabeceras HTTP (`X-Mogu-Event`, `X-Mogu-Delivery`, `X-Mogu-Signature-256`).
Cómo verificar la firma HMAC-SHA256 (ejemplos en Node.js y Python).
Buenas prácticas: idempotencia, orden de eventos...
Desarrollo local con ngrok o Cloudflare Tunnel.
👉 Documentación del API de Webhooks en https://api-docs.moguplatform.com/webhooks
¿Para qué puedo usar los Webhooks?
Sincronizar reservas y pagos con tu CRM o ERP.
Disparar automatizaciones (emails, SMS, notificaciones internas).
Alimentar cuadros de mando y sistemas de analítica en tiempo real.
Integrar MOGU con cualquier sistema propio sin necesidad de consultar la API continuamente.
💡 Los Webhooks no reemplazan a nuestra API pública: la complementan. Usa los Webhooks para reaccionar a eventos, y la API para consultar o modificar datos.