Which plans include webhooks?

Webhooks are included on the Growth plan and above, at no extra cost, alongside API access. A 30-day free trial started on Growth or Pro includes it, so you can build and test webhooks during the trial.

Which events can I subscribe to?

guest.created fires when a guest signs up on your WiFi for the first time, and guest.returned fires when a guest who has been before connects again. Accounts with Rewards on can add reward.issued, reward.redeemed, reward.redemption_voided and points.earned; accounts with Events on can add ticket.order.paid, ticket.checked_in and ticket.order.refunded; and reservation.attended fires when a booking or ticket holder turns up. Table bookings add booking.created, booking.amended, booking.cancelled, booking.attended and booking.no_show, and workflow.action fires when a Send to your webhooks step runs in one of your Workflows. You tick the events you want per endpoint, so an endpoint only receives what it asked for.

How do I know a request really came from CaptiFi?

Every request carries an X-CaptiFi-Signature header containing a timestamp and an HMAC SHA-256 of the timestamp and the raw request body, keyed with your endpoint signing secret. Verify it in constant time against the raw body, not re-encoded JSON, and reject anything more than five minutes old. Anyone can post to your URL, but only CaptiFi can produce a valid signature.

What happens if my server is down?

Failed deliveries retry automatically with backoff, and every attempt is recorded in the delivery log for 30 days with the response code and duration. An endpoint that keeps failing is switched off, so the log shows exactly why deliveries stopped.

Could I receive the same event twice?

Yes, a network hiccup can mean a retry lands after your server already accepted the first attempt. Treat repeats of the same delivery id as one event: record the ids you have processed and ignore ones you have already seen.

Who is responsible for the guest data once it reaches us?

Webhook payloads contain guest personal data, so once a copy is in your systems you are the controller of that copy and your own retention, security and deletion obligations apply. Deleting a guest in CaptiFi does not delete your copy.

Intégration développeur

Webhooks + CaptiFi

Faites envoyer les inscriptions des invités sur vos propres systèmes dès qu’elles ont lieu, avec des charges utiles signées, des essais automatiques et un journal de livraison. Inclus sur Growth et au-dessus.

Commencer l’essai gratuit Voir toutes les intégrations

Aperçu

Que fait l’intégration Webhooks ?

Webhooks push events to your own systems the moment they happen: a guest signs up on your WiFi for the first time, or a returning guest connects again, and your booking system, CRM or automation tool knows a second later. Add up to five HTTPS endpoints; each request is signed with HMAC SHA-256, failed deliveries retry with backoff and every attempt is logged for 30 days. For teams with their own stack. Included on the Growth plan and above.

Les webhooks transforment CaptiFi en source d’événements pour le reste de votre pile. Au lieu de demander à l’API ce qui a changé, vous donnez à CaptiFi une URL HTTPS et CaptiFi y publie dès qu’il se passe quelque chose : un invité s’inscrit sur votre WiFi pour la première fois, ou un invité qui y est déjà allé se reconnecte. Les récompenses, événements et réservations ajoutent les leurs : une récompense émise ou échangée, des points gagnés, une commande de billet payée, enregistrée ou remboursée, un réservateur ou un détenteur de billet qui arrive, et une réservation de table confirmée, modifiée, annulée, arrivée ou marquée comme absente. Une étape Envoyer à vos webhooks dans l’un de vos flux de travail publie aussi son propre événement. Votre système de réservation, CRM ou outil d’automatisation en est informé une seconde plus tard.

Ajoutez jusqu’à cinq points de terminaison, ce qui est pratique pour pointer les mêmes événements vers un système en ligne et un système de staging, et cochez les événements que chaque point devrait recevoir. Chaque requête porte une signature HMAC SHA-256 sur le corps brut, ainsi que le nom de l’événement et un identifiant de livraison, afin de prouver qu’une charge utile vient de CaptiFi avant de lui faire confiance et de traiter une répétition du même identifiant comme un seul événement.

La livraison est conçue pour le monde réel. Une tentative ratée tente automatiquement avec un backoff, chaque tentative est enregistrée pendant 30 des jours avec le code de réponse et le temps de votre serveur, et un point de terminaison qui continue de tomber en panne est désactivé au lieu d’être martelé indéfiniment. Vous pouvez lancer un événement test pendant la construction, et faire tourner un secret de signature quand vous en avez besoin. Les payloads Webhook contiennent des données personnelles invitées, donc CaptiFi ne les enverra que via HTTPS, et une fois qu’une copie arrive dans vos systèmes, vos propres obligations de rétention et de suppression s’appliquent à celle-ci.

