Webhooks

Un webhook avisa 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 na cabeceira X-Webhook-Signature.

1. Que hai na pantalla

O bloque «Crear un webhook» con «Nome», «URL de destino» e a lista de «Eventos» que se poden enviar: «incident.created» (incidente rexistrado), «training.session.completed» (sesión de formación completada) e «compliance.status.changed» (cambio de estado de cumprimento). Debaixo, os webhooks creados; se non hai ningún, di «Aínda non hai webhooks.».

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 polo menos un evento.

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: con ela comproba que cada petición vén de goPrevina calculando o HMAC-SHA256 do corpo e comparándoo coa cabeceira X-Webhook-Signature.

3. Comprobar as entregas e desactivar

Cada webhook da lista ten “Historial de entregas” (evento, estado, intentos, código de resposta e data de cada envío), “Activar / desactivar” e “Eliminar”. Se a túa URL falla 5 veces seguidas, goPrevina márcao como “desactivado automaticamente” e deixa de enviar: arranxa o teu sistema, mira o historial e volve activalo.

4. Que recibe o teu sistema

Cada evento chega como unha petición POST co corpo en JSON e dúas cabeceiras: X-Webhook-Event, co nome do evento, e X-Webhook-Signature, coa sinatura. O teu sistema ten que responder cun código 2xx; calquera outra resposta conta como fallo, reinténtase e aparece no “Historial de entregas”.