Webhooks
Un webhook avisa un sistema teu quan passa alguna cosa a goPrevina: es registra un incident, es completa una sessió de formació o canvia l'estat d'un requisit de compliment. goPrevina envia l'esdeveniment a la URL que indiquis, signat amb HMAC-SHA256.
1. Què hi ha a la pantalla
A dalt, el desplegable «Com verificar un enviament». Després, el bloc «Crear un webhook» amb «Nom», «URL de destinació» i els «Esdeveniments» que es poden enviar (casella «Tots els esdeveniments» i una per esdeveniment, com incident.created o training.session.completed). A sota, la llista de webhooks; si no n'hi ha cap, diu “Encara no hi ha webhooks.”. Al final, «Enviaments fallits».
2. Crear un webhook
1. Escriu un «Nom» i la «URL de destinació» (l'adreça HTTPS del teu sistema que rebrà els esdeveniments).
2. Marca «Tots els esdeveniments» o almenys un esdeveniment concret.
3. Prem «Crear un webhook».
4. Apareix la clau de signatura amb l'avís “Copia ara aquesta clau de signatura; no es tornarà a mostrar:”. Guarda-la al teu sistema i prem “Fet”: amb ella comproves que cada petició ve de goPrevina.
3. Vigilar un webhook
Quan hi ha webhooks, sobre la llista apareixen tres targetes d'estat amb el seu recompte: “Amb lliuraments fallits”, “Desactivats” i “Sense incidències”. Prem-les per filtrar la llista. Cada fila mostra el nom (un enllaç a la seva fitxa), la URL, els esdeveniments i els errors, amb la marca “desactivat” o “desactivat automàticament” si no envia.
A la dreta de cada fila hi ha botons amb icona: “Enviar prova”, “Historial de lliuraments”, “Reenviar període”, “Activar / desactivar” i “Eliminar” (demana confirmació). Prem el nom per obrir la fitxa del webhook, amb el resum i tots els seus lliuraments.
4. Enviaments fallits i reenviament d'un període
Si la teva URL falla 5 vegades seguides, goPrevina marca el webhook com a “desactivat automàticament” i deixa d'enviar: arregla el teu sistema i torna a activar-lo amb “Activar / desactivar”.
«Enviaments fallits» llista els enviaments que han fallat després de tots els reintents, amb l'esdeveniment, el webhook, l'error i la data. Quan la teva destinació funcioni un altre cop, prem “Reenviar” a la fila. Per repetir-ne molts alhora, “Reenviar període” demana “Des de” i “Fins a” (31 dies com a màxim) i torna a enviar els esdeveniments d'aquest període als quals el webhook està subscrit.
5. Què ha de fer el teu sistema
Cada esdeveniment arriba com una petició POST amb el cos en JSON i la signatura a la capçalera. El desplegable «Com verificar un enviament» mostra el càlcul de la signatura i recorda dues regles: rebutjar una marca de temps de més de 5 minuts i descartar duplicats, perquè un enviament pot arribar més d'una vegada. El teu sistema ha de respondre amb un codi 2xx; qualsevol altra resposta compta com a error, es reintenta i queda a l'historial de lliuraments.