Requirements before you begin:
A supported Signagelive player that is activated against a valid licence
BlueFox - a Real-Time Mobile Phone sensing solution, capable of measuring foot traffic and triggering actions without the use of Apps or Beacons
Zapier - a web-based service that enables you to connect various Apps in order to automate your workflow and boost efficiency.
An application that allows the testing of APIs, we recommend Postman
You will also need to contact our Support Team to request certain details for the Web Triggers API to work.
Together, BlueFox and Zapier can be used to trigger dynamic changes to the content on your Signagelive screens! This article provides a step by step guide to help you integrate this solution, so that when footfall around your BlueFox sensing is deemed LOW or HIGH, then your screens will be triggered to display content accordingly.
Setting up your trigger in Zapier
To begin with you will need to log in to your Zapier account, and then you will need to ‘Make a Zap’ by clicking the relevant button. You can then follow the below steps:
Setting up your Trigger
When it comes to ‘Setting up this step’ you’ll need to:
Choose a Trigger App from the drop-down menu.
Select ‘Webhooks by Zapier’ underneath ‘Built-In Apps’
Once selected, click the Catch Hook option and continue.
You will now be given a URL to send a request to so Zapier can pull it in as a sample to set up the zap. We recommend you do this using Postman (you can download the app for this here).
Once in Postman:
Press the + button to begin configuring a new Untitled Postman request
Select POST from the drop-down
Enter the request URL (provided by Zapier) - as per the previous steps in Setting up your Trigger)
In the sub-menus underneath your URL, select ‘Body’,and then choose the ‘raw’ option and then enter the following:
{
"notification_type": "LOCATION_OCCUPANCY_LOAD_NOTIFICATION",
"location_uuid": "SAMPLE UUID",
"location_occupancy_threshold": 16,
"location_occupancy_load":"LOW"
}Hit Send
Now return to Zapier, and select ‘OK, I did this’.
It will show you that ‘Hook A’ has been pulled in.
This has set up your Web Hook for ‘Low’. Now you need to do this for your ‘HIgh’ web hook.
Return to Postman, and amend the Body of the request to:
{
"notification_type": "LOCATION_OCCUPANCY_LOAD_NOTIFICATION",
"location_uuid": "SAMPLE UUID",
"location_occupancy_threshold": 16,
"location_occupancy_load":"HIGH"
}Hit ‘Send’ again.
Return to Zapier and choose ‘Get more samples’.
Another option should appear for ‘Hook B’
Select ‘Continue’
Congratulations, you have set up your trigger, now you need to set up your Paths.
Setting up your Paths
First add a Step:
Select ‘Add a step’ from below the Trigger.
Select Path to create Paths A and B
Select Path A, and rename it to ‘HIGH’ (this will be your Path for when their are ‘High’ amounts of people in proximity to your BlueFox device)
Select Continue to move forward to a ‘Rules’ selector.
Set the rule to ‘Location Occupancy Load’ - ‘(Text) Exactly matches’ - and type in HIGH
Select ‘Test & Continue’.
Next you will need to set up the Action for your path:
Select Webhooks
Select Custom Request
Select Continue
Set up your Webhooks by Zapier Custom Request
Select POST for the HTTP Method
Enter the URL (this will be provided by Signagelive upon request. Please contact our Support Team)
Leave ‘Data Pass-Through’ empty.
Within the Data section, enter the Web triggers request body (this will be provided by Signagelive upon request. Please contact our Support Team)
Leave ‘Unflatten’ as the ‘yes’ default
Leave Basic Auth empty as default.
Enter Headers;
X-SIGNAGELIVE-WBI-APP-ID - This ID will be provided by SL
X-SIGNAGELIVE-WBI-APP-KEY- This KEY will be provided by SL
Content-Type - application/json
When you select Continue you will have completed the Web hook for HIGH. So if there is a High footfall detected by your BlueFox then your High content will display. You now need to repeat the steps again to create a LOW path.
Continue to ‘Set Up Next Path’
Rename your path to LOW.
Set the rule to ‘Location Occupancy Load’ - ‘(Text) Exactly matches’ - and type in LOW
Select Test & Continue
Next you will need to set up the Action for your path
Select Webhooks.
Select ‘Custom Request’ and ‘Continue’.
Select POST for the HTTP Method.
Enter the URL (this will be provided by Signagelive upon request. Please contact our Support Team).
Leave ‘Data Pass-Through’ blank.
Within the Data section, enter the Web triggers request body (this will be provided by Signagelive upon request. Please contact our Support Team).
Leave ‘Unflatten’ as the ‘yes’ default
Leave Basic Auth empty as default.
Enter Headers (you’ll need to click the + to add new ones);
X-SIGNAGELIVE-WBI-APP-ID - This ID will be provided by SL
X-SIGNAGELIVE-WBI-APP-KEY- This KEY will be provided by SL
Content-Type - application/json
Select ‘Continue and Finish’
That’s it! You can turn it on and give it a test.