Andere Systeme per Webhook benachrichtigen
Ein Webhook meldet einem anderen System (zum Beispiel Ihrem Archiv oder CRM), sobald in actaSIGN etwas passiert, etwa wenn eine Anfrage abgeschlossen ist. Das andere System holt sich die Details dann über die Links in der Meldung.
Einen Webhook einrichten
Abschnitt betitelt „Einen Webhook einrichten“
- Klicken Sie auf Webhook hinzufügen und geben Sie einen Name ein.
- Endpunkt-URL: die Adresse des empfangenden Systems. Sie muss mit
https://beginnen. - Ereignisse: Wählen Sie, was gemeldet wird. Alle auswählen markiert alle einer Gruppe.
- Signatur-Secret: Klicken Sie auf Secret erzeugen und geben Sie den Wert sofort an den Integrator weiter. Er wird nur einmal angezeigt.
- Signierte Links ohne API-Token: Ist das eingeschaltet, funktionieren die Links in der Meldung ohne API-Zugang. Wählen Sie dann die Gültigkeitsdauer der Links so kurz wie möglich.
- Klicken Sie auf Speichern.
Die Ereignisse:
| Gruppe | Ereignisse |
|---|---|
| Aufgabe | Aufgabe aktiviert, Aufgabe abgeschlossen, Aufgabe abgelehnt, Aufgabe weitergeleitet, Aufgabe neu zugewiesen, Erinnerung gesendet |
| Signaturanfrage | Vorgang gestartet, Vorgang abgeschlossen, Vorgang zurückgezogen, Frist abgelaufen, Vorgang abgebrochen, Vorgang geschlossen |
Testen und überwachen
Abschnitt betitelt „Testen und überwachen“
- Webhook hinzufügen
- Testen schickt eine Testmeldung an die Endpunkt-URL.
- Pausieren hält den Webhook an, ohne die Einstellungen zu verlieren; Aktivieren schaltet ihn wieder ein.
- Das Uhr-Symbol öffnet die Zustellungen.
Jede Zustellung hat einen Status: Eingereiht, Wird gesendet, Zugestellt oder Fehlgeschlagen. Eine fehlgeschlagene Zustellung senden Sie mit Wiederholen erneut.
Gut zu wissen
Abschnitt betitelt „Gut zu wissen“- Scheitern viele Zustellversuche in Folge (standardmässig 20), setzt actaSIGN den Webhook aus (Ausgesetzt). Solange er ausgesetzt ist, gehen keine Meldungen an ihn. Ist das empfangende System wieder erreichbar, klicken Sie auf Fortsetzen. Eine neue Endpunkt-URL setzt ihn ebenfalls fort.
- Jede Meldung ist mit dem Secret signiert, damit das empfangende System prüfen kann, dass sie von actaSIGN kommt.
- Mit Stift und Papierkorb bearbeiten oder löschen Sie einen Webhook. Nach dem Löschen erhält das System keine Meldungen mehr; eingereihte Zustellungen verfallen.