Ein Webhook ist eine automatische Nachricht zwischen Programmen. Zum Beispiel kann ein Unterschriftsdienst melden: “Dieser Vertrag wurde unterschrieben.”
Sheltra bietet keine frei einrichtbaren ausgehenden Webhooks für eure eigenen Programme. Du kannst also keine beliebige Zieladresse hinterlegen, an die Sheltra jedes neue Tier oder jede Spende meldet.
Bei eingebauten Verbindungen kann es dagegen Rückmeldungen an Sheltra geben. Einen solchen Rückmeldeweg musst du bei einem eigenen Zoho-Sign-Konto einrichten, damit Vertragszustände in Sheltra ankommen.
„Unsere Website soll neue Tiere automatisch zeigen“
Dafür muss eure Website die öffentliche Tierliste bei Sheltra abrufen. Die Adressen findest du unter Einstellungen → Öffentliche API.
Gib sie an eure Website-Betreuung weiter. Diese richtet den regelmäßigen Abruf ein. Der sichtbare Stand hängt dann vom Abrufabstand und einer möglichen Zwischenspeicherung der Website ab; er ist nicht zwingend im selben Moment aktuell wie Sheltra.
Welche Tiere und Angaben ausgegeben werden, erklärt Gibt es eine API?.
„Termine sollen in meiner Kalender-App erscheinen“
Dafür brauchst du keinen selbst eingerichteten Webhook. Öffne in Sheltra Kalender → Abonnieren und füge die Abo-URL in deiner Kalender-App als Kalender-Abo ein.
Die andere App holt die vorgesehenen Termine regelmäßig ab. Änderungen dort fließen nicht zurück nach Sheltra. Der Link ist privat und sollte wie ein Passwort behandelt werden.
„Ein Vertrag ist bei Zoho unterschrieben, bleibt in Sheltra aber offen“
Prüfe den Rückmeldeweg von Zoho Sign. Fehlt er oder ist er nicht vollständig eingerichtet, erfährt Sheltra möglicherweise nichts vom neuen Vertragszustand.
Lass einen Vertrag nicht nur wegen einer fehlenden Statusanzeige erneut unterschreiben. Prüfe zunächst in Zoho den tatsächlichen Stand und die vorhandenen Unterlagen.
Den Zoho-Rückmeldeweg einrichten
Für die folgenden Schritte brauchst du Zugriff auf die Zoho-Verbindung in Sheltra und die entsprechenden Verwaltungsrechte bei Zoho. Eine Person, die euer Zoho-Konto betreut, kann den zweiten Teil übernehmen.
- Öffne Marktplatz → Zoho Sign. Der Abschnitt Webhook erscheint, wenn das Zoho-Konto verbunden ist. Bei Mit Zoho verbinden muss zuerst die Verbindung hergestellt werden. Nicht im Plan weist auf den fehlenden Tarif hin; Zoho Sign ist ab Pro als Anbindung enthalten.
- Kopiere die im Abschnitt Webhook angezeigte Adresse über Kopieren. Das ist die Empfangsadresse von Sheltra, nicht eine Adresse eurer Vereinswebsite.
- Öffne im Verwaltungsbereich eures Zoho-Sign-Kontos Webhooks und hinterlege diese Adresse. Wähle die vier Ereignisse Completed by all, Declined, Expired und Recalled aus.
- Erzeuge in Sheltra über Generieren einen HMAC-Schlüssel und sichere ihn mit Secret speichern. Hinterlege genau denselben Wert auch bei Zoho.
Die Ereignisse bedeuten: von allen unterschrieben, abgelehnt, abgelaufen und zurückgerufen. Fehlt eines, wird genau dieser Fall nicht über den eingerichteten Rückmeldeweg gemeldet.
„Was ist ein HMAC-Schlüssel oder Secret?“
Beide Begriffe meinen hier denselben geheimen Prüfschlüssel. Mit ihm kann Sheltra kontrollieren, ob eine Rückmeldung zu der eingerichteten Zoho-Verbindung gehört.
Auf beiden Seiten muss derselbe Wert gespeichert sein. Fehlt er oder unterscheiden sich die Werte, weist Sheltra die Rückmeldungen ab. Nur die Adresse einzutragen, reicht nicht.
Behandle den Schlüssel wie ein Passwort und teile ihn nicht in öffentlichen Screenshots oder allgemeinen Supportnachrichten. Eine Änderung muss auf beiden Seiten abgestimmt erfolgen.
„Wo trage ich unsere eigene Zieladresse ein?“
Für einen allgemeinen ausgehenden Webhook gibt es dieses Feld nicht. Die Adresse im Zoho-Abschnitt ist zum Kopieren nach Zoho gedacht. Das Eingabefeld HMAC-Schlüssel erwartet einen geheimen Schlüssel, keine Website-Adresse.
Auch eigene API-Zugangsdaten für beliebige Programme werden nicht angeboten. Mehr dazu: Wie erstelle oder verwalte ich API-Schlüssel?.
Weitere Hilfe
Bleibt ein Vertragsstatus trotz vollständiger Einrichtung falsch, melde den betroffenen Vorgang und den bei Zoho sichtbaren Status an hallo@sheltra.cloud. Schicke den geheimen Schlüssel nicht mit.
Bei fehlenden Nachrichten oder Bankdaten hilft Was kann ich bei Synchronisierungsproblemen tun?. Fehlt euch ein bestimmter automatischer Ablauf, beschreibe, welches Ereignis an welches Programm gemeldet werden soll.
