What are webhooks?
Webhooks are a system of automated notifications indicating that an event has occurred in your Proxyclick account. Rather than requiring you to pull information via our API, webhooks push information to other systems when one or more of the following events happen on Proxyclick:
- Visitor check-in
- Visitor check-out
- Visit created
- Visit updated
- Visit deleted
Information is delivered via HTTP POST to a so-called destination URL on the receiving system. The receiving system can then parse the information (JSON file) and use it for its own application.
What are typical use cases?
Examples of use cases for webhooks include:
- Posting visitor info to a digital signage system so that visitors of the day are displayed on a large screen
- Sending visitor mobile number at check-in so that your Wi-Fi system texts the visitor a unique Wi-Fi code
- Send the visit info (date, time, visitor contact details) to a parking booking system in order to book a slot when preregistering the visitor
- Send pictures of visitors taken on iPad to your internal system (eg CRM) to enrich your customers profile
How to configure webhooks?
To configure a webhook, you’ll need to
- Set up a destination URL in the receiving system (in the examples above, the receiving systems are the Wi-Fi, parking booking, or digital signage systems). You can also easily test Proxyclick webhooks with dummy URLs (see section “How to quickly test webhooks?”)
- Go to Proxyclick dashboard > Account and Settings > Integrations > Webhooks > “Enable webhooks”
- Name your webhook, provide the destination URL and select at least one of the trigger events
What information is sent?
Information sent depends on the triggering event:
- When event is “Visitor check-in” and/or “visitor check-out”, the following info is sent
- When event is “Visit created” and/or “Visit updated” and/or “Visit deleted”, the following info is sent
We support HTTP and HTTPS destination URLs, and we recommend you provide a HTTPS URL to protect notifications.
If your destination URL needs basic authentication, you can enter the username and password in Proxyclick.
How to quickly test webhooks
If you would like to quickly test how webhooks work without having to create your own destination URL, you can use a dummy webhook URL.
- Go to http://requestb.in/ and create a Request Bin
- Copy/paste the URL into Proxyclick webhook configuration page. Name the webhook and select the trigger event(s)
- Perform the trigger event (e.g. a visitor check-in) and reload the requestb.in page to see the info pushed by Proxyclick