Zum Hauptinhalt springen
Webhooks-Logo
Entwickler-Integration

Webhooks + CaptiFi

Lassen Sie Gästeanmeldungen in der Sekunde, in der sie passieren, an Ihre eigenen Systeme übertragen, mit signierten Payloads, automatischen Wiederholungen und einem Zustellprotokoll. Ab Growth enthalten.

Übersicht

Was macht die Webhooks-Integration?

Webhooks übertragen Ereignisse in dem Moment an Ihre eigenen Systeme, in dem sie passieren: Ein Gast meldet sich zum ersten Mal in Ihrem WLAN an oder ein wiederkehrender Gast verbindet sich erneut, und Ihr Buchungssystem, CRM oder Automatisierungstool weiß es eine Sekunde später. Fügen Sie bis zu fünf HTTPS-Endpunkte hinzu; jede Anfrage wird mit HMAC SHA-256 signiert, fehlgeschlagene Zustellungen werden mit Backoff wiederholt und jeder Versuch wird 30 Tage lang protokolliert. Für Teams mit eigenem Stack. Im Growth-Tarif und höher enthalten.

Webhooks machen CaptiFi zu einer Ereignisquelle für den Rest Ihrer Systemlandschaft. Statt die API zu fragen, was sich geändert hat, geben Sie CaptiFi eine HTTPS-URL, und CaptiFi sendet einen POST dorthin, sobald etwas passiert: Ein Gast meldet sich zum ersten Mal in Ihrem WLAN an, oder ein Gast, der schon einmal da war, verbindet sich erneut. Rewards, Events und Buchungen bringen ihre eigenen Ereignisse mit: eine ausgegebene oder eingelöste Prämie, gesammelte Punkte, eine bezahlte, eingecheckte oder erstattete Ticketbestellung, das Erscheinen eines Buchungs- oder Ticketinhabers und eine Tischreservierung, die bestätigt, geändert, storniert, als angekommen oder als nicht erschienen markiert wurde. Auch ein Schritt „An Ihre Webhooks senden“ in einem Ihrer Workflows sendet ein eigenes Ereignis. Ihr Buchungssystem, CRM oder Automatisierungstool erfährt eine Sekunde später davon.

Fügen Sie bis zu fünf Endpunkte hinzu, was praktisch ist, um dieselben Ereignisse an ein Live-System und ein Staging-System zu senden, und haken Sie die Ereignisse an, die jeder Endpunkt erhalten soll. Jede Anfrage trägt eine HMAC SHA-256-Signatur über den unveränderten Body sowie den Ereignisnamen und eine Zustell-ID, sodass Sie nachweisen können, dass eine Payload von CaptiFi stammt, bevor Sie ihr vertrauen, und eine Wiederholung derselben ID als ein einziges Ereignis behandeln können.

Die Zustellung ist für die Praxis gebaut. Ein fehlgeschlagener Versuch wird automatisch mit Backoff wiederholt, jeder Versuch wird 30 Tage lang mit dem Antwortcode und der Antwortzeit Ihres Servers aufgezeichnet, und ein Endpunkt, der immer wieder fehlschlägt, wird abgeschaltet, statt endlos weiter angefragt zu werden. Sie können ein Testereignis auslösen, während Sie entwickeln, und ein Signaturgeheimnis rotieren, wann immer es nötig ist. Webhook-Payloads enthalten personenbezogene Gästedaten, daher sendet CaptiFi sie nur über HTTPS, und sobald eine Kopie Ihre Systeme erreicht, gelten dafür Ihre eigenen Aufbewahrungs- und Löschpflichten.

Was Sie bekommen

Warum Webhooks mit CaptiFi verbinden

Reagieren Sie sofort, sobald ein Gast ankommt

Ein Gast meldet sich an, und Ihr System erfährt eine Sekunde später davon, sodass Willkommensstrecken, CRM-Datensätze und Betriebsmeldungen bei der Ankunft ausgelöst werden statt erst bei Ihrer nächsten geplanten Abfrage.

Signierte Payloads, die Sie überprüfen können

Jede Anfrage trägt eine HMAC SHA-256-Signatur über den unveränderten Body plus einen Zeitstempel, sodass Sie alles ablehnen können, was nicht wirklich von CaptiFi stammt, und alles, was später erneut eingespielt wird.

Wiederholungen und ein Zustellprotokoll

Fehlgeschlagene Zustellungen werden automatisch mit Backoff wiederholt, und jeder Versuch wird 30 Tage lang mit Antwortcode und Dauer protokolliert, was die Frage „Hat CaptiFi es gesendet oder hat mein Server es abgelehnt?“ in Sekunden beantwortet.

