Webhooks sind zu bestimmende Ereignisse, die eine Aktion auslösen. Sie sind der einfachste Weg, um eine Benachrichtigung über ein Ereignis in einem anderen System zu erlangen. Webhooks könnte man daher auch als Universalschnittstelle zwischen unterschiedlichen Diensten, Webanwendungen und Apps verstehen.
- Ein Slack-Channel wird benachrichtigt, wenn ein neue Veranstaltungsanmeldung erstellt wird
- Eine E-Mail wird versendet, wenn ein neuer Mitgliedschaftsantrag eingeht
- Die eigene Software über eine Änderung in einem Mitgliedschaftsdatensatz benachrichtigt
Die Logik hinter den Webhooks ist ein simples Wenn-Dann: Wenn Ereignis X auftritt, schicke Daten an eine definierte URL: meinwebservice.example.de/aktionXY?. Der eingehende Dienste stellt diese eindeutige URL zur Verfügung und ermöglicht so das Auslösen der Aktion. Die Verzögerung zwischen Ereignis und Benachrichtigung beträgt bei AHOI etwa zwei bis zehn Sekunden.
Als mächtiges Werkzeug für die Automation können z.B. IFTTT oder Zapier genutzt werden, die verschiedene Dienste miteinander verbinden. Amazon Alexa oder Google Assistant, E-Mail, SMS, Dropbox oder OneDrive, Twitter oder Instagram, Cleverreach oder Mailchimp werden so direkt an AHOI angebunden. Für bestimmte Funktionsumfänge auf diesen Plattformen kann eine kostenpflichtig Version notwendig sein.
Eine Anleitung für Slack haben wir hier. Für andere Dienste schreibe dem AHOI-Team.
In AHOI derzeit unterstütze Ereignisse
| Ereignis | Auslösemoment |
|---|---|
| Mitglied angelegt | neues Mitglied wird gespeichert |
| Mitglied bearbeitet | Änderung am Mitglied wird gespeichert |
| Mitgliedschaftsantrag bearbeitet | Mitgliedschaftsantrag wird abgesendet |
| Veranstaltung angelegt | neue Veranstaltung wird gespeichert |
| Veranstaltung bearbeitet | geänderte Veranstaltungsinformation wird gespeichert |
| Veranstaltungsbuchung | neue Buchung für eine Veranstaltung ist eingetroffen |
| Buchungsupdate | Status oder E-Mail-Adresse einer Buchung wird geändert |
| Veranstaltungsanmeldung | ein neues Ticket wird in der Buchung angelegt (besonders interessant im Gruppenmodus) |
| Ticket eingecheckt | am Check-in wird ein Ticket erfasst |
| Forderung angelegt | neue Forderung gespeichert |
| Forderung bearbeitet | geänderte Forderung wird gespeichert |