Customizable Button-Beschriftungen in der Signieransicht

Die Signieransicht ist die am besten sichtbare Einzelseite, die Ihre Unterzeichner zu Gesicht bekommen, und bis heute trugen die Schaltflächen darauf genau die Beschriftung, mit der Firma.dev sie ausgeliefert hat. Ab dem 24. Juni 2026 ändert sich das. Workspace-Admins können die Beschriftungen der Schaltflächen in der Signieransicht überschreiben – und zwar pro Sprache für alle neun unterstützten Sprachen. Wenn es in Ihrem Produkt also beispielsweise „Zustimmen“ statt „Unterschreiben“ heißt, kann die Schaltfläche mit „Zustimmen“ beschriftet werden.

Dies ist eine White-Label-Funktion. Sie reiht sich neben benutzerdefinierten E-Mail-Domains, der Kontrolle über Benachrichtigungen und dem eingebetteten Signieren als eine weitere Steuerungsebene für das ein, was Ihre Unterzeichner tatsächlich sehen. Für ein vollständiges Bild lesen Sie bitte den kompletten Leitfaden zur Erstellung einer White-Label-E-Signatur-API.

Was neu ist

Workspace-Admins können ab sofort die Standard-Schaltflächenbeschriftungen in der Signieransicht überschreiben. Die Überschreibungen werden in den Workspace-Einstellungen verwaltet und gelten für die Schaltflächen, mit denen ein Unterzeichner im Verlauf eines Dokuments interagiert, einschließlich der primären Signier-Aktion, der Schaltfläche zum Springen zum nächsten erforderlichen Feld und der Abschluss-Aktion, die den Signierprozess beendet.

Die Beschriftungen werden als signing_button_label_overrides gespeichert, ein JSON-Objekt, das zuerst nach Sprache und dann nach Schaltflächen-Schlüssel strukturiert ist. An der Signierlogik ändert sich dadurch nichts. Es betrifft ausschließlich den Text, den Ihre Unterzeichner lesen.

Warum der Text auf Schaltflächen im White-Label-Flow wichtig ist

Wenn Sie das Signiererlebnis im White-Label-Verfahren anpassen, kontrollieren Sie das Logo, die Farben, die E-Mail-Domain und die Absenderadresse. Wenn dann jedoch ein Unterzeichner die eigentliche Signierseite erreicht und auf eine Schaltfläche mit einem generischen Text klickt, der zu nichts anderem in Ihrem Produkt passt, reicht diese einzige Unstimmigkeit bereits aus, um ihn daran zu erinnern, dass er Ihre App verlassen hat.

Texte auf Schaltflächen sind zwar nur kleine Details, haben aber einen enormen Einfluss darauf, wie nativ sich der Flow anfühlt. Indem Sie sie an Ihre eigene Terminologie anpassen, schließen Sie eine der letzten sichtbaren Lücken zwischen Ihrem Produkt und der zugrunde liegenden Signier-Engine.

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 Flow auf Französisch anzeigt, sieht Ihre benutzerdefinierten französischen Beschriftungen. Ein Unterzeichner auf Deutsch sieht Ihre benutzerdefinierten deutschen Beschriftungen. Sie konfigurieren jede Sprache unabhängig voneinander, sodass Sie nur die Sprachen überschreiben können, die Sie aktiv unterstützen, und den Rest bei den Standardeinstellungen von Firma.dev belassen können.

Dies lässt sich hervorragend mit mehrsprachigen Signaturen kombinieren. Wenn Sie den Signier-Flow bereits lokalisieren, können Sie dank benutzerdefinierter Schaltflächenbeschriftungen Ihre eigene Markenstimme in jeder angebotenen Sprache beibehalten, anstatt die Standardübersetzung zu übernehmen.

Wie es funktioniert

Legen Sie die Überschreibungen über den Endpunkt für die Workspace-Einstellungen fest. Das Feld signing_button_label_overrides erwartet ein Objekt, das nach Sprachcode und dann nach Schaltflächen-Schlüssel strukturiert 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": "Zustimmen und Signieren",
        "next": "Weiter",
        "finish": "Signieren abschließen"
      },
      "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": "Zustimmen und Signieren",
        "next": "Weiter",
        "finish": "Signieren abschließen"
      },
      "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": "Zustimmen und Signieren",
        "next": "Weiter",
        "finish": "Signieren abschließen"
      },
      "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
  }'

Einige Validierungsregeln, die Sie vor dem Festlegen von Werten kennen sollten: Jede Beschriftung muss eine Zeichenfolge von maximal 500 Zeichen sein, Sprachschlüssel müssen gültige Sprachcodes sein, und alle HTML-Tags oder Steuerzeichen werden automatisch entfernt. Ein wichtiger Punkt für Multi-Mandanten-Setups: Schaltflächen-Überschreibungen sind eine reine Einstellung auf Workspace-Ebene. Wenn Sie also pro Kunde einen separaten Workspace betreiben, verfügt jeder über eigene Beschriftungen. Es gibt keine übergeordnete Überschreibung auf Unternehmensebene, die nach unten vererbt wird.

Die vollständige Referenz, einschließlich aller verfügbaren Schaltflächen-Schlüssel, finden Sie in der Anleitung zum White-Labeling in der Dokumentation.

Erste Schritte

Benutzerdefinierte Schaltflächenbeschriftungen sind ab sofort in jedem Workspace verfügbar, und zwar zu denselben Pay-as-you-go-Preisen wie alles andere auch: 0,029 € pro Umschlag (ca. 3¢ USD), ohne monatliche Mindestumsätze.

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