Webhooks
Un webhook prévient l’un de vos systèmes dès que quelque chose se produit dans goPrevina : un incident est enregistré, une session de formation est terminée ou l’état d’une exigence de conformité change. goPrevina envoie l’événement à l’URL indiquée, signé avec HMAC-SHA256.
1. Ce qui figure à l’écran
En haut, la liste déroulante « Vérifier un envoi ». Ensuite, le bloc « Créer un webhook » avec « Nom », « URL cible » et les « Événements » qui peuvent être envoyés (une case « Tous les événements » et une par événement, comme incident.created ou training.session.completed). En dessous, la liste des webhooks ; s’il n’y en a aucun, le message « Aucun webhook pour l'instant. » s’affiche. À la fin, « Envois en échec ».
2. Créer un webhook
1. Saisissez un « Nom » et l’« URL cible » (l’adresse HTTPS de votre système qui recevra les événements).
2. Cochez « Tous les événements » ou au moins un événement précis.
3. Cliquez sur « Créer un webhook ».
4. Le secret de signature apparaît avec l’avis “Copiez ce secret de signature maintenant — il ne sera plus affiché :”. Conservez-le dans votre système et cliquez sur “Terminé” : il sert à vérifier que chaque requête vient de goPrevina.
3. Surveiller un webhook
Quand il y a des webhooks, trois cartes d’état avec leur nombre apparaissent au-dessus de la liste : “Avec des envois échoués”, “Désactivés” et “Sans incident”. Cliquez dessus pour filtrer la liste. Chaque ligne affiche le nom (un lien vers sa fiche), l’URL, les événements et les échecs, avec la mention “désactivé” ou “désactivé automatiquement” s’il n’envoie pas.
À droite de chaque ligne se trouvent des boutons à icône : “Envoyer un test”, “Historique des envois”, “Rejouer une période”, “Activer / désactiver” et “Supprimer” (avec confirmation). Cliquez sur le nom pour ouvrir la fiche du webhook, avec son résumé et tous ses envois.
4. Envois en échec et nouvel envoi d’une période
Si votre URL échoue 5 fois de suite, goPrevina marque le webhook “désactivé automatiquement” et cesse d’envoyer : corrigez votre système et réactivez-le avec “Activer / désactiver”.
« Envois en échec » liste les envois qui ont échoué après tous les essais, avec l’événement, le webhook, l’erreur et la date. Quand votre destination fonctionne de nouveau, cliquez sur “Renvoyer” sur la ligne. Pour en répéter beaucoup à la fois, “Rejouer une période” demande “Du” et “Au” (31 jours au maximum) et renvoie les événements de cette période auxquels le webhook est abonné.
5. Ce que doit faire votre système
Chaque événement arrive sous forme de requête POST avec un corps JSON et la signature dans l’en-tête. La liste déroulante « Vérifier un envoi » montre le calcul de la signature et rappelle deux règles : refuser un horodatage de plus de 5 minutes et écarter les doublons, car un envoi peut arriver plus d’une fois. Votre système doit répondre par un code 2xx ; toute autre réponse compte comme un échec, est retentée et reste dans l’historique des envois.