Customizable Button-Beschriftungen in der Signieransicht

Der Signaturbildschirm ist die am besten sichtbare Einzelseite, die Ihre Unterzeichner zu sehen bekommen, und bisher entsprachen die darauf befindlichen Schaltflächen genau den Vorgaben von Firma.dev. Seit dem 24.06.2026 ändert sich das. Workspace-Administratoren können die Beschriftungen der Schaltflächen in der Signaturansicht pro Sprache für alle neun unterstützten Sprachen überschreiben. Wenn Ihr Produkt sie „Genehmigen“ statt „Signieren“ nennt, kann die Schaltfläche „Genehmigen“ heißen.

Dies ist eine White-Label-Funktion. Sie steht neben benutzerdefinierten E-Mail-Domains, der Benachrichtigungskontrolle und dem eingebetteten Signieren als eine weitere Steuerungsebene für das, was Ihre Unterzeichner tatsächlich sehen. Für das vollständige Bild siehe den vollständigen Leitfaden zur Erstellung einer White-Label-E-Signatur-API.

Was neu ist

Workspace-Administratoren können jetzt die Standardbeschriftungen der Schaltflächen in der Signaturansicht überschreiben. Die Überschreibungen befinden sich in den Workspace-Einstellungen und gelten für die Schaltflächen, mit denen ein Unterzeichner interagiert, während er sich durch ein Dokument bewegt, einschließlich der primären Signaturaktion, der Schaltfläche, die zum nächsten erforderlichen Feld weiterleitet, und der Abschlussaktion, die das Signieren beendet.

Die Beschriftungen werden als signing_button_label_overrides gespeichert, ein JSON-Objekt, das zuerst nach Sprache und dann nach dem Schlüssel der Schaltfläche indiziert ist. An der Signaturlogik ändert sich dadurch nichts. Nur der Text, den Ihre Unterzeichner lesen.

Warum der Text von Schaltflächen in einem White-Label-Flow wichtig ist

Wenn Sie das Signaturerlebnis mit einem White-Label versehen, kontrollieren Sie das Logo, die Farben, die E-Mail-Domain und die Absenderadresse. Dann erreicht ein Unterzeichner den eigentlichen Signaturbildschirm und stößt auf eine Schaltfläche mit einem generischen Text, der zu nichts anderem in Ihrem Produkt passt. Diese einzige Unstimmigkeit reicht aus, um ihn daran zu erinnern, dass er Ihre App verlassen hat.

Der Text auf den Schaltflächen ist eine kleine Fläche mit einer enormen Wirkung darauf, wie nativ sich der Ablauf anfühlt. Die Anpassung an Ihre eigene Terminologie schließt eine der letzten sichtbaren Lücken zwischen Ihrem Produkt und der zugrunde liegenden Signaturanwendung.

Sprachspezifische Überschreibungen

Überschreibungen werden pro Sprache festgelegt und gelten für alle neun unterstützten Sprachen: Englisch, Spanisch, Italienisch, Portugiesisch, Französisch, Deutsch, Griechisch, Russisch und Polnisch. Ein Unterzeichner, der den Ablauf auf Französisch ansieht, sieht Ihre benutzerdefinierten französischen Beschriftungen. Ein Unterzeichner im Deutschen sieht Ihre benutzerdefinierten deutschen Beschriftungen. Sie stellen jede Sprache unabhängig ein, sodass Sie nur die Sprachen überschreiben können, die Sie aktiv unterstützen, und den Rest bei den Standardeinstellungen von Firma.dev belassen.

Dies lässt sich natürlich mit mehrsprachigen Signaturen kombinieren. Wenn Sie den Signaturablauf bereits lokalisieren, können Sie mit benutzerdefinierten Schaltflächenbeschriftungen Ihre eigene Stimme in jeder von Ihnen angebotenen Sprache einbringen, anstatt die Standardübersetzung zu akzeptieren.

Wie es funktioniert

Legen Sie die Überschreibungen über den Endpunkt für die Workspace-Einstellungen fest. Das Feld signing_button_label_overrides nimmt ein Objekt entgegen, das nach Sprachcode und dann nach Schaltflächenschlüssel codiert ist:

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": {
      "de": {
        "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": {
      "de": {
        "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": {
      "de": {
        "sign": "Approve and Sign",
        "next": "Continue",
        "finish": "Complete Signing"
      },
      "es": {
        "sign": "Aprobar y Firmar",
        "next": "Continuar",
        "finish": "Completar Firma"
      }
    }
  }'

Unterzeichner sehen die angepassten Beschriftungen sofort. Um zu den Standardeinstellungen von Firma.dev zurückzukehren, setzen Sie das Feld auf 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
  }'

Ein paar Validierungsregeln, die man vor dem Festlegen von Werten kennen sollte: Jedes Label darf maximal 500 Zeichen lang sein, die Sprachschlüssel müssen gültige Sprachcodes sein, und alle HTML-Tags oder Steuerzeichen werden automatisch entfernt. Eines sollte man bei Mandantensystemen beachten: Überschreibungen für Schaltflächenbeschriftungen sind nur eine Einstellung auf Workspace-Ebene. Wenn Sie also pro Kunde einen separaten Workspace betreiben, verfügt jeder über eigene Beschriftungen. Es gibt keine Überschreibung auf Unternehmensebene, die sich nach unten vererbt.

Die vollständige Referenz, einschließlich aller verfügbaren Schaltflächenschlüssel, finden Sie im White-Labeling-Leitfaden in der Dokumentation.

Erste Schritte

Benutzerdefinierte Schaltflächenbeschriftungen sind ab sofort in jedem Workspace verfügbar, und zwar zu den gleichen verbrauchsabhängigen Preisen wie alles andere auch: 0,049 € pro Umschlag (ca. 5¢ USD), ohne monatliche Mindestbeträge.

Starten Sie kostenlos mit Firma.dev, keine Kreditkarte erforderlich.