Expériences

Une Expérience contrôle tout ce que le signataire voit et reçoit lorsqu'on lui envoie un document — les emails, la page de signature, le branding et le comportement. Chaque groupe possède au moins une Expérience (par défaut), et vous pouvez créer plusieurs Expériences pour différents cas d’utilisation.

Ce qu'une Expérience contrôle

Emails

• Lignes d’objet pour les emails d’invitation, de rappel, d’achèvement et de refus
• Texte d’en-tête et sous-titre de l’email
• Texte supplémentaire dans le corps de l’email
• Logo de l’email (téléchargé séparément via la requête upload)
• Choix d’attacher un PDF brouillon à l’email d’invitation

Page de signature

• Couleurs de branding (arrière-plan, bordures, boutons, texte)
• Logo et dimensions du logo
• Texte d’en-tête et corps affiché au signataire
• Cases à cocher d’accord (signingPageAgreeTicks) — exiger que le signataire accepte les termes avant de signer
• Possibilité pour le signataire de rejeter le document (signingPageRejectButton)
• Texte affiché après la signature (signingPageText)
• Durée de la session (signingSessionTime)

Options de signature

• Méthodes d’entrée de signature : dessiner à la souris (signatureMouse), taper (signatureType), télécharger une image (signatureUpload)
• Permettre la réutilisation d’une signature précédente (allowSignatureReuse)
• Ce qu’il faut ajouter à la signature : format du nom (signatureAppend), format date/IP (signatureAppendExtra)
• Diamètre du stylo pour les signatures dessinées
• Inclure un certificat numérique (signatureCertificate)

Comportement

• emailSendSequence — envoyer à tous les destinataires en même temps (0) ou en séquence (1)
• canReassign — permettre au signataire de réassigner le document à quelqu’un d’autre
• forwarding — permettre au signataire de transférer le document
• postSignEmail — envoyer un email de confirmation après la signature
• postSignAttach — joindre le PDF signé à l’email de confirmation
• Exigences de témoins (witnessingRequiresSignerSMS, witnessingRequiresWitnessSMS)

Langue

• language — code de la langue pour l’interface du signataire (ex. en, fr, de). Cela contrôle la langue des textes générés par le système sur la page de signature et dans les emails.

Quand utiliser plusieurs Expériences

• Langues différentes — créer une Expérience par langue pour les signataires internationaux
• Branding différent — personnaliser l’expérience de signature pour différents clients ou produits
• Règles de signature différentes — une Expérience exigeant les cases à cocher, une autre non
• Interne vs externe — une Expérience simplifiée pour le personnel interne, une plus formelle pour les clients externes

Utiliser les Expériences avec l'API

Définir la valeur par défaut

Une Expérience par groupe est marquée comme defaultExperience: true. Les documents envoyés sans spécifier d’Expérience utilisent celle-ci.

Spécifier lors de l’envoi

Passez experience sur chaque destinataire dans la mutation send pour outrepasser la valeur par défaut :

mutation {
  send(input: {
    groupId: "Z3JwMTIzNDU2"
    templateId: "dHBsMTIzNDU2"
    title: "Contract - French"
    recipients: [
      {
        firstName: "Marie"
        lastName: "Dupont"
        email: "marie@example.com"
        role: "Signer"
        experience: "ZXhwMTIzNDU2"
      }
    ]
  })
}

Opérations CRUD

• createExperience — créer une nouvelle Expérience dans un groupe
• updateExperience — modifier une Expérience existante
• deleteExperience — supprimer une Expérience
• copyExperience — dupliquer une Expérience (optionnellement vers un autre groupe)

En relation

• Référence du type Experience — liste complète des champs
• Mutation send — passer experience sur le destinataire lors de l’envoi
• Type Group — les Expériences appartiennent à un groupe via experienceConnection