Elektronische Signatur (Clicksign)
Angebote zur elektronischen Signatur mit Ihrem eigenen Clicksign-Konto versenden (BYO-Modell).
Die Integration Elektronische Signatur mit Clicksign nutzt IHR Clicksign-Konto (BYO-Modell: Sie bringen Ihr eigenes Konto mit). Dokumente werden in Ihrem Clicksign-Konto erstellt und abgerechnet: Es entstehen für uns weder Kosten noch Marge noch Vermittlung. Wir verknüpfen nur die Felder und die Schaltfläche, um das Angebot zur Signatur zu senden.
Die Integration startet inaktiv: Es passiert nichts, bis Sie die Felder ausfüllen und aktivieren. Der Access Token und das Webhook-Secret werden verschlüsselt im CRM gespeichert und niemals wieder angezeigt.
Voraussetzungen
- Ein Clicksign-Konto (Sandbox zum Testen oder Produktion) mit API-Berechtigung.
- Zugriff auf das Clicksign-Dashboard, um den Access Token zu generieren (Einstellungen → API) und einen Webhook mit einem HMAC-Secret zu erstellen.
- In Sellio: Administratorzugriff, um die Zugangsdaten zu speichern und die Integration unter Einstellungen → Integrationen zu aktivieren.
Was Sie ausfüllen müssen
- Umgebung: Sandbox (zum Testen, unter sandbox.clicksign.com) oder Produktion (für den Echtbetrieb, unter app.clicksign.com). Jede Umgebung hat ihren eigenen Access Token.
- Access Token: der API-Zugriffstoken, generiert im Clicksign-Dashboard unter Einstellungen → API. Er authentifiziert die Aufrufe (über ?access_token=). Er wird verschlüsselt im CRM gespeichert.
- Webhook-Secret (HMAC): ein Secret, das Sie beim Erstellen des Webhooks in Clicksign selbst festlegen. Es dient zur Überprüfung der HMAC-SHA256-Signatur der Ereignisse, die Clicksign an uns sendet. Es wird verschlüsselt im CRM gespeichert.
So konfigurieren Sie es
- Öffnen Sie Einstellungen → Integrationen und suchen Sie die Karte „Elektronische Signatur (Clicksign)“.
- Wählen Sie die Umgebung, fügen Sie den Access Token und das Webhook-Secret ein und klicken Sie auf „Zugangsdaten speichern“.
- Kopieren Sie die angezeigte „Webhook-URL (Clicksign)“ und erstellen Sie in Clicksign → Einstellungen → API/Webhooks einen Webhook, der auf diese URL zeigt und exakt dasselbe Secret verwendet.
- Kehren Sie zum CRM zurück und klicken Sie auf „Aktivieren“.
So senden Sie ein Angebot zur Signatur
- Öffnen Sie eine Opportunity und gehen Sie zum Bereich Angebote.
- Klicken Sie bei der gewünschten Version auf „Signatur“ und geben Sie die E-Mail-Adresse des Unterzeichners ein (optional auch den Namen).
- Wenn DocuSign und Clicksign gleichzeitig aktiv sind, erscheinen zwei Schaltflächen („Über DocuSign senden“ und „Über Clicksign senden“) – wählen Sie Clicksign. Ist nur Clicksign aktiv, verwendet eine einzige Schaltfläche bereits diesen Dienst.
- Das CRM erstellt das Dokument in Clicksign, fügt den Unterzeichner hinzu und fordert die Signatur an; Clicksign sendet dem Unterzeichner die Signatur-E-Mail.
- Während der Unterzeichner den Prozess durchläuft, erscheint der Status in der Liste „Signaturen“ des Angebots (Gesendet → Zugestellt → Signiert).
💡 Sobald das Dokument vollständig signiert ist (Abschlussereignis von Clicksign) und die Anfrage mit einem Angebot verknüpft ist, wird das Angebot automatisch als angenommen markiert. Webhooks werden per HMAC-SHA256-Signatur überprüft (Content-Hmac-Header): Stimmt das Secret nicht überein, wird das Ereignis abgelehnt. Wenn Sie versuchen zu senden, ohne Clicksign konfiguriert zu haben, warnt Sie das CRM deutlich, und die Funktion bleibt inaktiv, bis die Zugangsdaten hinterlegt sind.
So testen Sie es
- Verwenden Sie die Sandbox-Umgebung mit dem Sandbox-Access-Token.
- Klicken Sie bei einem Angebot auf „Signatur“, geben Sie Ihre eigene E-Mail-Adresse als Unterzeichner ein und bestätigen Sie.
- Bestätigen Sie, dass Sie die Clicksign-E-Mail erhalten haben und dass die Liste „Signaturen“ „Gesendet“ anzeigt.
- Signieren Sie das Dokument und prüfen Sie, ob der Status auf „Signiert“ wechselt und das Angebot als angenommen markiert wird – ein Zeichen, dass der Webhook (mit gültigem HMAC) angekommen ist.
Fehlerbehebung
- 401 beim Senden: Der Access Token ist falsch oder stammt aus einer anderen Umgebung (ein Sandbox-Token wurde in der Produktion verwendet oder umgekehrt). Überprüfen Sie die Umgebung und fügen Sie den Token für diese Umgebung erneut ein.
- Der Status des Angebots wird nicht aktualisiert: Der Webhook kommt nicht an oder die Signaturprüfung schlägt fehl. Vergewissern Sie sich, dass der Webhook in Clicksign auf die „Webhook-URL (Clicksign)“ zeigt und EXAKT dasselbe im CRM gespeicherte Secret verwendet (Content-Hmac-Header, HMAC-SHA256).
- Ereignis abgelehnt (ungültige Signatur): Das Webhook-Secret unterscheidet sich zwischen Clicksign und dem CRM. Speichern Sie auf beiden Seiten denselben Wert.
- Beim Senden passiert nichts: Die Integration ist wegen fehlender Zugangsdaten inaktiv oder wurde nicht aktiviert. Füllen Sie Umgebung + Token + Secret aus und klicken Sie auf Aktivieren.