White-Label-Update: Branded Editors, benutzerdefinierte Unterzeichnerbedingungen und Ihre eigene Absenderadresse

Firma.dev ist die am besten weisslabelbare E-Signatur-API auf dem Markt, und drei vor kurzem ausgelieferte Funktionen gehen noch einen Schritt weiter. Zusammen ermöglichen sie es Ihnen, das gesamte Signatur-Erlebnis von Grund auf im eigenen Markendesign zu gestalten: den Editor, den Ihre Benutzer sehen, die Einwilligungserklärung, der sie zustimmen, und die Adresse, von der ihre Benachrichtigungs-E-Mails stammen. Wenn Sie die Signatur-Funktion in Ihr eigenes Produkt einbetten, schließen diese Änderungen die Lücke, wo zuvor die Standardeinstellungen von Firma.dev sichtbar waren. Eine vollständige Anleitung zur Einrichtung einer White-Label-Konfiguration finden Sie im vollständigen Leitfaden für eine White-Label-E-Signatur-API, der den gesamten Ablauf abdeckt. In diesem Beitrag geht es um die Neuerungen.

Versehen Sie die eingebetteten Editoren mit fünf neuen Farbsteuerungen mit Ihrem Branding

Die eingebetteten Editoren für Vorlagen und Signaturanfragen, die Sie in Ihre eigenen Seiten integrieren, bieten jetzt fünf zusätzliche Farbsteuerungen. Sie erhalten Akzent (accent), Akzent-Vordergrund (accent foreground), Hintergrund der Arbeitsfläche (canvas), gedämpfte Oberfläche (muted surface) und gedämpften Text (muted text), die sich zu den bestehenden sechs für insgesamt elf Steuerungen gesellen. Das reicht aus, um das Design des Editors an Ihr Produkt anzupassen, anstatt sich mit einem „fast passenden“ Design zufrieden zu geben.

Sie legen diese in den Einstellungen unter „Erscheinungsbild“ fest, mit einer Live-Vorschau und Überschreibungsoptionen pro Arbeitsbereich. Es gibt auch eine Kontrastwarnung, falls Sie eine Kombination aus Akzent- und Vordergrundfarbe wählen, die schwer zu lesen ist. Dies verhindert, dass Sie ein Design veröffentlichen, das in Ihrem Editor gut aussieht, für einen Unterzeichner jedoch unlesbar ist.

Jede Farbe ist nullable (kann als null definiert werden) und wird entlang der Kette vererbt: Arbeitsbereichs-Überschreibungen überschreiben Firmen-Einstellungen, die Firma greift auf den Standardwert von Firma.dev zurück. Wenn Sie nichts festlegen, werden Ihre vorhandenen Editoren genau wie zuvor dargestellt. Auf der API-Seite sind die fünf neuen color_*-Felder sowohl auf Unternehmensebene als auch auf Arbeitsbereichsebene in den Einstellungen verfügbar, und das aufgelöste color_palette-Objekt gibt jetzt elf statt sechs Schlüssel zurück.

Dies wurde in API v1.25.0 veröffentlicht.

Zeigen Sie Unterzeichnern Ihre eigenen Allgemeinen Geschäftsbedingungen

Mit den benutzerdefinierten Unterzeichnerbedingungen (Custom Signer Terms) können Sie die standardmäßige Einwilligungserklärung von Firma.dev durch Ihren eigenen Text ersetzen. Sie können dies pro Sprache festlegen, entweder auf Unternehmens- oder Arbeitsbereichsebene, sodass ein Partner-Arbeitsbereich seine eigenen Markenbedingungen verwenden kann, während Ihr Standardwert überall sonst gilt. Sie können einen optionalen Link zu Ihren vollständigen Bedingungen hinzufügen und die Unterzeichnung optional an den Schritt „Zustimmung zu den AGB erforderlich“ koppeln, dem die Unterzeichner aktiv zustimmen müssen, bevor sie fortfahren können.

Wenn ein Unterzeichner zustimmt, wird die Zustimmung serverseitig zusammen mit einem Inhaltshash der genauen Bedingungen erfasst, die ihm angezeigt wurden. Dieser Hash fließt in das Prüfprotokoll ein, sodass Sie einen rechtssicheren Nachweis darüber haben, was wann vereinbart wurde, selbst wenn Sie den Text der Bedingungen später ändern. Wenn nichts eingestellt ist, sehen die Unterzeichner den Standardwert von Firma.dev, sodass es beim Rollout keine Lücken gibt.

Die praktischen Einsatzmöglichkeiten liegen auf der Hand. Rechtsteams, die eine eigene Einwilligungserklärung benötigen, können diese für jeden Signaturprozess vorschreiben, und Partner, die die Dienste von Firma.dev weiterverkaufen, können die Bedingungen ihrer eigenen Marke anstelle der unseren anzeigen. In der API unterstützen die neuen Signer-Terms-Endpunkte GET, PUT und DELETE auf beiden Ebenen, und require_terms_acceptance ist ein boolescher Wert in den Unternehmens- und Arbeitsbereichseinstellungen, der im Arbeitsbereich auf null gesetzt werden kann, damit er den Unternehmenswert erbt.

Dies wurde in API v1.23.0 veröffentlicht.

Senden Sie von Ihrer eigenen Adresse

Benachrichtigungs-E-Mails können jetzt von einer Adresse Ihrer Wahl stammen. Mit der Funktion „Custom Email Sender Address“ können Sie den Lokalteil, also den Teil vor dem @, auf einer verifizierten benutzerdefinierten Domain festlegen. Anstelle des Standardwerts können Sie also von noreply@, signatures@, documents@ oder einer beliebigen, für Ihr Produkt passenden Adresse senden.

Es handelt sich um einen Standardwert auf Unternehmensebene mit einer Überschreibungsoption pro Arbeitsbereich, wobei der Wert des Arbeitsbereichs Vorrang hat, wenn beide definiert sind. Sie benötigen jedoch zuerst eine verifizierte benutzerdefinierte Domain, da dies den Lokalteil und nicht die Domain selbst steuert. Das Feld akzeptiert 1 bis 64 Zeichen: Kleinbuchstaben, Zahlen sowie Punkte, Bindestriche und Unterstriche, und es muss mit einer Zahl oder einem Buchstaben beginnen und enden. Der Standard-Lokalteil ist support, wenn Sie keinen festlegen, sodass bestehende Absender unverändert weiterfunktionieren.

Dies ist das letzte sichtbare Puzzleteil der Identität von Firma.dev im Signaturprozess. Ein gebrandeter Editor, Ihre eigenen Bedingungen und jetzt Ihre eigene Absenderadresse bedeuten, dass ein Unterzeichner den gesamten Prozess durchlaufen kann, ohne unseren Namen irgendwo zu sehen. In der API ist dies die Einstellung email_local_part in den Unternehmens- und Arbeitsbereichseinstellungen.

Dies wurde in API v1.21.0 veröffentlicht.

Erste Schritte

Alle drei Funktionen sind ab sofort verfügbar. Ausführliche Angaben zu Anfragen und Antworten finden Sie im API-Changelog. Der vollständige Leitfaden zur White-Label-E-Signatur-API führt Sie durch die Zusammenführung aller Komponenten.

Starten Sie kostenlos mit Firma.dev, es ist keine Kreditkarte erforderlich. Zahlen Sie nutzungsbasiert $0.049 pro Umschlag (2.9¢ USD), ohne monatliche Mindestumsätze und ohne Verträge.