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

Firma.dev ist die am besten als White-Label gestaltbare E-Signatur-API auf dem Markt, und drei vor Kurzem veröffentlichte Funktionen gehen noch einen Schritt weiter. Zusammen ermöglichen sie es Ihnen, das gesamte Signatur-Erlebnis von Anfang bis Ende an Ihre Marke anzupassen: 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 Funktionen die Lücken, in denen zuvor die Standardeinstellungen von Firma.dev sichtbar waren. Für eine ausführliche Anleitung zur Einrichtung einer White-Label-Konfiguration deckt der vollständige 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 Ihrem Branding

Die eingebetteten Editoren für Vorlagen und Signaturanfragen – also diejenigen, die Sie in Ihre eigenen Seiten integrieren – bieten nun fünf zusätzliche Farbsteuerungen. Sie erhalten Akzent (accent), Akzent-Vordergrund (accent foreground), Arbeitsfläche (canvas), gedämpfter Hintergrund (muted surface) und gedämpfter Text (muted text), die sich zu den bestehenden sechs für insgesamt elf hinzufügen. Das reicht aus, um das Design des Editors an Ihr Produkt anzupassen, anstatt sich mit einer Annäherung zufrieden zugeben.

Sie legen sie unter „Einstellungen“ im Bereich „Erscheinungsbild“ fest, inklusive einer Live-Vorschau und Überschreibungen pro Arbeitsbereich. Es gibt auch eine Kontrastwarnung, falls 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, aber für den Unterzeichner unlesbar ist.

Jede Farbe ist nullbar und vererbt sich in der Kette nach unten: Arbeitsbereich-Überschreibungen überschreiben das Unternehmen, das Unternehmen fällt 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 auf den Einstellungs-Endpunkten für Unternehmen als auch für Arbeitsbereiche 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 Allgemeinen 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 festlegen, entweder auf Unternehmens- oder Arbeitsbereichsebene, sodass ein Partner-Arbeitsbereich die Bedingungen der eigenen Marke tragen kann, während Ihr Standard überall sonst gilt. Sie können einen optionalen Link zu Ihren vollständigen Bedingungen anhängen und das Unterzeichnen optional hinter einen Schritt „Zustimmung zu den Bedingungen erforderlich“ schalten, dem die Unterzeichner aktiv zustimmen müssen, bevor sie fortfahren können.

Wenn ein Unterzeichner zustimmt, wird die Zustimmung serverseitig zusammen mit einem Inhalts-Hash genau der Bedingungen erfasst, die dem Benutzer angezeigt wurden. Dieser Hash geht in das Audit-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ü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 erzwingen, und Partner, die auf Basis 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 Boolean in den Unternehmens- und Arbeitsbereichseinstellungen, der im Arbeitsbereich nullbar ist, sodass er den Wert des Unternehmens 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 „Benutzerdefinierte 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.

Es handelt sich um einen Standard auf Unternehmensebene mit einer Überschreibung pro Arbeitsbereich, und der Arbeitsbereichswert hat Vorrang, 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 sowie 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 Signaturprozess. Ein gebrandeter Editor, Ihre eigenen Bedingungen und jetzt Ihre 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 aktiv. Ausführliche Angaben zu Anfragen und Antworten finden Sie im API-Changelog, und der vollständige Leitfaden für eine White-Label-E-Signatur-API führt Sie durch die Einrichtung.

Starten Sie kostenlos mit Firma.dev, keine Kreditkarte erforderlich. Pay-as-you-go für 0,029 $ pro Umschlag (2,9 ¢ USD), keine monatlichen Mindestumsätze, keine Verträge.