Intégrations

Intégrez VG·Sign à vos outils.

Publiez les événements de vos dossiers dans un canal Slack ou Microsoft Teams, ou envoyez du JSON signé à n’importe quelle adresse HTTPS, y compris Zapier, Make et n8n. Tout se règle dans Paramètres, sous Intégrations.

Sur cette page

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

  1. Dans Slack, ouvrez Apps, puis Incoming Webhooks, cliquez sur Add to Slack, choisissez un canal et copiez l’adresse que Slack vous donne.
  2. Dans VG·Sign, sous Adresses de webhook, cliquez sur Ajouter une adresse et choisissez Slack.
  3. Collez l’adresse dans Adresse de réception. Elle doit être une adresse hooks.slack.com. Nom (facultatif) vous aide à distinguer vos adresses.
  4. 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

  1. Dans Teams, ouvrez Workflows et choisissez Post to a channel when a webhook request is received. Power Automate vous donne une adresse.
  2. Dans VG·Sign, cliquez sur Ajouter une adresse et choisissez Microsoft Teams.
  3. Collez l’adresse. Elle doit être celle du flux sur logic.azure.com. Les locataires gouvernementaux sur logic.azure.us ne sont pas acceptés.
  4. 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ête X-VG-Delivery-Id qui 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.

  1. Dans Zapier, Make ou n8n, commencez un flux de travail avec un déclencheur webhook et copiez son adresse.
  2. Dans VG·Sign, cliquez sur Ajouter une adresse, gardez Adresse HTTPS, collez l’adresse et cochez vos événements.
  3. Cliquez sur Enregistrer l’adresse, puis sur Envoyer un essai pour envoyer un événement d’essai à la nouvelle adresse.

Retour au centre d’aide

  • Bâtissez avec les mêmes briques que nous.

    L’API REST de VG·Sign crée, envoie et suit les dossiers avec un jeton d’espace. Elle est incluse avec Pro, Équipe et Entreprise, et la référence complète se trouve sur la page de l’API.

    Lire
  • Préparez une fois, envoyez toujours.

    Un modèle garde les documents d’un dossier, la disposition des champs et les rôles de signature. Entrez les noms et les courriels pour créer un nouveau dossier, ou envoyez un dossier pour chaque ligne d’un fichier CSV.

    Lire