Senden Sie Signatur-E-Mails in 7 Sprachen: Multilinguale E-Mail-Unterstützung von Firma.dev

Sie haben Ihre App lokalisiert. Ihre Benutzeroberfläche wird für französische Nutzer auf Französisch, für deutsche Nutzer auf Deutsch und für brasilianische Nutzer auf Portugiesisch dargestellt. Doch in dem Moment, in dem eine Unterzeichnungsanfrage versendet wird, erhält Ihr Unterzeichner eine E-Mail mit dem englischen Text "Please review and sign this document". Das ist eine Kleinigkeit, die das Nutzererlebnis genau in dem Moment stört, in dem es am wichtigsten ist.

Firma.dev versendet Benachrichtigungs-E-Mails zur Unterzeichnung jetzt standardmäßig in 7 Sprachen, ohne dass eine benutzerdefinierte Template-Einrichtung erforderlich ist.

Das Problem mit rein englischen Unterzeichnungs-E-Mails

Die meisten E-Signatur-APIs sind standardmäßig auf Englisch eingestellt und überlassen die Lokalisierung dem Entwickler. Das bedeutet, dass Sie für jede von Ihrem Produkt unterstützte Sprache und für jeden E-Mail-Typ im Unterzeichnungs-Workflow übersetzte E-Mail-Templates schreiben, pflegen und bei Textänderungen auf dem neuesten Stand halten müssen.

Bei einem Unterzeichnungs-Workflow mit 5 E-Mail-Typen in 4 Sprachen sind das 20 Templates, die erstellt, getestet und gepflegt werden müssen. Und wenn Sie eines vergessen, erhält ein Unterzeichner in Lyon oder Lissabon eine System-E-Mail in einer Sprache, die er nicht gewählt hat.

Neben dem Pflegeaufwand spielt auch das Vertrauen eine Rolle. Eine Unterzeichnungs-E-Mail, die nicht zur Sprache der Benutzeroberfläche des Unterzeichners passt, wirkt wie ein Fehler, selbst wenn das Dokument selbst korrekt ist. Bei hochvolumigen Verträgen fällt dieser Reibungspunkt ins Gewicht.

So funktioniert die Sprachunterstützung von Firma.dev

Firma.dev hat sowohl den Unternehmens- als auch den Workspace-Einstellungen ein language-Feld hinzugefügt. Wenn dieses gesetzt ist, nutzt die Plattform integrierte, lokalisierte Templates für alle 5 Benachrichtigungs-E-Mail-Typen zur Unterzeichnung: signing_invite, next_signer, signing_expired, signing_cancelled und signing_declined.

Die 7 unterstützten Sprachen sind:

Die Spracheinstellung vererbt sich genauso wie E-Mail-Templates: Die Ebene der Unterzeichnungsanfrage hat Vorrang, danach folgt der Workspace, dann das Unternehmen. Wenn Sie sie einmal auf Unternehmensebene festlegen, erbt sie jeder Workspace, oder Sie überschreiben sie pro Workspace für eine präzisere Steuerung.

Eine wichtige Klarstellung: Das language-Feld betrifft nur integrierte Standard-Templates. Wenn für einen Workspace ein benutzerdefiniertes E-Mail-Template für einen bestimmten E-Mail-Typ konfiguriert ist, wird dieses benutzerdefinierte Template unabhängig von der Spracheinstellung verwendet. Das Sprachfeld dient als Fallback-Ebene, nicht zum Überschreiben.

Festlegen einer Sprache pro Workspace

Wenn Sie das Kunden-Workspace-Modell von Firma.dev nutzen, kann jeder Workspace seine eigene Sprache haben. Ein französischer Kunde erhält französische E-Mails, ein deutscher Kunde deutsche E-Mails – alles über dieselbe Integration und ganz ohne Template-Verwaltung.

Das Festlegen der Sprache auf Workspace-Ebene erfolgt über einen einzigen PATCH-Aufruf:

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

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

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

Und auf Unternehmensebene, um den Standardwert für alle Workspaces festzulegen:

curl -X PATCH https://api.firma.dev/functions/v1/signing-request-api/company \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "language": "es" }'

curl -X PATCH https://api.firma.dev/functions/v1/signing-request-api/company \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "language": "es" }'

curl -X PATCH https://api.firma.dev/functions/v1/signing-request-api/company \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "language": "es" }'

Das ist alles. Keine Template-Erstellung, keine Übersetzungsarbeit, kein Pflegeaufwand.

Nutzung der Standardwerte als Ausgangspunkt

Für Teams, die eine Lokalisierung gepaart mit leichten Markenanpassungen wünschen, gibt der Endpunkt GET /email-templates/defaults/{language} das vollständige integrierte Template für jede unterstützte Sprache zurück. Rufen Sie es ab, passen Sie den Text an oder fügen Sie das HTML-Styling Ihrer Marke hinzu, und speichern Sie es als benutzerdefiniertes Workspace-Template mit PUT /workspace/{workspace_id}/email-templates/{email_type}.

Dieses Muster bietet Ihnen das Beste aus beiden Welten: Sie müssen Übersetzungen nicht von Grund auf neu schreiben, behalten aber dennoch die Kontrolle darüber, wie die E-Mails aussehen und klingen. Für die meisten SaaS-Produkte ist dies der richtige Ansatz, sobald Sie sich vergewissert haben, dass sich die integrierten Standardwerte für Ihren Markt natürlich lesen. Beide Endpunkte sind im API-Changelog dokumentiert.

Was das für internationale SaaS-Entwickler bedeutet

Die Einrichtung eines Unterzeichnungs-Workflows für ein globales Produkt bedeutete früher, entweder rein englische E-Mails zu akzeptieren oder die Übersetzungsebene selbst zu verwalten. Da nun 7 Sprachen direkt auf Plattformebene verarbeitet werden, müssen Sie diesen Kompromiss nicht mehr eingehen.

In Kombination mit der eingebetteten Unterzeichnungs-Benutzeroberfläche von Firma.dev, die sich ebenfalls an die Sprache des Unterzeichners anpasst, können Sie nun ein vollständig lokalisiertes Unterzeichnungserlebnis von der Einladungs-E-Mail bis zur finalen Bestätigung bieten, ohne eine einzige Zeile Übersetzungscode zu schreiben.

Mit $0,049 pro Umschlag (oder etwa 5 US-Cent) ohne monatliche Mindestumsätze zahlen Sie keinen Aufpreis für die internationale Abdeckung. Sie ist direkt in der API enthalten.

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