Webhooks
Un webhook avisa a un sistema tuyo en cuanto ocurre algo en goPrevina: se registra un incidente, se completa una sesión de formación o cambia el estado de un requisito de cumplimiento. goPrevina envía el evento a la URL que indiques, firmado con HMAC-SHA256.
Estas guías se publican de momento en castellano. Dentro de la aplicación, la misma ayuda está en castellano, catalán, gallego, euskera, inglés y francés.
1. Qué hay en la pantalla
Arriba, el desplegable «Cómo verificar un envío». Después, el bloque «Crear un webhook» con «Nombre», «URL de destino» y los «Eventos» que se pueden enviar (casilla «Todos los eventos» y una por evento, como incident.created o training.session.completed). Debajo, la lista de webhooks; si no hay ninguno, dice “Todavía no hay webhooks.”. Al final, «Envíos fallidos».
2. Crear un webhook
1. Escribe un «Nombre» y la «URL de destino» (la dirección HTTPS de tu sistema que recibirá los eventos).
2. Marca «Todos los eventos» o al menos un evento concreto.
3. Pulsa «Crear un webhook».
4. Aparece la clave de firma con el aviso “Copia ahora esta clave de firma; no volverá a mostrarse:”. Guárdala en tu sistema y pulsa “Listo”: con ella compruebas que cada petición viene de goPrevina.
3. Vigilar un webhook
Cuando hay webhooks, encima de la lista aparecen tres tarjetas de estado con su recuento: “Con entregas fallidas”, “Desactivados” y “Sin incidencias”. Púlsalas para filtrar la lista. Cada fila muestra el nombre (es un enlace a su ficha), la URL, los eventos y los fallos, con la marca “desactivado” o “desactivado automáticamente” si no envía.
A la derecha de cada fila hay botones con icono: “Enviar prueba”, “Historial de entregas”, “Reenviar periodo”, “Activar / desactivar” y “Eliminar” (pide confirmación). Pulsa el nombre para abrir la ficha del webhook, con el resumen y todas sus entregas.
4. Envíos fallidos y reenvío de un periodo
Si tu URL falla 5 veces seguidas, goPrevina marca el webhook como “desactivado automáticamente” y deja de enviar: arregla tu sistema y vuelve a activarlo con “Activar / desactivar”.
«Envíos fallidos» lista los envíos que fallaron tras todos los reintentos, con el evento, el webhook, el error y la fecha. Cuando tu destino funcione otra vez, pulsa “Reenviar” en la fila. Para repetir muchos de una vez, “Reenviar periodo” pide “Desde” y “Hasta” (31 días como máximo) y vuelve a enviar los eventos de ese periodo a los que el webhook está suscrito.
5. Qué debe hacer tu sistema
Cada evento llega como una petición POST con el cuerpo en JSON y la firma en la cabecera. El desplegable «Cómo verificar un envío» muestra el cálculo de la firma y recuerda dos reglas: rechazar una marca de tiempo de más de 5 minutos y descartar duplicados, porque un envío puede llegar más de una vez. Tu sistema tiene que responder con un código 2xx; cualquier otra respuesta cuenta como fallo, se reintenta y queda en el historial de entregas.