Configurer la signature électronique

La signature électronique permet de faire signer un document en ligne : un devis du CRM, la réponse à une requête… Le module qui envoie le document ne s'occupe que de son contenu ; c'est l'écran Signature électronique qui règle le prestataire, commun à tous les modules.

Sans prestataire, rien ne change pour l'utilisateur : le client renvoie le document signé, que l'on joint à la main.

Choisir le prestataire

Le prestataire proposé aujourd'hui est Documenso, un service open source, hébergé par l'éditeur ou installé chez vous.

1. Ouvrez Signature électronique.
2. Choisissez Documenso dans Prestataire.
3. Indiquez l'adresse de Documenso : https://app.documenso.com pour le service hébergé, ou l'adresse de votre installation. L'adresse doit commencer par https://.
4. Collez le jeton d'API, créé dans Documenso (paramètres du compte, jetons d'API).
5. Enregistrez, puis cliquez Tester la connexion.

Le jeton n'est jamais réaffiché. Laissez le champ vide pour le garder, ou cochez Effacer pour le supprimer.

Changer l'adresse sans ressaisir le jeton efface le jeton enregistré : il ne part jamais vers un autre serveur que celui pour lequel il a été saisi. Ressaisissez-le après un changement d'adresse.

Déclarer le webhook

Le webhook prévient MyZapp dès qu'un document est signé, refusé ou annulé.

1. Dans Documenso, créez un webhook vers l'adresse affichée sur l'écran (Adresse du webhook à déclarer dans Documenso).
2. Choisissez les événements : document terminé, refusé, annulé.
3. Choisissez un secret et recopiez-le dans Secret du webhook.

Sans secret, aucun webhook n'est accepté : l'état des documents est alors relevé toutes les 15 minutes. Le relevé fonctionne aussi quand un webhook s'est perdu.

Suivre les documents

L'écran liste les derniers documents envoyés en signature : le module qui les a envoyés, les signataires, l'état, et si le module a bien été prévenu.

• Signé : le document signé est conservé dans les fichiers, et le module en tient compte (par exemple, le devis passe à « accepté »).
• Refusé, annulé ou expiré : le module est prévenu de la même façon.
• Module prévenu : en attente : la notification sera retentée automatiquement. L'erreur affichée aide à comprendre un échec qui dure.

Le journal retrace l'envoi, les changements d'état, la récupération du document signé et les notifications.