Webhook einrichten
Webhooks in resmio sind ein leichtgewichtiger Trigger-Mechanismus, um externe Systeme in Echtzeit über Änderungen bei Reservierungen und Online-Bestellungen zu informieren.
Allgemeines
Vereinfacht gesagt, ermöglichen Webhooks resmio mit externen Systemen zu verbinden und diese automatisch über bestimmte Ereignisse zu informieren.
Beispiele für Ereignisse sind etwa erfolgreiche Reservierungen oder Bestellungen.
Der Webhook ist dabei eine automatische Benachrichtigung per HTTP-Request, die resmio an eine von dir hinterlegte URL sendet, sobald ein bestimmtes Ereignis eintritt.
Folgende Anwendungsszenarien sind denkbar:
- Event-getriebene Workflows (ein System soll auf bestimmte Ereignisse reagieren, ohne Details zu kennen)
- Interne Benachrichtigungen (du/das Team sollen informiert werden, dass etwas passiert ist)
- Zählungen und Status-Synchronisation (Drittanwendung zählt Ereignisse einfach mit)
- Monitoring und technische Prozesse
Typische Empfänger für resmio-Webhooks sind Automatisierungsplattformen wie Zapier, Make oder n8n, interne Server, Benachrichtigungssysteme (Slack, Teams) oder Reporting-Tools wie Google Sheets, die auf Ereignisse reagieren, ohne Reservierungs- oder Bestelldaten zu verarbeiten.
| Punkt | Beschreibung |
|---|---|
| Methode | HTTP POST |
| Authentifizierung | Basic Auth |
| Format | JSON |
| Payload | id, facility_id, action |
| Zweck | Trigger für externe Systeme |
| Detaildaten | Über API abrufen |
Einrichtung und Aktualisierung der Webhooks sind einfach direkt über dein resmio-Konto möglich.
- Logge dich in das System ein und gehe zu
Einstellungen > Integration > Entwickler > Webhooks - Füge mit Klick auf den Button + Webhook hinzufügen einen neuen Webhook ein.
- Folgende Angaben müssen für den Webhook angegeben werden:
- eine Ziel-URL für den HTTP-Request
- einen Nutzernamen (zur Autorisierung)
- das Passwort (zur Autorisierung)
- die gewünschte Aktion/das Ereignis
Einstellungen > Integration > Wenn dein Webhook in resmio gespeichert ist, sendet resmio beim Eintritt der ausgewählten Aktion automatisch einen HTTP-POST-Request an deine URL. Deine Anwendung nimmt den Request schließlich entgegen und kann darauf entsprechend reagieren (bspw. Daten speichern, einen bestimmten Prozess starten usw.).
Die Authentifizierung erfolgt über Basic Auth (Nutzername & Passwort). Diese Daten werden im HTTP-Header mitgesendet. Dein Server prüft die Zugangsdaten vor der Verarbeitung.
Aktuell stehen in resmio insgesamt sechs Webhook-Aktionen zur Verfügung.
| Bereich | Trigger | Bedeutung |
|---|---|---|
| Reservierungen (booking) | booking_created | Eine neue Reservierung wurde angelegt. |
| Reservierungen (booking) | booking_updated | Eine bestehende Reservierung wurde geändert (z. B. Uhrzeit, Personenzahl). |
| Reservierungen (booking) | booking_deleted | Eine Reservierung wurde storniert oder gelöscht. |
| Online-Bestellungen (productorder) | productorder_created | Eine neue Online-Bestellung ist eingegangen. |
| Online-Bestellungen (productorder) | productorder_updated | Eine bestehende Bestellung wurde geändert. |
| Online-Bestellungen (productorder) | productorder_deleted | Eine Bestellung wurde storniert oder gelöscht. |
Dabei enthält der Webhook-Request aktuell nur eine minimale Payload.
Ein Beispiel aus der Praxis:
{
"id": 51918313,
"facility_id": "the-fish",
"action": "BOOKING_CREATED"
}
Bei den enthaltenen Feldern handelt es sich um:
id
Die interne ID der Reservierung oder Bestellung, die von resmio vergeben wird
facility_id
Die einzigartige Kennung des resmio Kontos (Restaurant).
action
Das ausgelöste Ereignis, alle Webhook-Aktionen siehe Tabelle oben.
Der Webhook dient primär als Trigger, nicht als vollständiger Datentransport.