Ce que tu obtiens

Pourquoi connecter les Webhooks à CaptiFi

Réagir dès qu’un invité arrive

Un invité se connecte et votre système en est informé une seconde plus tard, donc les voyages de bienvenue, les dossiers CRM et les alertes opérationnelles s’activent à l’arrivée au lieu de lors de votre prochain sondage programmé.

Payloads signés, vous pouvez vérifier

Chaque requête porte une signature HMAC SHA-256 sur le corps brut ainsi qu’un horodatage, donc vous pouvez rejeter tout ce qui ne vient pas vraiment de CaptiFi et tout ce qui est rejoué plus tard.

Essais et journal de livraison

Les échecs réessaient automatiquement avec un backoff, et chaque tentative est enregistrée pendant 30 des jours avec le code de réponse et la durée, qui répond en quelques secondes « est-ce que CaptiFi l’a envoyé, ou mon serveur l’a-t-il rejeté ? ».

Jusqu’à cinq points de terminaison, en direct et staging

Pointez les mêmes événements vers la production et un environnement de test, désactivez un point de terminaison sans le supprimer, envoyez un événement de test pendant la compilation, et faites pivoter un secret de signature quand votre politique de sécurité le permet.

Quelles données sont transférées vers Webhooks

guest.created : un invité s’inscrit pour la première fois sur votre WiFi

Invité.Retourné : Un invité de retour se connecte à nouveau

reward.issue, reward.redeemed, reward.redemption_voided et points.earned, de votre programme Rewards

ticket.order.paid, ticket.checked_in et ticket.order.remboursé, des événements

reservation.attended : un détenteur de réservation ou de billet se présente

booking.created, booking.amended, booking.cancelled, booking.attended et booking.no_show, à partir des réservations de tables

workflow.action : une étape Envoyer à vos webhooks s’exécute dans l’un de vos flux de travail, en transportant les champs nommés sur cette étape

Le nom de l’invité, son e-mail et son téléphone ont été capturés

État de marketing et de consentement de contact

Le lieu et l’horodatage de la visite

Un identifiant de livraison par événement, pour la déduplication

Comment ça fonctionne

Prêt en quelques minutes

Ajouter un point de terminaison

Ouvrez Webhooks dans votre tableau de bord CaptiFi, collez l’URL HTTPS qui devrait recevoir les événements, et cochez les événements que vous souhaitez. L’URL doit être HTTPS : les charges utiles contiennent des données personnelles des invités et ne sont jamais envoyées sans chiffrement.

Vérifiez la signature

Calculez un SHA256 - HMAC de l’horodatage et du corps brut de la requête en utilisant votre secret de signature de terminaison, comparez-le en temps constant avec l’en-tête X-CaptiFi-Signature, et rejetez tout ce qui date de plus de cinq minutes. Vérifiez toujours avant de faire confiance à une charge utile.

Envoyez un événement test et lancez-vous

Lancez un événement de test depuis le tableau de bord pour confirmer que votre gestionnaire l’accepte, puis activez le point de terminaison. Répondez avec n’importe quel 2xx dès que vous avez accepté l’événement et faites le travail lent ensuite.

Regardez le journal des livraisons

Chaque tentative est indiquée avec l’événement, le numéro de tentative, le code de réponse et la durée, conservés pendant 30 jours. Dédupliquez sur l’identifiant de l’événement afin qu’une nouvelle tentative ne soit jamais traitée deux fois.

Lisez le guide de configuration de Webhooks

Étape par étape, avec des captures d’écran.

Dans le monde réel

Comment les lieux utilisent les Webhooks avec CaptiFi

Hôtel

Un hôtel pousse chaque nouvelle inscription WiFi dans son CRM lié au PMS à l’arrivée, de sorte que la réception voit un client de retour signalé avant qu’il n’atteigne le comptoir.

Groupe de restauration

Un événement guest.returned déclenche une alerte interne pour les habitués, permettant à l’équipe de salle de saluer les clients fréquents par leur nom sans que personne ne surveille un tableau de bord.

Vente au détail