Bis zu fünf Endpunkte, live und Staging

Senden Sie dieselben Ereignisse an die Produktions- und an eine Testumgebung, schalten Sie einen Endpunkt aus, ohne ihn zu löschen, senden Sie beim Entwickeln ein Testereignis und erneuern Sie ein Signing Secret, wenn Ihre Sicherheitsrichtlinie es verlangt.

Welche Daten zu Webhooks fließen

guest.created: Ein Gast meldet sich zum ersten Mal in Ihrem WLAN an
guest.returned: Ein zurückkehrender Gast verbindet sich erneut
reward.issued, reward.redeemed, reward.redemption_voided und points.earned, aus Ihrem Prämienprogramm
ticket.order.paid, ticket.checked_in und ticket.order.refunded, von Events
reservation.attended: Ein Gast mit Buchung oder Ticket erscheint
booking.created, booking.amended, booking.cancelled, booking.attended und booking.no_show, aus Tischreservierungen
workflow.action: Ein Schritt „An Ihre Webhooks senden“ wird in einem Ihrer Workflows ausgeführt und überträgt die in diesem Schritt benannten Felder
Name, E-Mail und Telefon des Gastes, sofern erfasst
Status der Marketing- und Kontakteinwilligung
Der Standort und der Zeitstempel des Besuchs
Eine Zustell-ID pro Ereignis zur Deduplizierung
Wie es funktioniert

In wenigen Minuten einsatzbereit

1

Einen Endpunkt hinzufügen

Öffnen Sie Webhooks in Ihrem CaptiFi-Dashboard, fügen Sie die HTTPS-URL ein, die Ereignisse empfangen soll, und haken Sie die gewünschten Ereignisse an. Die URL muss HTTPS sein: Payloads enthalten personenbezogene Gästedaten und werden niemals unverschlüsselt gesendet.

2

Signatur verifizieren

Berechnen Sie mit dem Signing Secret Ihres Endpunkts einen HMAC SHA-256 über den Zeitstempel und den unveränderten Request-Body, vergleichen Sie ihn in konstanter Zeit mit dem Header X-CaptiFi-Signature und lehnen Sie alles ab, was älter als fünf Minuten ist. Prüfen Sie immer, bevor Sie einer Payload vertrauen.

3

Ein Testereignis senden und live gehen

Lösen Sie im Dashboard ein Testereignis aus, um zu bestätigen, dass Ihr Handler es annimmt, und schalten Sie dann den Endpunkt ein. Antworten Sie mit einem beliebigen 2xx-Code, sobald Sie das Ereignis angenommen haben, und erledigen Sie die langsame Arbeit danach.

4

Behalten Sie das Zustellprotokoll im Blick

Jeder Versuch wird mit Ereignis, Versuchsnummer, Antwortcode und Dauer aufgeführt und 30 Tage lang aufbewahrt. Deduplizieren Sie anhand der Ereignis-ID, damit ein erneuter Versuch nie zweimal verarbeitet wird.

Lesen Sie die Webhooks-Setup-Anleitung

Schritt für Schritt, mit Screenshots.

In der Praxis

Wie Betriebe Webhooks mit CaptiFi nutzen

Hotel

Ein Hotel überträgt jede neue WLAN-Anmeldung bei der Ankunft in sein mit dem PMS verknüpftes CRM, sodass die Rezeption einen wiederkehrenden Gast markiert sieht, bevor er den Empfang erreicht.

Restaurantgruppe

Ein guest.returned-Ereignis löst eine interne Benachrichtigung für Stammgäste aus, sodass das Serviceteam häufige Gäste mit Namen begrüßen kann, ohne dass jemand ein Dashboard beobachtet.

Einzelhandel

Neue Anmeldungen werden direkt an ein Low-Code-Automatisierungstool gesendet, das den Kontakt zu einer E-Mail-Plattform hinzufügt, die Filiale als Tag setzt und eine Gutscheinsequenz für den ersten Besuch startet.

FAQ

Häufig gestellte Fragen

