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 le chemin le plus rapide vers une expérience localisée pour chacun d'eux. 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 aux boutons en passant par le texte légal, se charge dans cette langue dès la première page. Aucun compte requis de leur côté, aucun paramètre à configurer du vôtre.

Comment fonctionne le 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 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 tout le changement. Pas d'appels API supplémentaires, pas de modifications de modèle, pas de configuration par signataire.

Une demande de signature, plusieurs liens localisés

Le modèle pratique pour les documents multipartites ou internationaux : créer une seule demande de signature avec les e-mails automatisés de Firma.dev désactivés, récupérer les URLs de signature pour chaque destinataire, puis ajouter le paramètre approprié ?lang= pour chacun avant de les envoyer via votre propre système.

Le code suivant provient du guide de marque blanche, avec ?lang= ajouté selon le guide de localisation :

// Create signing request with emails disabled
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: 'Signer', order: 1 }
      ]
    })
  }
)
const signingRequest = await response.json()

// Get signing URLs for each recipient
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()

// Send emails through your own system with ?lang= appended
for (const user of users) {
  const signingUrl = `https://app.firma.dev/signing/${user.id}?lang=fr`
  await yourEmailService.send({
    to: user.email,
    subject: 'Please sign your document',
    body: `Click here to sign: ${signingUrl}`
  })
}

// Create signing request with emails disabled
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: 'Signer', order: 1 }
      ]
    })
  }
)
const signingRequest = await response.json()

// Get signing URLs for each recipient
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()

// Send emails through your own system with ?lang= appended
for (const user of users) {
  const signingUrl = `https://app.firma.dev/signing/${user.id}?lang=fr`
  await yourEmailService.send({
    to: user.email,
    subject: 'Please sign your document',
    body: `Click here to sign: ${signingUrl}`
  })
}

// Create signing request with emails disabled
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: 'Signer', order: 1 }
      ]
    })
  }
)
const signingRequest = await response.json()

// Get signing URLs for each recipient
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()

// Send emails through your own system with ?lang= appended
for (const user of users) {
  const signingUrl = `https://app.firma.dev/signing/${user.id}?lang=fr`
  await yourEmailService.send({
    to: user.email,
    subject: 'Please sign your document',
    body: `Click here to sign: ${signingUrl}`
  })
}

Le document est le même pour tout le monde. L'expérience de signature que chaque personne 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 correspondant à 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 livraison, donc ajouter le paramètre ?lang= est une addition triviale.

Retour 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 supportée, le système par défaut passe à l'anglais.

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

La recommandation des docs est simple : utilisez ?lang= dans les contextes intégrés et lorsque vous connaissez le locale du signataire, laissez la détection du navigateur gérer les liens directs où vous ne le faites pas.

Le tableau de localisation complet

Le paramètre ?lang= est une pièce de la pile de localisation de Firma.dev. Pour un flux de signature entièrement localisé, les pièces s'assemblent comme suit :

Langue de l'expérience de signature est contrôlée par ?lang= sur le lien, ou par détection du navigateur en tant que solution de secours. 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 sur 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 seront envoyés en français, sans nécessiter de modèle personnalisé.

Styles de signature sont automatiquement gérés 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 couches couvrent toute l'expérience : 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 à construire gratuitement, aucune carte de crédit n'est requise.