Webhooks
Jedes Unternehmen hat eigene Abläufe. Mit Webhooks meldet Seamless Ereignisse an Ihre Systeme, zum Beispiel an eine Azure Logic App, Power Automate oder ein Ticketsystem. Dort entscheiden Sie selbst, was passiert: ein Ticket erstellen, eine E-Mail senden oder Daten in einem anderen System nachführen.
So funktioniert es
- Sie tragen in einer Vorlage die Adresse Ihres Systems ein.
- Tritt das Ereignis ein, sendet Seamless eine Meldung an diese Adresse.
- Ihr System verarbeitet die Meldung und antwortet mit
200.
Kommt die Meldung nicht an, versucht Seamless es erneut. Den Versand sehen Sie unter Monitoring > Webhooks.
Wo Sie Webhooks einrichten
| Ereignis | Wo |
|---|---|
| Neuer Antrag für ein Team | Vorlage Teams & Sites > Genehmigung |
| Team muss überprüft werden | Vorlage Teams & Sites > Lifecycle |
| Team archiviert | Vorlage Teams & Sites > Archivierung |
| Neue Einladung für einen Gast | Gästevorlage > Genehmigung |
| Einladung ausstehend, Gast inaktiv, gesperrt, gelöscht oder zu überprüfen | Gästevorlage > Lifecycle |
Die Felder
| Feld | Beschreibung |
|---|---|
| Notification endpoint | Adresse, an die Seamless die Meldung sendet |
| Secret | Optional: Geheimnis, das Seamless im Header mitsendet. So prüft Ihr System, dass die Meldung von Seamless kommt. |
Die Ereignisse
| Ereignis | Wann |
|---|---|
team.report.renewal | Ein Team muss überprüft werden |
team.archive | Ein Team wurde archiviert |
user.invite | Ein Gast wird eingeladen |
user.report.invitationAcceptance | Ein Gast hat die Einladung nicht angenommen |
user.delete.invitationAcceptance | Ein Gast mit ausstehender Einladung wurde gelöscht |
user.report.inactivity | Ein Gast ist inaktiv |
user.block.inactivity | Ein inaktiver Gast wurde gesperrt |
user.delete.inactivity | Ein inaktiver Gast wurde gelöscht |
user.report.renewal | Ein Gast muss überprüft werden |
Die Meldung
Seamless sendet die Meldung als JSON mit dem Ereignis und der ID des betroffenen Gastes oder Teams:
{
"payload": {
"userId": "f7a718c5-3c74-4ae3-874e-5d1db9..."
},
"eventType": "user.report.inactivity"
}Ein vollständiges Beispiel mit einer Azure Logic App finden Sie unter Beispiel: Inaktiver Gast.