Signature Iframe ou Intégrée

Intégrez/iframez la page de signature dans votre propre application.

Mise à jour - composant JS pour l'édition et la signature bientôt disponible. Contactez-nous.

Liens directs

Si vous avez besoin d'une page ouverte simple ne nécessitant aucune personnalisation, où n'importe qui peut aller et signer un document (et éventuellement confirmer son e-mail par la suite), essayez Legalesign Link. Vous pouvez les créer dans l'application web sans codage. Ils sont également intégrables. Des exemples de liens peuvent être l'inscription à un événement, les feuilles de temps, les décharges de responsabilité. En savoir plus sur Legalesign Link (pages de signature intégrables).

API

Si vous devez personnaliser le document ou nécessitez plus de fonctionnalités, utilisez l'API.

Contraintes

Appareils

Cela concerne les documents basés sur PDF (et non les documents basés sur text/html).

• les contextes desktop fonctionnent bien
• les contextes mobiles fonctionnent pour des documents simples (c’est-à-dire une signature, pas des formulaires complexes)
• les contextes mobiles avec un formulaire complexe peuvent ne pas bien fonctionner (surtout pour les iPhones) et nous vous recommandons de rediriger l’utilisateur vers une nouvelle fenêtre de navigateur (vous pouvez masquer cela en supprimant la surcharge de la page de signature et en effectuant une redirection, voir ci-dessous).

Bien que cette dernière option ne soit pas une expérience utilisateur fluide, elle garantira une expérience fiable pour vos utilisateurs. À notre connaissance, il n’est pas possible d’être sûr de la taille de l’appareil de l’utilisateur depuis une fenêtre iframe (sur certains ou tous les iPhones), ce qui rend la navigation propre autour d’un formulaire complexe peu fiable.

Norme de signature

Un second avertissement : sans une certaine planification, vous ne pourrez pas atteindre la norme de signature électronique « avancée ».

Les principes clés de cette norme incluent :

• votre signataire doit avoir le contrôle exclusif du processus de signature et
• il doit être identifiable de manière unique.

En recevant le lien de signature vous-même, vous pouvez signer le document ; le contrôle exclusif est perdu.

Une solution pourrait être d’ajouter une validation SMS pour votre destinataire. La réception de ce SMS sera sous le contrôle exclusif de votre destinataire et l’identifiera de manière unique.

Vous devrez planifier quels contrôles sont en place pour garantir que le signataire est identifiable et en contrôle exclusif de votre côté pour retrouver cette norme « avancée ». En savoir plus sur la législation relative aux signatures électroniques.

Comment créer un lien de signature intégrable

Vous aurez suivi le tutoriel de démarrage rapide et créé/envoyé avec succès un document à signer.

1. Il suffit d’ajouter l’attribut suivant à votre requête POST qui crée/envoie un document (c’est-à-dire /api/v1/document/) :

{return_signer_links: true}

2. Lisez le CORPS de la réponse et vous trouverez un objet JSON contenant les liens de signature pour chacun des destinataires de votre document.

3. Placez le lien de signature à l’intérieur d’un élément iframe.

Autres attributs utiles

• Pour supprimer tous les e-mails Legalesign, dans le POST vers /api/v1/document/ réglez cet attribut : {do_email: false}.

• Pour rediriger l’utilisateur immédiatement après la signature ajoutez cet attribut : {redirect: yourUrl } (voir plus bas).

• Pour supprimer la surcharge de la page de signature, ajoutez cette chaîne de requête au lien de signature : &hidenav=1&hidetext=1

Consultez tous les attributs d’envoi de document ici : Appel API Envoyer Document

Facteur Safari

Si vous attendez des utilisateurs de Safari, vous devrez peut-être ajouter un « correctif » avec un petit morceau de javascript.

Les paramètres de sécurité par défaut de Safari interdisent les cookies dans les iframes. Si vous souhaitez gérer cela sans perturber l’utilisateur, vous devrez a) nous envoyer votre domaine racine, et b) exécuter un javascript avant que l’iframe ne soit chargé – cliquez ici pour le code (désolé pour le jquery, vous devriez pouvoir l’ajuster selon vos besoins). Dans le js vous devrez ajouter des paramètres à l’URL requêtée. Si cela n’est pas clair dans l’exemple de code, contactez-nous pour assistance.

Safari rend de plus en plus difficile l’utilisation des iframes.

Si vous voulez garantir que les iframes fonctionnent dans Safari, vous devrez utiliser notre nouvelle fonctionnalité CNAME. Cela placera les pages de signature dans un sous-domaine de votre domaine principal. Cette fonctionnalité est encore en bêta, contactez-nous si vous souhaitez l’utiliser.

La meilleure alternative est de faire sortir les utilisateurs vers une nouvelle fenêtre de navigateur, après avoir défini une URL de redirection après signature sur le document pour les ramener à la fin (voir ci-dessous).

Signaux post-achèvement

Il existe deux façons de prendre le contrôle après une signature.

• Définir une URL de redirection sur votre document lors de sa création. Legalesign redirigera l’utilisateur vers votre URL après avoir complété le document, ou
• utiliser la fonctionnalité javascript postMessage.

URL de redirection

Il suffit d’ajouter votre URL de redirection à l’attribut 'redirect' de la requête POST qui crée le document (/api/v1/document/).

Comme la redirection est par document (et non par personne), Legalesign ajoutera une chaîne de requête à votre URL de redirection que vous pouvez utiliser pour recueillir des informations sur le document et les états du signataire :

[votre URL]?signer=[signer UID]&doc=[doc UID]&group=[group UID]&signer_state=[signer status]&doc_state=[doc state]

Cliquez sur ces liens pour voir la table de référence pour le statut du document et le statut du signataire.

postMessage

Un postMessage est un message envoyé via javascript que vous pouvez recevoir dans votre cadre parent. Vous pouvez ensuite utiliser ces messages pour effectuer des redirections ou recharger la page selon les besoins.

Après signature, vous recevrez immédiatement un des trois messages javascript postMessage possibles : 'waiting’, 'signed’, 'rejected’.

Si le document a été signé et que vous laissez le processus de signature continuer et permettre la page de téléchargement de s’afficher dans votre iframe, vous recevrez aussi le message 'download’ si le bouton de téléchargement du document est cliqué.

Vous recevrez un message 'waiting’ si vous avez plus d’un signataire et que le document doit encore être signé par d’autres personnes.

Pour plus d’informations sur postMessage voir : https://developer.mozilla.org/en-US/docs/Web/API/Window/postMessage.

Si vous avez l’intention de rediriger le signataire, soyez conscient qu’il ou elle pourra brièvement voir une nouvelle page s’afficher (la page 'download' ou la page 'waiting for others') avant que votre redirection via postMessage ne prenne effet.

Suivant.

Après une signature, vous pouvez télécharger le document PDF final. Nous recommandons d’utiliser les webhooks pour cela. En savoir plus sur les webhooks. Consultez la documentation pour l’appel API permettant de télécharger un PDF final. Évitez d’effectuer immédiatement le téléchargement après un événement de signature (en utilisant les signaux post-signature ci-dessus), le PDF final peut ne pas être prêt. Plus fiable, écoutez le webhook où l’objet est ‘document’ et l’événement est ‘finalPdfCreated’.