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

Firma.dev ist die am stärksten als White-Label gestaltbare E-Signatur-API auf dem Markt, und drei kürzlich veröffentlichte Funktionen treiben dies noch weiter voran. Zusammen ermöglichen sie es Ihnen, das Signiererlebnis von Anfang bis Ende mit Ihrer Marke zu versehen: den Editor, den Ihre Benutzer sehen, den Einwilligungstext, dem sie zustimmen, und die Adresse, von der ihre Benachrichtigungs-E-Mails stammen. Wenn Sie das Signieren in Ihr eigenes Produkt einbetten, schließen diese Funktionen die Lücken, in denen zuvor die Standardeinstellungen von Firma.dev sichtbar waren. Für eine vollständige Anleitung zur Einrichtung einer White-Label-Konfiguration deckt der komplette Leitfaden für eine White-Label-E-Signatur-API den gesamten Ablauf ab. In diesem Beitrag geht es darum, was neu ist.

Versehen Sie die eingebetteten Editoren mit fünf neuen Farbsteuerungen mit Ihrer Marke

Die eingebetteten Editoren für Vorlagen und Signaturanfragen, die Sie in Ihre eigenen Seiten einbinden, verfügen nun über fünf zusätzliche Farbsteuerungen. Sie erhalten Akzent, Akzent-Vordergrund, Zeichenfläche (Canvas), gedämpfte Oberfläche und gedämpften Text, die sich zu den bestehenden sechs für insgesamt elf hinzugesellen. Das reicht aus, um das Design des Editors an Ihr Produkt anzupassen, anstatt sich mit einer ungefähren Übereinstimmung zufriedenzugeben.

Sie stellen diese in den Einstellungen unter „Erscheinungsbild“ ein, mit einer Live-Vorschau und Überschreibungen pro Arbeitsbereich. Es gibt auch eine Kontrastwarnung, wenn Sie eine Akzent- und Vordergrundkombination wählen, die schwer zu lesen ist. Das bewahrt Sie davor, ein Design zu veröffentlichen, das in Ihrem Editor gut aussieht, für einen Unterzeichner jedoch unlesbar ist.

Jede Farbe ist nullbar und vererbt sich in der Kette nach unten: Arbeitsbereich überschreibt Unternehmen, Unternehmen greift auf den Standard von Firma.dev zurück. Wenn Sie nichts festlegen, werden Ihre vorhandenen Editoren genau so gerendert wie zuvor. Auf der API-Seite sind die fünf neuen color_*-Felder sowohl an den Endpunkten für Unternehmens- als auch für Arbeitsbereichseinstellungen verfügbar, und das aufgelöste color_palette-Objekt gibt nun elf statt sechs Schlüssel zurück.

Dies wurde in API v1.25.0 veröffentlicht.

Zeigen Sie Unterzeichnern Ihre eigenen Geschäftsbedingungen

Mit den benutzerdefinierten Unterzeichnerbedingungen (Custom Signer Terms) können Sie die Standard-Einwilligungserklärung von Firma.dev durch Ihren eigenen Text ersetzen. Sie können dies pro Sprache entweder auf Unternehmens- oder Arbeitsbereichsebene festlegen, sodass ein Partner-Arbeitsbereich die Bedingungen seiner eigenen Marke tragen kann, während Ihr Standard überall sonst gilt. Sie können einen optionalen Link zu Ihren vollständigen Bedingungen einfügen und das Signieren optional an einen Schritt „Zustimmung zu den Bedingungen erforderlich“ knüpfen, 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 er gesehen hat. Dieser Hash geht in das Protokoll 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 Unterzeichner den Standard von Firma.dev, sodass es beim Rollout keine Lücke gibt.

Die praktischen Einsatzmöglichkeiten sind unkompliziert. Rechtsteams, die einen eigenen Einwilligungstext benötigen, können diesen für jeden Signierprozess vorschreiben, und Partner, die Firma.dev weiterverkaufen, können die Bedingungen ihrer eigenen Marke anstelle unserer anzeigen. In der API unterstützen die neuen Endpunkte für Unterzeichnerbedingungen GET, PUT und DELETE auf beiden Ebenen, und require_terms_acceptance ist ein Boolean in den Unternehmens- und Arbeitsbereichseinstellungen, der im Arbeitsbereich nullbar ist, sodass 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 benutzerdefinierten E-Mail-Absenderadresse (Custom Email Sender Address) können Sie den Lokalteil (den Teil vor dem @) auf einer verifizierten benutzerdefinierten Domain festlegen. Anstelle des Standards können Sie also von noreply@, signatures@, documents@ oder was auch immer zu Ihrem Produkt passt, senden.

Dies ist ein Standard auf Unternehmensebene mit einer Überschreibung pro Arbeitsbereich, wobei der Wert des Arbeitsbereichs Vorrang hat, wenn beide festgelegt 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: alphanumerische Kleinbuchstaben plus Punkte, Bindestriche und Unterstriche, und es muss mit einem alphanumerischen Zeichen beginnen und enden. Der Standard-Lokalteil ist support, wenn Sie keinen festlegen, sodass bestehende Absender unverändert weiterarbeiten.

Dies ist das letzte sichtbare Stück der Identität von Firma.dev in einem Signierprozess. Ein gebrandeter Editor, Ihre Bedingungen und jetzt Ihre Absenderadresse bedeuten, dass ein Unterzeichner den gesamten Prozess durchlaufen kann, ohne irgendwo unseren Namen 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. Vollständige Details zu Anfragen und Antworten finden Sie im API-Changelog, und der komplette White-Label-E-Signatur-API-Leitfaden führt Sie durch die Zusammenführung.

Starten Sie kostenlos mit Firma.dev, keine Kreditkarte erforderlich. Pay-as-you-go für 0,049 € pro Umschlag (~5¢ USD), keine monatlichen Mindestbeträge, keine Verträge.