Welche Tarife enthalten Webhooks?
Webhooks sind im Tarif Growth und höher enthalten, ohne Aufpreis, zusammen mit dem API-Zugang. Eine 30-tägige kostenlose Testphase im Tarif Growth oder Pro enthält sie, sodass Sie während der Testphase Webhooks entwickeln und testen können.
Welche Ereignisse kann ich abonnieren?
guest.created wird ausgelöst, wenn sich ein Gast zum ersten Mal in Ihrem WLAN anmeldet, und guest.returned, wenn sich ein Gast, der schon einmal da war, erneut verbindet. Konten mit aktivierten Prämien können reward.issued, reward.redeemed, reward.redemption_voided und points.earned hinzufügen; Konten mit aktivierten Events können ticket.order.paid, ticket.checked_in und ticket.order.refunded hinzufügen; und reservation.attended wird ausgelöst, wenn ein Gast mit Reservierung oder Ticket erscheint. Tischreservierungen bringen booking.created, booking.amended, booking.cancelled, booking.attended und booking.no_show mit, und workflow.action wird ausgelöst, wenn ein Schritt „An Ihre Webhooks senden“ in einem Ihrer Workflows ausgeführt wird. Sie haken pro Endpunkt die gewünschten Ereignisse an, sodass ein Endpunkt nur erhält, was er angefordert hat.
Woher weiß ich, dass eine Anfrage wirklich von CaptiFi kam?
Jede Anfrage trägt einen X-CaptiFi-Signature-Header, der einen Zeitstempel und einen HMAC SHA-256 über den Zeitstempel und den unveränderten Anfrage-Body enthält, berechnet mit dem Signaturgeheimnis Ihres Endpunkts. Prüfen Sie ihn in konstanter Zeit gegen den unveränderten Body, nicht gegen neu kodiertes JSON, und lehnen Sie alles ab, was älter als fünf Minuten ist. Jeder kann an Ihre URL posten, aber nur CaptiFi kann eine gültige Signatur erzeugen.
Was passiert, wenn mein Server ausgefallen ist?
Fehlgeschlagene Zustellungen werden automatisch mit Backoff wiederholt, und jeder Versuch wird 30 Tage lang mit Antwortcode und Dauer im Zustellprotokoll festgehalten. Ein Endpunkt, der immer wieder fehlschlägt, wird abgeschaltet, sodass das Protokoll genau zeigt, warum die Zustellungen aufgehört haben.
Könnte ich dasselbe Ereignis zweimal erhalten?
Ja, ein Netzwerkaussetzer kann bedeuten, dass ein erneuter Versuch eintrifft, nachdem Ihr Server den ersten bereits angenommen hat. Behandeln Sie Wiederholungen derselben Zustell-ID als ein einziges Ereignis: Speichern Sie die IDs, die Sie verarbeitet haben, und ignorieren Sie die, die Sie bereits gesehen haben.
Wer ist für die Gästedaten verantwortlich, sobald sie bei uns eintreffen?
Webhook-Payloads enthalten persönliche Gästedaten, sodass Sie, sobald eine Kopie in Ihren Systemen ist, der Verantwortliche dieser Kopie sind und Ihre eigenen Aufbewahrungs-, Sicherheits- und Löschverpflichtungen gelten. Das Löschen eines Gastes in CaptiFi löscht Ihre Kopie nicht.

Nutzen Sie Webhooks noch heute mit CaptiFi

30-tägige kostenlose Testphase. Jederzeit kündbar.

Google, Gmail, Mailchimp, Klaviyo, HubSpot, Salesforce, Facebook, Meta Pixel, Slack, Zapier, Twilio, Tripadvisor, Yelp, Trustpilot, Untappd, Feefo, REVIEWS.io, Yotpo, Toast, Square, SumUp, Airship, Revinate, Leat, Pepper, EmailOctopus, MailerLite und Incentivio sind Marken ihrer jeweiligen Eigentümer und erscheinen hier nur, um die Dienste zu identifizieren, mit denen CaptiFi verbunden ist. CaptiFi ist unabhängig von diesen Unternehmen und wird von ihnen nicht gesponsert, zertifiziert oder unterstützt. Eine als „demnächst verfügbar“ gekennzeichnete Integration steht auf unserer Roadmap und ist noch nicht verfügbar. Twilio und alle damit verbundenen Logos sind Markenzeichen von Twilio Inc. oder deren Tochtergesellschaften. Salesforce ist eine Marke von Salesforce, Inc. Slack ist eine Marke und Dienstleistungsmarke von Slack Technologies, Inc., die in den USA und in anderen Ländern registriert ist.

CaptiFi ist eine Plattform für Gäste-WLAN-Marketing und Captive Portal für Restaurants, Bars, Pubs, Cafés, Hotels, Fitnessstudios, Salons, den Einzelhandel und Kurzzeitvermietungen, entwickelt von CaptiFi Ltd im Vereinigten Königreich und in GBP, USD, EUR, CAD, AUD und NZD an Betriebe weltweit verkauft.