Envoyez les signataires vers une expérience de signature localisée avec un paramètre d'URL

Si vous envoyez des contrats à des signataires dans plusieurs pays, voici la méthode la plus rapide pour offrir à chacun une expérience localisée. Ajoutez ?lang=fr au lien d'un signataire français, ?lang=de au lien d'un signataire allemand, et Firma.dev s'occupe du reste. Chaque écran qu'ils voient, des instructions et des boutons jusqu'au texte juridique, se charge dans cette langue dès la première page. Aucun compte n'est requis de leur côté, aucun réglage à configurer du vôtre.

Fonctionnement du paramètre ?lang=

Le paramètre ?lang= peut être ajouté à n'importe quel lien de signature Firma.dev. Il force toute l'expérience de signature dans la langue spécifiée, en remplaçant à la fois la détection automatique du navigateur et tous les paramètres par défaut au niveau de l'espace de travail. Le signataire n'a rien à faire : il suit simplement le lien et l'interface est déjà dans la bonne langue.

Les sept codes de langue pris en charge sont :

Une URL de signature standard ressemble à ceci :

https://app.firma.dev/signing/{signing_request_user_id}

https://app.firma.dev/signing/{signing_request_user_id}

https://app.firma.dev/signing/{signing_request_user_id}

Avec un remplacement de langue :

https://app.firma.dev/signing/{signing_request_user_id}?lang=fr

https://app.firma.dev/signing/{signing_request_user_id}?lang=fr

https://app.firma.dev/signing/{signing_request_user_id}?lang=fr

C'est la seule modification. Aucun appel API supplémentaire, aucune modification de modèle, aucune configuration par signataire.

Une seule demande de signature, plusieurs liens localisés

Le schéma pratique pour les documents multiparties ou internationaux : créez une seule demande de signature avec les e-mails automatisés de Firma.dev désactivés, récupérez les URL de signature pour chaque destinataire, puis ajoutez le paramètre ?lang= approprié pour chacun avant de les envoyer via votre propre système.

Le code suivant est tiré du guide de white-labeling, avec ?lang= ajouté selon le guide de localisation :

// Créez une demande de signature avec les e-mails désactivés
const response = await fetch(
  'https://api.firma.dev/functions/v1/signing-request-api/signing-requests',
  {
    method: 'POST',
    headers: {
      'Authorization': API_KEY,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      workspace_id: workspaceId,
      template_id: templateId,
      settings: {
        send_signing_email: false,
        send_finish_email: false
      },
      recipients: [
        { first_name: 'Jane', last_name: 'Smith', email: 'jane@example.com', designation: 'Signataire', order: 1 }
      ]
    })
  }
)
const signingRequest = await response.json()

// Obtenez les URL de signature pour chaque destinataire
const usersResponse = await fetch(
  `https://api.firma.dev/functions/v1/signing-request-api/signing-requests/${signingRequest.id}/users`,
  {
    headers: { 'Authorization': API_KEY }
  }
)
const { results: users } = await usersResponse.json()

// Envoyez les e-mails via votre propre système avec ?lang= ajouté
for (const user of users) {
  const signingUrl = `https://app.firma.dev/signing/${user.id}?lang=fr`
  await yourEmailService.send({
    to: user.email,
    subject: 'Veuillez signer votre document',
    body: `Cliquez ici pour signer : ${signingUrl}`
  })
}

// Créez une demande de signature avec les e-mails désactivés
const response = await fetch(
  'https://api.firma.dev/functions/v1/signing-request-api/signing-requests',
  {
    method: 'POST',
    headers: {
      'Authorization': API_KEY,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      workspace_id: workspaceId,
      template_id: templateId,
      settings: {
        send_signing_email: false,
        send_finish_email: false
      },
      recipients: [
        { first_name: 'Jane', last_name: 'Smith', email: 'jane@example.com', designation: 'Signataire', order: 1 }
      ]
    })
  }
)
const signingRequest = await response.json()

// Obtenez les URL de signature pour chaque destinataire
const usersResponse = await fetch(
  `https://api.firma.dev/functions/v1/signing-request-api/signing-requests/${signingRequest.id}/users`,
  {
    headers: { 'Authorization': API_KEY }
  }
)
const { results: users } = await usersResponse.json()

