Elektronische Signatur (DocuSign)

Senden Sie Angebote zur elektronischen Signatur mit Ihrem eigenen DocuSign-Konto (BYO-Modell).

Die Integration für elektronische Signatur nutzt IHR DocuSign-Konto (BYO-Modell: Sie bringen Ihr eigenes Konto mit). Envelopes werden in Ihrem DocuSign-Konto erstellt und abgerechnet: Es gibt keine Kosten, keine Marge und keine Vermittlung unsererseits. Wir verdrahten nur die Felder und den Button zum Senden des Angebots zur Signatur.

Die Integration startet inaktiv: Nichts passiert, bis Sie die Felder ausfüllen und aktivieren. Der Access Token wird verschlüsselt im CRM gespeichert und nie erneut angezeigt.

Voraussetzungen

• Ein DocuSign-Konto (Demo-/Testumgebung oder Produktionsumgebung) mit Berechtigung zum Senden von Envelopes.
• Zugriff auf das DocuSign-Dashboard, um Apps and Keys einzusehen (Account ID und Base URI), einen OAuth-Access-Token zu erstellen und DocuSign Connect zu konfigurieren (Admin → Connect).
• In Sellio: Administratorzugriff, um die Zugangsdaten zu speichern und die Integration unter Einstellungen → Integrationen zu aktivieren.

Was Sie ausfüllen müssen

• Account ID (API Account ID): die Kennung Ihres DocuSign-Kontos, zu finden unter Settings → Apps and Keys im DocuSign-Dashboard.
• Account Base URI: die Basisadresse Ihres Kontos, in der Testumgebung https://demo.docusign.net, in der Produktionsumgebung etwas wie https://na3.docusign.net (die Subdomain variiert je nach Konto; sie erscheint auf demselben Apps-and-Keys-Bildschirm).
• Access token (OAuth): ein in DocuSign erzeugter Access Token, um die Aufrufe zu autorisieren. Er wird verschlüsselt im CRM gespeichert.
• Connect HMAC key (erforderlich, um Webhooks zu empfangen): der geheime Schlüssel, mit dem DocuSign jeden Webhook signiert. Aktivieren Sie HMAC unter Admin → Connect und kopieren Sie den erzeugten Schlüssel. Ohne ihn werden Webhooks abgelehnt (der Signaturstatus schreitet dann nicht von selbst voran).

Konfiguration

1. Öffnen Sie Einstellungen → Integrationen und suchen Sie die Karte „Elektronische Signatur (DocuSign)“.
2. Fügen Sie die Account ID, die Base URI, den Access Token und den Connect HMAC Key ein und klicken Sie auf „Zugangsdaten speichern“.
3. Kopieren Sie die angezeigte „Webhook-URL (DocuSign Connect)“ und erstellen Sie in DocuSign unter Admin → Connect eine benutzerdefinierte Konfiguration, die auf diese URL zeigt und die Envelope-Ereignisse (sent, delivered, completed, declined, voided) markiert.
4. Aktivieren Sie in derselben Connect-Konfiguration HMAC (Include HMAC signature) mit demselben Schlüssel, den Sie im CRM eingefügt haben. DocuSign signiert dann jedes Ereignis im Header X-DocuSign-Signature-1, und das CRM überprüft es.
5. Kehren Sie zum CRM zurück und klicken Sie auf „Aktivieren“.

So senden Sie ein Angebot zur Signatur

1. Öffnen Sie eine Opportunity und wechseln Sie zum Bereich Angebote.
2. Klicken Sie bei der gewünschten Version auf „Signatur“, geben Sie die E-Mail-Adresse (und optional den Namen) des Unterzeichners ein und bestätigen Sie.
3. Das CRM erstellt in DocuSign einen Envelope mit dem Angebotsdokument und sendet die Signatur-E-Mail an den Unterzeichner.
4. Während der Unterzeichner voranschreitet, erscheint der Status in der Liste „Signaturen“ des Angebots (Gesendet → Zugestellt → Unterzeichnet).

Heute erfolgt die Authentifizierung über einen von Ihnen eingefügten Access Token (der einfachste Weg). Eine zukünftige Weiterentwicklung ist der JWT Grant (Integration Key + privater Schlüssel), der den Token automatisch erneuert, ohne manuelles Einfügen.

So testen Sie

1. Verwenden Sie die Demo-Umgebung (Base URI https://demo.docusign.net) mit einem Test-Access-Token.
2. Klicken Sie bei einem Angebot auf „Signatur“, geben Sie Ihre eigene E-Mail-Adresse als Unterzeichner ein und bestätigen Sie.
3. Prüfen Sie, ob Sie die DocuSign-E-Mail erhalten haben und die Liste „Signaturen“ des Angebots „Gesendet“ zeigt.
4. Unterschreiben Sie das Dokument; bestätigen Sie, dass der Status voranschreitet (Zugestellt → Unterzeichnet) und das Angebot als angenommen markiert wird, ein Zeichen, dass DocuSign Connect das CRM erreicht hat.

Fehlerbehebung

• 401 beim Senden: Der Access Token ist abgelaufen (DocuSign-OAuth-Tokens sind kurzlebig) oder falsch. Erstellen Sie einen neuen Token und fügen Sie ihn erneut ein. Die Account ID und die Base URI müssen aus DEMSELBEN Konto stammen.
• Konto-/URL-Fehler: Bestätigen Sie die korrekte Base URI (demo.docusign.net im Test; naX.docusign.net in Produktion, wobei die Subdomain unter Apps and Keys erscheint) und die API Account ID.
• Der Status aktualisiert sich nicht beim Angebot: DocuSign Connect kommt nicht an ODER die HMAC-Signatur stimmt nicht überein. Bestätigen Sie unter Admin → Connect die Konfiguration, die auf die „Webhook-URL (DocuSign Connect)“ zeigt, mit den Envelope-Ereignissen und mit aktiviertem HMAC unter Verwendung DESSELBEN im CRM eingefügten Schlüssels.
• Webhook abgelehnt (ungültige Signatur / kein HMAC-Schlüssel): Aus Sicherheitsgründen akzeptiert das CRM nur signierte Webhooks. Ist der Connect-HMAC-Schlüssel im CRM nicht ausgefüllt oder unterscheidet sich vom von DocuSign verwendeten, werden Ereignisse abgelehnt. Gleichen Sie denselben Schlüssel auf beiden Seiten ab und aktivieren Sie HMAC in Connect erneut.
• Der Button erscheint nicht / nichts passiert: Die Integration ist mangels Zugangsdaten inaktiv oder wurde nicht aktiviert. Füllen Sie die Felder aus und klicken Sie auf Aktivieren.
• 404 bei der Connect-URL: Die Integration wurde deaktiviert, oder das URL-Token hat sich geändert. Reaktivieren Sie und konfigurieren Sie die URL in DocuSign neu.

Open this article inside the system →