Skip to main content

Engage with your visitors through the power of Webhooks

By Richard Ellor
12 January 2018
4 min read
Engage with your visitors through the power of Webhooks
Interactive developer toolReal-Time Event Architecture

WiFi webhook vs API polling simulator

Model HTTP request reduction, latency improvements, and server overhead comparing real-time Purple webhook callbacks with traditional API polling across your venue estate.

12 sites
Airports, stadiums, malls, or offices
450/site
Total estate: 5,400 daily visitors
Frequency at which external servers query endpoints
REST polling calls
34,560
HTTP GET requests / 24h (40.5 MB payload overhead)
Purple webhook calls
7,560
HTTP POST callbacks / 24h (10.3 MB targeted payload)
API call reduction
78.1%
27,000 wasted HTTP calls eliminated
Event notification latency
~120 ms
vs 15.0s avg delay with REST polling

Why Webhooks Outperform API Polling for Connected Venues

In public guest WiFi environments, polling APIs continuously wastes 90%+ of network requests returning 304 Not Modified or empty delta arrays. Purple Webhooks reverse this model: event callbacks are dispatched instantaneously upon guest authentication, dwell triggers, or survey responses, allowing your CRM, marketing automation, or SIEM to act in under 150 milliseconds without polling strain.

Building custom WiFi integrations or CRM sync pipelines?

Purple offers REST APIs, real-time Logic Flow webhooks, and pre-built connectors for HubSpot, Salesforce, Microsoft Dynamics, and PowerBI. Connect with our engineering team for sandbox keys and developer documentation.

Security architecture
Useful? Link to this tool

In June last year we unveiled Logic Flow, a game-changing feature that allows marketing teams to offer personalised customer engagement, resulting in enhanced business efficiency, customer satisfaction and increased revenue. We are now very pleased to announce that we have enabled Webhooks in Logic Flow, which will take the possibilities of customer engagement to a whole new level.

What is a Webhook you might ask?

In essence a Webhook is a simple concept, but packs a big punch! In broad technical terms, a Webhook is an HTTP callback. When an event is triggered, the Webhook will push data to a specified URL (endpoint) in real-time. Sounds like an API? It works in a similar way, except APIs pull data at intervals, Webhooks push the data in real-time.

What data can be pushed through Webhooks in Purple?

In a nutshell, a lot! You will get your WiFi users'

  •  First name
  • Last name
  • Email address
  • Date of birth
  • Gender
  • Sign-up method
  • MAC address
  • Web browser
  • Authentication time and date
  • Venue information
  • And more

Webhooks in action

  • Push is the simplest of reasons to use Webhooks. No need to poll every couple of minutes to find out if there is new information - get new data in real-time as soon as the event is triggered. It's less work, less hassle, and you'll even receive it sooner than if you were requesting it every couple of minutes.
  • Offer your customers a superior service. Let's say you're a large capacity venue, hotel or high-end retailer and you need to be able to identify your VIPs when they arrive. Using Webhooks, you will be able to push your visitors' user data from Purple to your internal applications once they have connected to your WiFi. This will then act as a trigger to notify staff at the venue that specific guests or shoppers have arrived and enable them to offer a bespoke experience.
  • Getting visitors engaged with your brand is key. By having a live feed of your visitors' data being pushed to your other CRMs gives you a more complete profile on each customer. Combine the Purple-provided visitor data with the data you hold on each customer such as previous purchases and engage with your visitors in a truly personal way.

Easy as 1-2-3

It's very quick and simple to get your Webhooks live in Purple:

  1. At company or venue level, head over to the Management section on the left and hit Venues. Click the newly added Webhooks tab at the top of the Venues page. First you need to add and validate the destination URL (endpoint) you want the Webhook to push data to. Data is sent as a JSON object so you need to make sure your destination URL is capable of receiving the data. There is no limit on how many URLs you can validate.
  2. Once your URL is validated, go to Logic Flow and you will see there is now a Webhooks Action Node available. After you've added your Start Node, place the Webhook Node in your flow and select your validated URL, then finally close your flow with the End Node. Validate and save.
  3. Finally, you need to add your Logic Flow with the Webhook onto your Access Journey. Under the Onboarding tab on the left, click on Access Journeys. Once in your Access Journey, click the Logic Flows tab and click 'New logic flow'. Select the correct Logic Flow and you are all set. Now, every time a user connects to your WiFi, their data will be pushed via the newly created Webhook.

Already thinking about the number of ways that your business could make effective use of Webhooks? The feature is now live on the Purple Portal and ready for you to use. Not yet a Purple customer? No problem, sign up to a trial of our Enhanced licence today to see how Webhooks and Purple's analytics data could transform your marketing and customer engagement.

Frequently asked questions

What is the difference between a webhook and an API in guest WiFi systems?

A REST API uses a pull model where your application polls an endpoint at set intervals to check for updates, which consumes network bandwidth and introduces latency. In contrast, a webhook is an automated HTTP POST callback triggered immediately when an event occurs - such as a visitor authenticating on a splash page. Webhooks deliver real-time data payloads in under 150 milliseconds without continuous server requests.

Why are webhooks more efficient than API polling for venue analytics?

Continuous API polling wastes up to 99% of network requests returning unchanged data or empty arrays. In high-density venues like stadiums, shopping centres, or transit hubs with thousands of daily visitors, webhooks only transmit data when state changes happen (such as visitor entry, dwell threshold reached, or marketing opt-in), significantly reducing server CPU utilization and API rate limit pressure.

What data payload does Purple send when a guest connects to WiFi?

When a guest authenticates, Purple dispatches an event payload containing the event type (wifi.guest.authenticated), ISO-8601 timestamp, venue and access point identifiers, session IP and VLAN assignments, device manufacturer, and marketing consent attributes formatted in standard JSON.

How do you verify the security and authenticity of a Purple webhook?

Purple signs every webhook dispatch using HMAC-SHA256 with a unique shared secret key, passed in the X-Purple-Signature header. Receiving servers compute the signature across the raw request body and compare it with the header to verify payload integrity and origin authenticity. Replay attacks are mitigated using unix timestamp headers with a 300-second acceptance window.

Can Purple webhooks trigger automated workflows in external CRMs?

Yes. Purple Logic Flow webhooks connect directly to marketing automation platforms and CRMs including HubSpot, Salesforce, Microsoft Dynamics, and Klaviyo. You can trigger automated email sequences, loyalty points, or operational alerts as soon as a visitor logs onto the guest network.

What happens if our webhook receiver endpoint goes offline?

Purple includes automated retry logic with exponential backoff. If an endpoint returns an HTTP 5xx error or times out, Purple retries delivery multiple times over a 24-hour period to ensure event notifications are not dropped during service interruptions.

Ready to get started?

Book a demo with one of our experts to see how Purple can help you achieve your business goals.

Speak to an expert