Mises à jour de produit

Libellés de boutons personnalisables dans la vue de signature

Éditeur interactif de libellé de bouton avec curseur le survolant.

L'écran de signature est la page unique la plus visible que vos signataires verront, et jusqu'à présent, les boutons qu'il contient s'affichaient exactement comme Firma.dev les avait configurés. À compter du 24-06-2026, cela change. Les administrateurs d'espace de travail peuvent désormais remplacer les libellés des boutons de l'affichage de signature, par langue, pour l'ensemble des neuf langues prises en charge. Si votre produit l'appelle « Approuver » au lieu de « Signer », le bouton peut indiquer « Approuver ».

Il s'agit d'une fonctionnalité en marque blanche. Elle s'ajoute aux domaines de messagerie personnalisés, au contrôle des notifications et à la signature intégrée pour offrir un niveau de contrôle supplémentaire sur ce que vos signataires voient réellement. Pour une présentation complète, consultez le guide complet pour créer une API de signature électronique en marque blanche.

Ce qui a été déployé

Les administrateurs d'espace de travail peuvent désormais remplacer les libellés des boutons par défaut dans l'affichage de signature. Ces personnalisations sont gérées dans les paramètres de l'espace de travail et s'appliquent aux boutons avec lesquels le signataire interagit tout au long du document, y compris l'action principale de signature, le bouton permettant de passer au champ requis suivant et l'action finale qui termine la signature.

Les libellés sont stockés sous la forme signing_button_label_overrides, un objet JSON indexé d'abord par langue, puis par clé de bouton. Rien ne change dans la logique de signature. Seul le texte que vos signataires lisent est modifié.

Pourquoi le texte des boutons est crucial dans un flux en marque blanche

Lorsque vous proposez une expérience de signature en marque blanche, vous contrôlez le logo, les couleurs, le domaine de messagerie et l'adresse d'expédition. Puis, le signataire accède à l'écran de signature réel et clique sur un bouton affichant un texte générique qui ne correspond à rien d'autre dans votre produit. Cette simple anomalie suffit à lui rappeler qu'il a quitté votre application.

Le texte des boutons est un élément mineur mais qui a un impact considérable sur l'aspect intégré du flux. L'adapter à votre propre terminologie permet de combler l'un des derniers écarts visibles entre votre produit et le moteur de signature sous-jacent.

Personnalisation par langue

Les libellés peuvent être personnalisés pour chacune des neuf langues prises en charge : anglais, espagnol, italien, portugais, français, allemand, grec, russe et polonais. Un signataire consultant le parcours en français verra vos libellés personnalisés en français. Un signataire en allemand verra vos libellés personnalisés en allemand. Vous configurez chaque langue de manière indépendante, ce qui vous permet de ne personnaliser que les langues que vous gérez activement et de conserver les valeurs par défaut de Firma.dev pour les autres.

Cela s'associe naturellement avec les signatures multilingues. Si vous localisez déjà le parcours de signature, les libellés de boutons personnalisés vous permettent de faire résonner votre propre ton dans chaque langue proposée plutôt que d'accepter la traduction par défaut.

Comment ça marche

Définissez les personnalisations via le point de terminaison des paramètres de l'espace de travail. Le champ signing_button_label_overrides accepte un objet indexé par code de langue, puis par clé de bouton :

curl -X PUT https://api.firma.dev/functions/v1/signing-request-api/workspace/{workspace_id}/settings \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "signing_button_label_overrides": {
      "fr": {
        "sign": "Approve and Sign",
        "next": "Continue",
        "finish": "Complete Signing"
      },
      "es": {
        "sign": "Aprobar y Firmar",
        "next": "Continuar",
        "finish": "Completar Firma"
      }
    }
  }'
curl -X PUT https://api.firma.dev/functions/v1/signing-request-api/workspace/{workspace_id}/settings \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "signing_button_label_overrides": {
      "fr": {
        "sign": "Approve and Sign",
        "next": "Continue",
        "finish": "Complete Signing"
      },
      "es": {
        "sign": "Aprobar y Firmar",
        "next": "Continuar",
        "finish": "Completar Firma"
      }
    }
  }'
curl -X PUT https://api.firma.dev/functions/v1/signing-request-api/workspace/{workspace_id}/settings \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "signing_button_label_overrides": {
      "fr": {
        "sign": "Approve and Sign",
        "next": "Continue",
        "finish": "Complete Signing"
      },
      "es": {
        "sign": "Aprobar y Firmar",
        "next": "Continuar",
        "finish": "Completar Firma"
      }
    }
  }'

Les signataires voient immédiatement les libellés personnalisés. Pour revenir aux valeurs par défaut de Firma.dev, définissez le champ sur null :

curl -X PUT https://api.firma.dev/functions/v1/signing-request-api/workspace/{workspace_id}/settings \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "signing_button_label_overrides": null
  }'
curl -X PUT https://api.firma.dev/functions/v1/signing-request-api/workspace/{workspace_id}/settings \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "signing_button_label_overrides": null
  }'
curl -X PUT https://api.firma.dev/functions/v1/signing-request-api/workspace/{workspace_id}/settings \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "signing_button_label_overrides": null
  }'

Quelques règles de validation utiles à connaître avant de configurer vos valeurs : chaque libellé doit être une chaîne de 500 caractères ou moins, les codes de langues doivent être valides, et toutes les balises HTML ou caractères de contrôle seront automatiquement supprimés. Une chose à garder à l'esprit pour les configurations multi-locataires : la personnalisation des libellés de boutons s'applique uniquement au niveau de l'espace de travail. Ainsi, si vous utilisez un espace de travail distinct par client, chacun d'eux disposera de ses propres libellés. Il n'existe pas de personnalisation au niveau de l'entreprise qui se répercute vers le bas.

Pour obtenir la référence complète, y compris toutes les clés de boutons disponibles, consultez le guide de marque blanche dans la documentation.

Commencer

Les libellés de boutons personnalisés sont désormais disponibles sur tous les espaces de travail, avec la même tarification à l'usage que le reste : 0,049 € par enveloppe (environ 5 ¢ USD), sans minimum mensuel.

Commencez gratuitement avec Firma.dev, aucune carte de crédit requise.

  1. Titre

Image de fond

Prêt à ajouter des signatures électroniques à votre application ?

Commencez gratuitement. Aucune carte de crédit requise. Payez seulement 0,049 € par enveloppe lorsque vous serez prêt à lancer votre activité.

Image de fond

Prêt à ajouter des signatures électroniques à votre application ?

Commencez gratuitement. Aucune carte de crédit requise. Payez seulement 0,049 € par enveloppe lorsque vous serez prêt à lancer votre activité.

Image de fond

Prêt à ajouter des signatures électroniques à votre application ?

Commencez gratuitement. Aucune carte de crédit requise. Payez seulement 0,049 € par enveloppe lorsque vous serez prêt à lancer votre activité.