Intégrations du SPA

1. Ce que contient l’écran

En haut, le titre «Intégrations» et le bouton «Nouveau webhook». En dessous, trois onglets : «Clients», «Webhooks» et «Propres». «Clients» s’ouvre avec quatre cartes d’état («Avec erreurs», «Avec avertissements», «Correct» et «Sans intégrations»), un champ de recherche et une ligne par client avec «Client», «État», «Intégrations», «Synchronisations», «Webhooks» et «Clés API».

2. Voir quels clients ont des problèmes

«Avec erreurs» compte les clients ayant une intégration en erreur ou expirée, une synchronisation échouée ou une alerte ouverte. «Avec avertissements» compte ceux qui ont un webhook en échec, des envois échoués ou des clés API expirées ou qui expirent dans 30 jours. «Correct» sont ceux qui ont des intégrations dont aucune n’échoue ; «Sans intégrations», ceux qui n’ont encore rien configuré. Une intégration ou une synchronisation désactivée ne compte pas comme un échec.

Appuyez sur une carte pour filtrer la liste et appuyez de nouveau pour retirer le filtre. La recherche filtre par nom de client. Les clients avec des problèmes passent en premier et chaque ligne indique ce qui échoue. Le nom ouvre la fiche de l’entreprise ; le menu de la ligne contient “Ouvrir l'entreprise”.

3. Créer un webhook

1. Appuyez sur «Nouveau webhook».

2. Saisissez le “Nom” et l’“URL de destination” (une adresse publique en https://), et choisissez les “Événements” : “Tous les événements” ou ceux dont vous avez besoin.

3. Appuyez sur “Créer le webhook”.

4. “Secret de signature” s’ouvre : copiez-le avec le bouton de copie et appuyez sur “Je l'ai copié”. Il ne s’affiche plus ensuite ; votre système s’en sert pour vérifier que chaque envoi vient de goPrevina.

Chaque webhook reçoit les événements de tous vos clients avec un accord en vigueur et chaque envoi indique l’entreprise d’origine.

4. Surveiller et entretenir les webhooks

Dans «Webhooks», trois cartes (“En échec”, “Inactifs” et “Corrects”) filtrent la liste, avec les mêmes règles que la file de travail de l’entreprise. Chaque ligne montre l’adresse, l’état, le “Dernier envoi réussi” et les “Envois échoués”. Après 5 échecs de suite, goPrevina désactive le webhook lui-même : réparez votre système et réactivez-le.

Le menu de la ligne contient “Ouvrir”, “Modifier”, “Envoyer un test”, “Renvoyer des événements…”, “Activer” ou “Désactiver” et “Supprimer” (demande confirmation). “Renvoyer des événements…” ouvre un panneau avec “Du” et “Au” : il renvoie les événements de cette période auxquels le webhook est abonné, 31 jours au maximum ; si vous ne changez rien, ce sont les dernières 24 heures.

5. Intégrations propres du SPA

Dans «Propres», on consulte l’authentification unique, DocuSign et Adobe Sign du SPA, avec leur état et la date de la dernière vérification. Une intégration en erreur ou expirée apparaît en rouge avec son dernier message d’erreur.