Les adresses de webhook sont gérées par le propriétaire de l’espace dans Paramètres, Intégrations, avec tous les forfaits. Un espace peut avoir jusqu’à 10 adresses. Le jeton d’API sur la même page exige Pro, Équipe ou Entreprise. Voir API et développeurs.
Slack
- Dans Slack, ouvrez
Apps, puisIncoming Webhooks, cliquez surAdd to Slack, choisissez un canal et copiez l’adresse que Slack vous donne. - Dans VG·Sign, sous Adresses de webhook, cliquez sur Ajouter une adresse et choisissez Slack.
- Collez l’adresse dans Adresse de réception. Elle doit être une adresse
hooks.slack.com. Nom (facultatif) vous aide à distinguer vos adresses. - Cochez les événements voulus, cliquez sur Enregistrer l’adresse, puis sur Envoyer un essai. L’essai part en moins d’une minute.
Chaque message nomme l’événement et le dossier, et renvoie à son journal d’audit dans VG·Sign.
Microsoft Teams
- Dans Teams, ouvrez
Workflowset choisissezPost to a channel when a webhook request is received. Power Automate vous donne une adresse. - Dans VG·Sign, cliquez sur Ajouter une adresse et choisissez Microsoft Teams.
- Collez l’adresse. Elle doit être celle du flux sur
logic.azure.com. Les locataires gouvernementaux surlogic.azure.usne sont pas acceptés. - Cochez vos événements, cliquez sur Enregistrer l’adresse et sur Envoyer un essai.
VG·Sign envoie une carte adaptative, que le flux publie dans le canal.
Webhooks
Choisissez Adresse HTTPS pour recevoir les événements dans votre propre système.
- L’adresse doit utiliser https et être joignable depuis Internet. Les adresses locales et de réseau privé sont refusées.
- Il y a 19 types d’événements en trois groupes : Vie du dossier, Activité des destinataires et Identité. Une nouvelle adresse commence avec Envoyé aux destinataires, Terminé, Refusé et Annulé cochés. Les événements marqués Fréquent peuvent se produire plusieurs fois pour un même dossier.
- Après l’enregistrement, la clé apparaît sous Clé secrète, affichée une seule fois. Copiez-la à ce moment. Remplacer la clé en crée une nouvelle.
- Chaque livraison est une requête POST en JSON avec un en-tête
X-VG-Signature,sha256=suivi d’un HMAC-SHA256 du corps brut calculé avec cette clé, et un en-têteX-VG-Delivery-Idqui reste le même d’un essai à l’autre. - Une livraison échouée est tentée jusqu’à 3 fois, puis marquée comme échouée. Les cinq dernières livraisons sont listées sous chaque adresse, et une livraison échouée a un bouton Renvoyer. Mettre en pause arrête les livraisons sans supprimer l’adresse.
Le contenu envoyé est décrit sur la page Webhooks.
Zapier, Make et n8n
Ces outils se connectent par webhook : chacun peut lancer un flux de travail à partir d’une adresse de réception, que VG·Sign traite comme n’importe quelle autre adresse HTTPS.
- Dans Zapier, Make ou n8n, commencez un flux de travail avec un déclencheur webhook et copiez son adresse.
- Dans VG·Sign, cliquez sur Ajouter une adresse, gardez Adresse HTTPS, collez l’adresse et cochez vos événements.
- Cliquez sur Enregistrer l’adresse, puis sur Envoyer un essai pour envoyer un événement d’essai à la nouvelle adresse.