Les nouvelles inscriptions sont publiées directement dans un outil d’automatisation low-code, qui ajoute le contact à une plateforme email, identifie l’agence du magasin et lance une séquence de bons de première visite.

FAQ

Questions fréquemment posées

Quels forfaits incluent les webhooks ?

Les webhooks sont inclus dans le plan Growth et les versions supérieures, sans frais supplémentaires, ainsi que l’accès à l’API. Un 30essai gratuit d’une journée sur Growth ou Pro l’inclut, vous permettant de créer et tester des webhooks pendant l’essai.

À quels événements puis-je m’abonner ?

guest.created déclenche lorsqu’un invité s’inscrit sur votre WiFi pour la première fois, et guest.returned déclenche lorsqu’un invité qui y était déjà allé se connecte à nouveau. Les comptes avec Récompenses activés peuvent ajouter reward.issued, reward.redeemed, reward.redemption_voided et points.earned ; les comptes avec Événements activés peuvent ajouter ticket.order.paid, ticket.checked_in et ticket.order.refunded ; et reservation.attended déclenche lorsqu’un titulaire de réservation ou de billet se présente. Réservations de table : ajouter booking.created, booking.amended, booking.cancelled, booking.attended et booking.no_show, et workflow.action se déclenche lorsqu’une étape Envoyer à vos webhooks s’exécute dans l’un de vos workflows. Vous cochez les événements que vous souhaitez par terminaison, donc un endpoint ne reçoit que ce qu’il a demandé.

Comment savoir si une demande vient vraiment de CaptiFi ?

Chaque requête porte un en-tête X-CaptiFi-Signature contenant un horodatage et un HMAC SHA-256 de l’horodatage et du corps brut de la requête, indexés avec le secret de signature de votre point de terminaison. Vérifiez-le en temps constant par rapport au corps brut, pas par le JSON re-encodé, et rejetez tout ce qui a plus de cinq minutes. N’importe qui peut poster sur votre URL, mais seul CaptiFi peut produire une signature valide.

Que se passe-t-il si mon serveur est en panne ?

Les livraisons ratées réessaient automatiquement avec un arrêt, et chaque tentative est enregistrée dans le journal de livraison pendant 30 jours avec le code de réponse et la durée. Un point de terminaison qui échoue constamment est désactivé, donc le journal montre exactement pourquoi les livraisons se sont arrêtées.

Pourrais-je recevoir le même événement deux fois ?

Oui, un problème réseau peut signifier qu’une tentative de reprise tombe après que votre serveur ait déjà accepté la première tentative. Traitez les répétitions du même identifiant de livraison comme un seul événement : enregistrez les identifiants que vous avez traités et ignorez ceux que vous avez déjà vus.

Qui est responsable des données des invités une fois qu’elles nous parviennent ?

Les charges utiles Webhook contiennent des données personnelles invitées, donc une fois une copie dans vos systèmes, vous en êtes le responsable et vos propres obligations de rétention, de sécurité et de suppression s’appliquent. Supprimer un invité dans CaptiFi ne supprime pas votre copie.

S’accorde bien avec

CaptiFi REST API Zapier Slack

Commencez dès aujourd’hui à utiliser Webhooks avec CaptiFi

30-Jour d’essai gratuit. Annulez à tout moment.

Commencer l’essai gratuit Parcourez toutes les intégrations

Google, Gmail, Mailchimp, Klaviyo, HubSpot, Salesforce, Facebook, Meta Pixel, Slack, Zapier, Twilio, Tripadvisor, Yelp, Trustpilot, Untappd, Feefo, REVIEWS.io, Yotpo, Square, SumUp, Airship, Revinate, Leat, Pepper, EmailOctopus, MailerLite et Incentivio sont des marques de leurs propriétaires respectifs et apparaissent ici uniquement pour identifier les services auxquels CaptiFi est connecté. CaptiFi est indépendant de ces entreprises et n’est ni sponsorisé, ni certifié ni approuvé par elles. Une intégration à venir bientôt figure sur notre feuille de route et n’est pas encore disponible. Twilio et tous les logos associés sont des marques déposées de Twilio Inc. ou de ses affiliés. Salesforce est une marque déposée de Salesforce, Inc. Slack est une marque déposée et une marque de service de Slack Technologies, Inc., enregistrée aux États-Unis et dans d’autres pays.