Webhooks + CaptiFi
Laat gastaanmeldingen naar je eigen systemen sturen op het moment dat ze binnenkomen, met ondertekende payloads, automatische nieuwe pogingen en een afleverlogboek. Inbegrepen vanaf Growth.
Wat doet de integratie met Webhooks?
Webhooks sturen gebeurtenissen naar je eigen systemen op het moment dat ze gebeuren: een gast meldt zich voor het eerst aan op je wifi, of een terugkerende gast maakt opnieuw verbinding, en je boekingssysteem, CRM of automatiseringstool weet het een seconde later. Voeg maximaal vijf HTTPS-endpoints toe; elk verzoek is ondertekend met HMAC SHA-256, mislukte bezorgingen worden met backoff opnieuw geprobeerd en elke poging wordt 30 dagen gelogd. Voor teams met een eigen stack. Inbegrepen vanaf het Growth-abonnement.
Webhooks maken van CaptiFi een bron van gebeurtenissen voor de rest van je stack. In plaats van de API te vragen wat er is veranderd, geef je CaptiFi een HTTPS-URL en stuurt CaptiFi daar een bericht naartoe op het moment dat er iets gebeurt: een gast meldt zich voor het eerst aan op je wifi, of een gast die al eerder is geweest maakt opnieuw verbinding. Rewards, Events en reserveringen voegen hun eigen gebeurtenissen toe: een beloning uitgegeven of verzilverd, punten verdiend, een ticketbestelling betaald, ingecheckt of terugbetaald, iemand met een reservering of ticket die komt opdagen, en een tafelreservering die is bevestigd, gewijzigd of geannuleerd, waarvan de gasten zijn aangekomen of die als no-show is gemarkeerd. Ook een stap Naar je webhooks sturen in een van je Workflows stuurt een eigen gebeurtenis. Je boekingssysteem, CRM of automatiseringstool weet het een seconde later.
Voeg maximaal vijf endpoints toe, wat handig is om dezelfde gebeurtenissen naar een live systeem en een stagingsysteem te sturen, en vink per endpoint de gebeurtenissen aan die het moet ontvangen. Elk verzoek heeft een HMAC SHA-256-handtekening over de onbewerkte body, samen met de naam van de gebeurtenis en een bezorgings-ID, zodat je kunt bewijzen dat een payload van CaptiFi komt voordat je hem vertrouwt en een herhaling van hetzelfde ID als één gebeurtenis kunt behandelen.
De bezorging is gemaakt voor de praktijk. Een mislukte poging wordt automatisch met backoff opnieuw geprobeerd, elke poging wordt 30 dagen bewaard met de responscode en hoe lang je server erover deed, en een endpoint dat blijft falen wordt uitgeschakeld in plaats van eindeloos bestookt. Je kunt een testgebeurtenis versturen terwijl je bouwt, en een ondertekeningsgeheim vervangen wanneer dat nodig is. Webhook-payloads bevatten persoonsgegevens van gasten, dus CaptiFi verstuurt ze alleen via HTTPS, en zodra een kopie je systemen bereikt, gelden daarvoor je eigen bewaar- en verwijderverplichtingen.
Waarom Webhooks aan CaptiFi koppelen
Reageer zodra een gast binnenkomt
Een gast logt in en je systeem hoort het een seconde later, zodat welkomstflows, CRM-records en operationele meldingen bij aankomst afgaan en niet pas bij je volgende geplande poll.
Ondertekende payloads die je kunt verifiëren
Elk verzoek heeft een HMAC SHA-256-handtekening over de onbewerkte body plus een tijdstempel, zodat je alles kunt weigeren wat niet echt van CaptiFi komt en alles wat later opnieuw wordt afgespeeld.
Nieuwe pogingen en een bezorglogboek
Mislukte bezorgingen worden automatisch met backoff opnieuw geprobeerd, en elke poging wordt 30 dagen gelogd met de responscode en de duur. Dat beantwoordt de vraag "heeft CaptiFi het verstuurd, of heeft mijn server het geweigerd?" in een paar seconden.
Maximaal vijf endpoints, live en staging
Stuur dezelfde gebeurtenissen naar productie en een testomgeving, schakel een endpoint uit zonder het te verwijderen, verstuur een testgebeurtenis terwijl je bouwt en vervang een ondertekeningsgeheim wanneer je beveiligingsbeleid dat voorschrijft.
Welke gegevens naar Webhooks gaan
Binnen enkele minuten aan de slag
Voeg een endpoint toe
Open Webhooks in je CaptiFi-dashboard, plak de HTTPS-URL die gebeurtenissen moet ontvangen en vink de gebeurtenissen aan die je wilt. De URL moet HTTPS zijn: payloads bevatten persoonsgegevens van gasten en worden nooit onversleuteld verstuurd.
Verifieer de handtekening
Bereken een HMAC SHA-256 van het tijdstempel en de onbewerkte request-body met het ondertekeningsgeheim van je endpoint, vergelijk die in constante tijd met de header X-CaptiFi-Signature en weiger alles wat ouder is dan vijf minuten. Verifieer altijd voordat je een payload vertrouwt.
Verstuur een testgebeurtenis en ga live
Verstuur een testgebeurtenis vanuit het dashboard om te bevestigen dat je handler hem accepteert en schakel het endpoint daarna in. Antwoord met een willekeurige 2xx zodra je de gebeurtenis hebt geaccepteerd en doe het trage werk daarna.
Houd het bezorglogboek in de gaten
Elke poging staat erin met de gebeurtenis, het nummer van de poging, de responscode en de duur, en wordt 30 dagen bewaard. Ontdubbel op het ID van de gebeurtenis, zodat een nieuwe poging nooit twee keer wordt verwerkt.
Stap voor stap, met screenshots.
Zo gebruiken zaken Webhooks met CaptiFi
Een hotel stuurt elke nieuwe wifi-aanmelding bij aankomst door naar het CRM dat aan het PMS is gekoppeld, zodat de receptie een terugkerende gast gemarkeerd ziet voordat die bij de balie staat.
Een guest.returned-gebeurtenis activeert een interne melding voor vaste gasten, zodat het bedienend personeel trouwe restaurantgasten bij naam kan begroeten zonder dat iemand een dashboard in de gaten houdt.
Nieuwe aanmeldingen gaan rechtstreeks naar een low-code-automatiseringstool, die het contact toevoegt aan een e-mailplatform, het filiaal tagt en een reeks met een voucher voor het eerste bezoek start.
Veelgestelde vragen
Welke abonnementen bevatten webhooks?
Op welke gebeurtenissen kan ik me abonneren?
Hoe weet ik dat een verzoek echt van CaptiFi komt?
Wat gebeurt er als mijn server platligt?
Kan ik dezelfde gebeurtenis twee keer ontvangen?
Wie is verantwoordelijk voor de gastgegevens zodra ze bij ons zijn?
Goed te combineren met
Begin vandaag met Webhooks en CaptiFi
Gratis proefperiode van 30 dagen. Altijd opzegbaar.
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 en Incentivio zijn handelsmerken van hun respectieve eigenaren en staan hier alleen om de diensten aan te duiden waarmee CaptiFi koppelt. CaptiFi is onafhankelijk van deze bedrijven en wordt niet door hen gesponsord, gecertificeerd of goedgekeurd. Een integratie met de vermelding binnenkort staat op onze roadmap en is nog niet beschikbaar. Twilio en alle bijbehorende logo's zijn handelsmerken van Twilio Inc. of haar gelieerde ondernemingen. Salesforce is een handelsmerk van Salesforce, Inc. Slack is een handelsmerk en dienstmerk van Slack Technologies, Inc., geregistreerd in de VS en in andere landen.
CaptiFi is een platform voor gastenwifimarketing en captive portals voor restaurants, bars, pubs, koffiebars, hotels, sportscholen, salons, winkels en vakantieverhuur, gemaakt door CaptiFi Ltd in het Verenigd Koninkrijk en verkocht in GBP, USD, EUR, CAD, AUD en NZD aan zaken over de hele wereld.