Naar de hoofdinhoud
Logo van Webhooks
Integratie voor ontwikkelaars

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.

Overzicht

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.

Wat je krijgt

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

guest.created: een gast meldt zich voor het eerst aan op je wifi
guest.returned: een terugkerende gast maakt opnieuw verbinding
reward.issued, reward.redeemed, reward.redemption_voided en points.earned, uit je Rewards-programma
ticket.order.paid, ticket.checked_in en ticket.order.refunded, uit Events
reservation.attended: iemand met een reservering of ticket komt opdagen
booking.created, booking.amended, booking.cancelled, booking.attended en booking.no_show, uit tafelreserveringen
workflow.action: een stap Naar je webhooks sturen wordt uitgevoerd in een van je Workflows, met de velden die bij die stap zijn genoemd
Naam, e-mailadres en telefoonnummer van de gast, als die zijn vastgelegd
Status van de toestemming voor marketing en contact
De locatie en het tijdstempel van het bezoek
Een bezorgings-ID per gebeurtenis, voor ontdubbeling
Zo werkt het

Binnen enkele minuten aan de slag

1

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.

2

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.

3

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.

4

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.

Lees de installatiehandleiding voor Webhooks

Stap voor stap, met screenshots.

In de praktijk

Zo gebruiken zaken Webhooks met CaptiFi

Hotel

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.

Restaurantgroep

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.

Retail

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.

FAQ

Veelgestelde vragen

Welke abonnementen bevatten webhooks?
Webhooks zijn inbegrepen vanaf het Growth-abonnement, zonder extra kosten, samen met API-toegang. Ze zitten ook in een gratis proefperiode van 30 dagen die je op Growth of Pro start, dus je kunt tijdens de proefperiode webhooks bouwen en testen.
Op welke gebeurtenissen kan ik me abonneren?
guest.created gaat af als een gast zich voor het eerst aanmeldt op je wifi, en guest.returned gaat af als een gast die al eerder is geweest opnieuw verbinding maakt. Accounts waar Rewards aanstaat kunnen reward.issued, reward.redeemed, reward.redemption_voided en points.earned toevoegen; accounts waar Events aanstaat kunnen ticket.order.paid, ticket.checked_in en ticket.order.refunded toevoegen; en reservation.attended gaat af als iemand met een reservering of ticket komt opdagen. Tafelreserveringen voegen booking.created, booking.amended, booking.cancelled, booking.attended en booking.no_show toe, en workflow.action gaat af als een stap Naar je webhooks sturen wordt uitgevoerd in een van je Workflows. Je vinkt per endpoint de gebeurtenissen aan die je wilt, dus een endpoint ontvangt alleen waar het om heeft gevraagd.
Hoe weet ik dat een verzoek echt van CaptiFi komt?
Elk verzoek heeft een header X-CaptiFi-Signature met een tijdstempel en een HMAC SHA-256 van het tijdstempel en de onbewerkte request-body, met het ondertekeningsgeheim van je endpoint als sleutel. Verifieer die in constante tijd tegen de onbewerkte body, niet tegen opnieuw gecodeerde JSON, en weiger alles wat ouder is dan vijf minuten. Iedereen kan naar je URL posten, maar alleen CaptiFi kan een geldige handtekening maken.
Wat gebeurt er als mijn server platligt?
Mislukte bezorgingen worden automatisch met backoff opnieuw geprobeerd, en elke poging wordt 30 dagen in het bezorglogboek bewaard met de responscode en de duur. Een endpoint dat blijft falen wordt uitgeschakeld, dus het logboek laat precies zien waarom de bezorgingen zijn gestopt.
Kan ik dezelfde gebeurtenis twee keer ontvangen?
Ja, door een netwerkhapering kan een nieuwe poging binnenkomen nadat je server de eerste poging al had geaccepteerd. Behandel herhalingen van hetzelfde bezorgings-ID als één gebeurtenis: leg de ID's vast die je hebt verwerkt en negeer de ID's die je al hebt gezien.
Wie is verantwoordelijk voor de gastgegevens zodra ze bij ons zijn?
Webhook-payloads bevatten persoonsgegevens van gasten, dus zodra een kopie in je systemen staat, ben jij de verwerkingsverantwoordelijke voor die kopie en gelden je eigen verplichtingen voor bewaren, beveiligen en verwijderen. Een gast verwijderen in CaptiFi verwijdert jouw kopie niet.

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.