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.
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.
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
In wenigen Minuten einsatzbereit
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.
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.
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.
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.
Schritt für Schritt, mit Screenshots.
Wie Betriebe Webhooks mit CaptiFi nutzen
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.
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.
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.
Häufig gestellte Fragen
Welche Tarife enthalten Webhooks?
Welche Ereignisse kann ich abonnieren?
Woher weiß ich, dass eine Anfrage wirklich von CaptiFi kam?
Was passiert, wenn mein Server ausgefallen ist?
Könnte ich dasselbe Ereignis zweimal erhalten?
Wer ist für die Gästedaten verantwortlich, sobald sie bei uns eintreffen?
Passt gut zu
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.