Mises à jour de produit

Libellés de boutons personnalisables dans la vue de signature

Écrit par

Bouton violet avec le texte « Libellé du bouton » sélectionné et des poignées de redimensionnement, avec un curseur en train de le modifier, représentant une interface utilisateur personnalisable.

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

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

Les nouveautés

Les administrateurs d'espace de travail peuvent désormais remplacer les libellés par défaut des boutons dans la vue de signature. Ces personnalisations se trouvent dans les paramètres de l'espace de travail et s'appliquent aux boutons avec lesquels le signataire interagit tout au long du document, notamment l'action principale de signature, le bouton permettant de passer au champ obligatoire suivant et l'action finale qui valide la signature.

Les libellés sont stockés sous forme de 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 lu par vos signataires est modifié.

Pourquoi le texte des boutons compte 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. Pourtant, dès que le signataire arrive sur l'écran de signature à proprement parler, il fait face à un bouton avec un texte générique qui ne correspond à rien d'autre dans votre produit. Cette simple incohérence suffit à lui rappeler qu'il a quitté votre application.

Le texte d'un bouton est un détail en apparence minime, mais il a un impact démesuré sur l'impression de fluidité et d'intégration native du parcours. L'adapter à votre propre terminologie permet de combler l'un des derniers écarts visibles entre votre produit et le moteur de signature sous-jacent.

Personnalisations par langue

Les remplacements sont définis par langue et s'appliquent aux 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 modifier que les langues que vous prenez activement en charge et de conserver les valeurs par défaut de Firma.dev pour les autres.

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

Fonctionnement

Définissez les libellés personnalisés via le point de terminaison des paramètres de l'espace de travail. Le champ signing_button_label_overrides prend 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 définir des valeurs : chaque libellé doit être une chaîne de 500 caractères ou moins, les clés de langue doivent être des codes de langue valides, et toutes les balises HTML ou caractères de contrôle sont automatiquement supprimés. Un point important pour les configurations mutualisées (multi-tenant) : la personnalisation des libellés de boutons est un paramètre propre à l'espace de travail uniquement. Si vous gérez un espace de travail distinct par client, chacun conserve donc ses propres libellés. Il n'existe pas de remplacement au niveau de l'entreprise qui s'appliquerait en cascade.

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

Commencer

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

Commencez gratuitement avec Firma.dev, sans carte bancaire requise.

  1. Titre

Articles connexes

Notre plateforme est conçue pour permettre aux entreprises de toutes tailles de travailler plus intelligemment et d'atteindre leurs objectifs avec confiance.

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é.