How to set up BlueFox with Signagelive

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:

1. Choose a Trigger App from the drop-down menu.
2. Select ‘Webhooks by Zapier’ underneath ‘Built-In Apps’
3. 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:

1. Press the + button to begin configuring a new Untitled Postman request
2. Select POST from the drop-down
3. Enter the request URL (provided by Zapier) - as per the previous steps in Setting up your Trigger)
4. 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"
}

1. Hit Send
2. Now return to Zapier, and select ‘OK, I did this’.
3. 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.

1. 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"
}

1. Hit ‘Send’ again.
2. Return to Zapier and choose ‘Get more samples’.
3. Another option should appear for ‘Hook B’
4. 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:

1. Select ‘Add a step’ from below the Trigger.
2. Select Path to create Paths A and B
3. 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)
4. Select Continue to move forward to a ‘Rules’ selector.
5. Set the rule to ‘Location Occupancy Load’ - ‘(Text) Exactly matches’ - and type in HIGH
6. Select ‘Test & Continue’.

Next you will need to set up the Action for your path:

1. Select Webhooks
2. Select Custom Request
3. Select Continue

Set up your Webhooks by Zapier Custom Request

1. Select POST for the HTTP Method
2. Enter the URL (this will be provided by Signagelive upon request. Please contact our Support Team)
3. Leave ‘Data Pass-Through’ empty.
4. Within the Data section, enter the Web triggers request body  (this will be provided by Signagelive upon request. Please contact our Support Team)
5. Leave ‘Unflatten’ as the ‘yes’ default
6. Leave Basic Auth empty as default.
7. Enter Headers;
1. X-SIGNAGELIVE-WBI-APP-ID - This ID will be provided by SL
2. X-SIGNAGELIVE-WBI-APP-KEY- This KEY will be provided by SL
3. 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.

1. Continue to ‘Set Up Next Path’
2. Rename your path to LOW.
3. Set the rule to ‘Location Occupancy Load’ - ‘(Text) Exactly matches’ - and type in LOW
4. Select Test & Continue

Next you will need to set up the Action for your path

1. Select Webhooks.
2. Select ‘Custom Request’ and ‘Continue’.
3. Select POST for the HTTP Method.
4. Enter the URL (this will be provided by Signagelive upon request. Please contact our Support Team).
5. Leave ‘Data Pass-Through’ blank.
6. Within the Data section, enter the Web triggers request body (this will be provided by Signagelive upon request. Please contact our Support Team).
7. Leave ‘Unflatten’ as the ‘yes’ default
8. Leave Basic Auth empty as default.
9. Enter Headers (you’ll need to click the + to add new ones);
1. X-SIGNAGELIVE-WBI-APP-ID - This ID will be provided by SL
2. X-SIGNAGELIVE-WBI-APP-KEY- This KEY will be provided by SL
3. Content-Type - application/json 

Select ‘Continue and Finish’

That’s it! You can turn it on and give it a test.  

How can I find out more?

You can always search for answers with the Signagelive Help Centre, but rest assured we have a dedicated Support Team that are ready to assist you with any questions you may have. We are always here to help as best we can, so just contact us for any help you require.