Informer d'autres systèmes par webhook
Un webhook informe un autre système (par exemple votre archive ou votre CRM) dès qu’il se passe quelque chose dans actaSIGN, par exemple lorsqu’une demande est terminée. L’autre système récupère ensuite les détails via les liens contenus dans le message.
Configurer un webhook
Section intitulée « Configurer un webhook »
- Cliquez sur Ajouter un webhook et saisissez un Nom.
- URL du point de terminaison : l’adresse du système destinataire. Elle doit
commencer par
https://. - Événements : choisissez ce qui est signalé. Tout sélectionner coche tous les événements d’un groupe.
- Secret de signature : cliquez sur Générer un secret et transmettez immédiatement la valeur à l’intégrateur. Elle n’est affichée qu’une seule fois.
- Liens signés sans jeton API : si cette option est activée, les liens du message fonctionnent sans accès API. Choisissez alors une Durée de validité des liens aussi courte que possible.
- Cliquez sur Enregistrer.
Les événements :
| Groupe | Événements |
|---|---|
| Tâche | Tâche activée, Tâche terminée, Tâche refusée, Tâche transmise, Tâche réattribuée, Rappel envoyé |
| Demande de signature | Demande démarrée, Demande terminée, Demande révoquée, Délai expiré, Demande annulée, Demande clôturée |
Tester et surveiller
Section intitulée « Tester et surveiller »
- Ajouter un webhook
- Tester envoie un message de test à l’URL du point de terminaison.
- Suspendre met le webhook en pause sans perdre les paramètres ; Activer le réactive.
- L’icône d’horloge ouvre les envois.
Chaque envoi a un statut : En file, Envoi en cours, Envoyé ou Échec. Vous renvoyez un envoi en échec avec Relancer.
Bon à savoir
Section intitulée « Bon à savoir »- Si de nombreuses tentatives d’envoi échouent à la suite (20 par défaut), actaSIGN suspend le webhook (Suspendu). Tant qu’il est suspendu, aucun message ne lui est envoyé. Lorsque le système destinataire est de nouveau joignable, cliquez sur Réactiver. Une nouvelle URL du point de terminaison le réactive également.
- Chaque message est signé avec le secret, afin que le système destinataire puisse vérifier qu’il provient d’actaSIGN.
- Avec le crayon et la corbeille, vous modifiez ou supprimez un webhook. Après la suppression, le système ne reçoit plus de messages ; les envois en file expirent.