// Envoyez les e-mails via votre propre système avec ?lang= ajouté
for (const user of users) {
  const signingUrl = `https://app.firma.dev/signing/${user.id}?lang=fr`
  await yourEmailService.send({
    to: user.email,
    subject: 'Veuillez signer votre document',
    body: `Cliquez ici pour signer : ${signingUrl}`
  })
}

// Créez une demande de signature avec les e-mails désactivés
const response = await fetch(
  'https://api.firma.dev/functions/v1/signing-request-api/signing-requests',
  {
    method: 'POST',
    headers: {
      'Authorization': API_KEY,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      workspace_id: workspaceId,
      template_id: templateId,
      settings: {
        send_signing_email: false,
        send_finish_email: false
      },
      recipients: [
        { first_name: 'Jane', last_name: 'Smith', email: 'jane@example.com', designation: 'Signataire', order: 1 }
      ]
    })
  }
)
const signingRequest = await response.json()

// Obtenez les URL de signature pour chaque destinataire
const usersResponse = await fetch(
  `https://api.firma.dev/functions/v1/signing-request-api/signing-requests/${signingRequest.id}/users`,
  {
    headers: { 'Authorization': API_KEY }
  }
)
const { results: users } = await usersResponse.json()

// Envoyez les e-mails via votre propre système avec ?lang= ajouté
for (const user of users) {
  const signingUrl = `https://app.firma.dev/signing/${user.id}?lang=fr`
  await yourEmailService.send({
    to: user.email,
    subject: 'Veuillez signer votre document',
    body: `Cliquez ici pour signer : ${signingUrl}`
  })
}

Le document est identique pour tout le monde. L'expérience de signature que chacun voit est dans sa langue. Vous gérez la construction du lien, Firma.dev gère le rendu. Remplacez ?lang=fr par le code de langue qui correspond à chaque destinataire.

Ce modèle est particulièrement utile lorsque les e-mails automatisés de Firma.dev sont désactivés et que vous distribuez les liens de signature via votre propre système de notification. Vous contrôlez déjà la diffusion, donc ajouter le paramètre ?lang= est une simple formalité.

Repli automatique sans le paramètre

Lorsqu'aucun paramètre ?lang= n'est présent, Firma.dev lit les paramètres de langue du navigateur du signataire et les associe à la langue prise en charge la plus proche. Si leur navigateur est réglé sur le français, ils verront une interface en français. Si leur langue n'est pas prise en charge, la langue par défaut est l'anglais.

Ce repli fonctionne bien pour les liens directs lorsque vous ne contrôlez pas le contexte de livraison. Mais pour la signature intégrée dans des iframes, ou dans tout scénario où vous construisez des URL côté serveur, passer ?lang= explicitement est l'approche la plus fiable. La détection de la langue du navigateur à l'intérieur d'une iframe peut être incohérente selon la manière dont l'application parente est configurée.

La recommandation de la documentation est simple : utilisez ?lang= dans les contextes intégrés et, lorsque vous connaissez la locale du signataire, laissez la détection du navigateur gérer les liens directs lorsque vous ne contrôlez pas la diffusion.

Vue complète de la localisation

Le paramètre ?lang= est un élément de la pile de localisation de Firma.dev. Pour un flux de signature entièrement localisé, les éléments s'assemblent ainsi :

La langue de l'expérience de signature est contrôlée par ?lang= dans le lien, ou par la détection du navigateur comme repli. Cela couvre tout ce que le signataire voit pendant le flux de signature.

Les e-mails de notification sont contrôlés par le champ language dans les paramètres de l'espace de travail. Réglez l'espace de travail sur le français et tous les e-mails de signature automatisés partiront en français, sans qu'aucun modèle personnalisé ne soit nécessaire.

Les styles de signature sont gérés automatiquement en fonction du nom de chaque signataire. Les noms grecs, cyrilliques, japonais et coréens obtiennent des polices de signature conçues pour leur système d'écriture, sans aucune configuration.

Ensemble, ces trois niveaux couvrent l'expérience complète : les e-mails entrants, le flux de signature lui-même et l'apparence de la signature sur le document. Le guide de localisation de Firma.dev couvre les trois en détail.

Obtenez votre clé API et commencez à développer gratuitement, aucune carte de crédit n'est requise.