Recibir alertas instantáneas cuando un empleado hace clic en un enlace de phishing o ingresa credenciales, sin necesidad de entrar a la plataforma.
Integrar Whalemate con tu SIEM, plataforma de seguridad, LMS o herramientas de comunicación interna como Slack o Microsoft Teams.
Mantener dashboards externos actualizados con los resultados de campañas en tiempo real.
Automatizar respuestas ante incidentes de concienciación sin intervención manual.
Eliminar la necesidad de consultar la API periódicamente: Whalemate envía los datos a tu sistema cuando ocurren.
Navegación: Configuración → Integraciones → tarjeta Webhooks → Configurar
Crear un webhook:
Haz clic en Nuevo Webhook.
Completa el Nombre del webhook y la URL del endpoint (debe comenzar con https://).
En Eventos a suscribir, elige uno o más de los cinco eventos disponibles (Enviado, Abierto, Clic, Credenciales capturadas, Reportado), o usa Seleccionar todo.
Haz clic en Guardar Webhook.
El secreto HMAC se muestra una única vez al guardar. Cópialo y guárdalo: no se puede recuperar después. Tu sistema lo necesita para validar que las notificaciones vienen de Whalemate.
Administrar un webhook:
Editar: modifica nombre, URL o eventos suscritos. Desde ahí también puedes Rotar secreto (invalida el anterior de inmediato) o Eliminar el webhook.
Probar: envía un payload de prueba y muestra el resultado en la misma pantalla — éxito (HTTP 200 · {ms} ms), error HTTP (HTTP {código} · {ms} ms), o "Sin respuesta" ante timeout o error de conexión.
Desactivar / Activar: pausa o reanuda las notificaciones.
El envío de prueba no es un evento de campaña. Llega con
"event": "webhook.test"y"test": true, y con los campos de campaña y de empleado vacíos. Si tu receptor valida el nombre del evento contra la lista de los cinco reales, va a rechazar la prueba aunque esté todo bien configurado. El detalle del payload de prueba está en la Guía técnica de integración.
⚠️ Si un endpoint acumula 20 fallos consecutivos, Whalemate lo deshabilita automáticamente (badge rojo "Deshabilitado" + cantidad de fallos) y le avisa por notificación a la persona que creó el webhook. Al hacer clic en Activar, los envíos se reanudan sin verificación previa y el contador de fallos se resetea a cero. Te recomendamos usar Probar antes de reactivar para confirmar que el endpoint responde con 2xx.
Reintentos automáticos
Si tu servidor no responde con un código 2xx o supera el tiempo límite, Whalemate reintenta automáticamente con el siguiente esquema:
Intento
Espera
1 (envío original)
—
2
1 minuto
3
5 minutos
4
30 minutos
5 (último)
2 horas
Después del intento 5, la entrega queda en estado fallido
Whalemate no sigue redirecciones. Si tu endpoint responde con un
301o un302, la entrega cuenta como fallida: la URL que configures tiene que ser la definitiva.
Si tu endpoint acumula 20 fallos consecutivos, Whalemate lo desactiva automáticamente. Para volver a activarlo: resuelve el problema en tu servidor, usa Probar para confirmar que responde
2xx, y después Activar. Lo puedes hacer tú desde la misma pantalla, sin escribirnos.
¿Puedo recibir el mismo evento más de una vez?
Sí, en casos excepcionales de red Whalemate puede entregar el mismo evento dos veces. Para evitar procesarlo duplicado, usa el campo X-Whalemate-Delivery-Id como clave de idempotencia en tu sistema.
¿Qué pasa con los eventos que ocurrieron mientras mi endpoint estuvo desactivado?
No se retroalimentan automáticamente. Si necesitas esos datos, puedes consultarlos a través de la API REST de Whalemate.
¿Por qué mi endpoint fue desactivado?
Whalemate deshabilita automáticamente los endpoints que acumulan 20 entregas fallidas consecutivas, y avisa por notificación a quien creó el webhook. Al reactivarlo con Activar, los envíos se reanudan sin verificación previa (el contador de fallos se resetea). Si el endpoint sigue caído, va a volver a acumular fallos y se deshabilita de nuevo a los 20. Te recomendamos usar Probar antes de reactivar para confirmar que responde 2xx.
Apreté Probar y mi servidor rechazó el envío.
Revisa cómo valida tu receptor el campo event: la prueba llega como webhook.test, no como uno de los cinco eventos de campaña, y con los datos de campaña y empleado vacíos. Tampoco lleva el header X-Whalemate-Delivery-Id, que sí viaja en las entregas reales.
¿Tienes feedback o quieres solicitar mejoras? Háznoslo saber en roadmap.whalemate.com/roadmap
