Webhooks
Un webhook avisa a un sistema teu en canto ocorre algo en goPrevina: rexístrase un incidente, complétase unha sesión de formación ou cambia o estado dun requisito de cumprimento. goPrevina envía o evento á URL que indiques, asinado con HMAC-SHA256.
1. Que hai na pantalla
Arriba, o despregable «Como verificar un envío». Despois, o bloque «Crear un webhook» con «Nome», «URL de destino» e os «Eventos» que se poden enviar (caixa «Todos os eventos» e unha por evento, como incident.created ou training.session.completed). Debaixo, a lista de webhooks; se non hai ningún, di “Aínda non hai webhooks.”. Ao final, «Envíos fallidos».
2. Crear un webhook
1. Escribe un «Nome» e a «URL de destino» (o enderezo HTTPS do teu sistema que recibirá os eventos).
2. Marca «Todos os eventos» ou polo menos un evento concreto.
3. Preme «Crear un webhook».
4. Aparece a clave de sinatura co aviso “Copia agora esta clave de sinatura; non se volverá mostrar:”. Gárdaa no teu sistema e preme “Feito”: con ela compróbase que cada petición vén de goPrevina.
3. Vixiar un webhook
Cando hai webhooks, sobre a lista aparecen tres tarxetas de estado co seu reconto: “Con entregas fallidas”, “Desactivados” e “Sen incidencias”. Preméas para filtrar a lista. Cada fila amosa o nome (unha ligazón á súa ficha), a URL, os eventos e os fallos, coa marca “desactivado” ou “desactivado automaticamente” se non envía.
Á dereita de cada fila hai botóns con icona: “Enviar proba”, “Historial de entregas”, “Reenviar período”, “Activar / desactivar” e “Eliminar” (pide confirmación). Preme o nome para abrir a ficha do webhook, co resumo e todas as súas entregas.
4. Envíos fallidos e reenvío dun período
Se a túa URL falla 5 veces seguidas, goPrevina marca o webhook como “desactivado automaticamente” e deixa de enviar: arranxa o teu sistema e volve activalo con “Activar / desactivar”.
«Envíos fallidos» lista os envíos que fallaron tras todos os reintentos, co evento, o webhook, o erro e a data. Cando o teu destino funcione outra vez, preme “Reenviar” na fila. Para repetir moitos á vez, “Reenviar período” pide “Desde” e “Ata” (31 días como máximo) e volve enviar os eventos dese período aos que o webhook está subscrito.
5. Que debe facer o teu sistema
Cada evento chega como unha petición POST co corpo en JSON e a sinatura na cabeceira. O despregable «Como verificar un envío» amosa o cálculo da sinatura e lembra dúas regras: rexeitar unha marca de tempo de máis de 5 minutos e descartar duplicados, porque un envío pode chegar máis dunha vez. O teu sistema ten que responder cun código 2xx; calquera outra resposta conta como fallo, reintenta e queda no historial de entregas.