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 auf Englisch mit dem Inhalt „Please review and sign this document“. Es ist eine Kleinigkeit, die das Nutzererlebnis genau im wichtigsten Moment stört.

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

Das Problem mit rein englischsprachigen Unterzeichnungs-E-Mails

Die meisten E-Signatur-APIs sind standardmäßig auf Englisch eingestellt und überlassen die Lokalisierung dem Entwickler. Das bedeutet, dass übersetzte E-Mail-Templates für jede von Ihrem Produkt unterstützte Sprache und für jeden E-Mail-Typ im Unterzeichnungs-Workflow erstellt, gepflegt und bei Textänderungen aktualisiert werden 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 Wartungsaufwand spielt auch das Vertrauen eine Rolle. Eine Unterzeichnungs-E-Mail, die nicht mit der Sprache der Benutzeroberfläche des Unterzeichners übereinstimmt, wirkt wie ein Fehler, selbst wenn das Dokument selbst korrekt ist. Bei hochwertigen Verträgen fällt diese Hürde ins Gewicht.

Wie die Sprachunterstützung von Firma.dev funktioniert

Firma.dev hat ein language-Feld sowohl in den Unternehmens- als auch in den Workspace-Einstellungen hinzugefügt. Wenn es gesetzt ist, nutzt die Plattform integrierte, lokalisierte Templates für alle 5 Typen von Unterzeichnungsbenachrichtigungs-E-Mails: 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, gefolgt vom Workspace und dann vom Unternehmen. Stellen Sie sie einmal auf Unternehmensebene ein und jeder Workspace erbt sie, oder überschreiben Sie sie pro Workspace für eine detailliertere Kontrolle.

Eine wichtige Klarstellung: Das Feld language betrifft nur die integrierten 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 Ausweichebene, nicht als Überschreibung.

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 aus derselben Integration und ohne jegliche 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 Wartungsaufwand.

Nutzung der Standardwerte als Ausgangspunkt

Für Teams, die Lokalisierung gepaart mit einer leichten Markenanpassung 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 keine Übersetzungen von Grund auf neu schreiben und behalten 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 Entwickler internationaler SaaS-Produkte bedeutet

Die Erstellung eines Unterzeichnungs-Workflows für ein globales Produkt bedeutete bisher entweder, rein englische E-Mails zu akzeptieren oder die Übersetzungsebene selbst zu verwalten. Da nun 7 Sprachen auf Plattformebene abgedeckt 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 schreiben zu müssen.

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

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