Before you begin the setup wizard, you will need:
- Your Brivo OnAir Administrator login.
- An account on the Brivo API Platform.
- An API key.
- The Brivo integration enabled in your account.
To start the wizard:
- Go to Tools > Account.
- Select Integrations from the left-hand menu.
- Select the Enabled Integrations tab.
- Click Manage Settings.
Click on each of the steps below to follow the Brivo integration setup wizard.
Step 1: Confirm you are Ready
This step is for you to confirm you have everything you need before you begin setting up the integration and to authorize WhosOnLocation to link to your Brivo account.
Tick each box to acknowledge and select Get Started.
Step 2: Link to Brivo
To link WhosOnLocation and Brivo, you will need to work in both accounts at the same time.
WhosOnLocation requires your Brivo Client ID and Client Secret which are generated by creating an Application in Brivo. The steps on creating these are below.
And an API Key can be obtained through request to Brivo.
- Login to Brivo OnAir- You can do this by selecting the blue Brivo OnAir hyperlink, or going to brivo.com, and entering your login details.
- Navigate to Setup > Account > Account Settings.
- Click on the Application Management tab.
- In the Create a New Application box fill in the new application with the Name and Description as "WhosOnLocation".
- Select the type of authentication for the application, 3-Legged is recommended and the rest of the setup steps refer to this type.
Mirror your chosen authentication method to the Brivo OAuth Settings box on the right side of this wizard.
- When using the 3-legged application type, you need to enter the Redirect URI in Brivo. Copy the URI provided in the WhosOnLocation steps to the New Application in Brivo. This is unique to your WhosOnLocation account.
- In Brivo, click Create Application to save.
The new application will be created and listed under Account Owned Applications.
- Once created, clicking the small blue Application Details icon will display the Client ID and Secret.
Copy these to the Brivo OAuth Settings box on the right side of this wizard.
- Assigned API Keys can be found in your Brivo developer portal, copy this to the Brivo OAuth Settings box on the right side of this wizard.
You can get to the Developer Portal by selecting the blue hyperlink, or going to brivo.com/apps/mykeys, and entering your login details.
Please Note: If you do not have a Brivo API Key, you will need to request this from Brivo.
- Click Continue to move to the next step.
Step 3: Authorize with Brivo
Now that you have linked your WhosOnLocation and Brivo accounts, you need to authorize WhosOnLocation to access the data from your Brivo account.
- Select Authorize Now.
You will be re-directed to log into your Brivo API.
- Login in to your API.
- Select Submit to authorize.
You will be taken back to WhosOnLocation and automatically to the next step.
Step 4: Syncing to Brivo
Your Brivo data will now be synced with WhosOnLocation, this may take a few minutes. WhosOnLocation will import your Sites, Doors, and Users into the Brivo integration so that you can match them with existing data in your WhosOnLocation account.
To separate your employees from service providers, create a group called Service Providers in Brivo and add any service providers to that group. You do not have to give that group access to any doors.
When complete, the spinning hourglass will become a tick and you can click Continue.
Step 5: Mapping Brivo Sites to WhosOnLocation
In order to ensure that your reporting is accurate, your site permissions are carried over, and your users are matched correctly, you will need to match your Brivo sites to your WhosOnLocation locations; this is called mapping.
You can map multiple Brivo sites to one location or leave some unmapped if you’re not using them with this integration.
To map your sites to locations, drag and drop your Brivo Site to the matching WhosOnLocation Location from left to right on your screen.
Once your sites are matched to your locations correctly, click Continue.
Step 6: Where are your Brivo Doors Located
The Doors you have set up in your Brivo account are matched to Location Access Control Points (LACPs) in your WhosOnLocation account. The LACP is used to identify Sign In/Out Kiosks and other areas that a person might sign into and out of a location.
You can match multiple doors to one LACP where required, e.g. one door in and one door out for the same LACP.
To match your doors to LACPs, simply select the corresponding LACP from the drop down list next to the door.
Once your doors are matched with your LACPs, click Continue.
Step 7: Sync Config
Set up how you want to configure your sync of people in Brivo and WhosOnLocation. The Master Database will determine which system is used to push information through to the other. If you have all your people set up in WhosOnLocation and want to import them into Brivo, choose WhosOnLocation as the Master Database or vice versa.
WhosOnLocation Master Database
When WhosOnLocation is selected you have three options for syncing; All, Selected, or Off.
All – All employees from all locations matched with Brivo sites will be synced.
Selected – Choose the locations you want to sync employees with Brivo from.
Off – No employees will be synced. Choose this option if you are only syncing service providers or not ready to sync employees.
Sync Service Providers
All – Sync all service providers in your account with Brivo.
Selected – Service providers with the Brivo Sync role type assigned will be synced with Brivo. This will be automatically generated in the system and can be applied after you complete the wizard.
Off – No service providers will be synced. Choose this option if you are only syncing employees or not ready to sync service providers.
Brivo Master Database
When Brivo is selected as the master database you have two options for syncing; Selected and Off.
Selected – Choose the groups in Brivo that you want to sync and select the location new employees should be added to by default. Their default location can be overridden using rules later.
Off – No employees will be synced.
Sync Service Providers
Service Providers in Brivo need to be added to a group called Service Providers before syncing. This will allow WhosOnLocation to identify them as service providers and import/match them to service provider profiles.
Selected – Choose the groups in Brivo, including the Service Provider group, that you want to sync. The location permissions are added by the organization in WhosOnLocation.
Off – No service providers will be synced.
Step 8: Match Users between WhosOnLocation and Brivo
Your Brivo Users are now being automatically matched with employees and/or service providers in your WhosOnLocation account.
Users are matched based on their name and any users that are not matched can always be matched manually or automatically later.
If your employees and/or service providers have not been set up in the non-master database, they will not be matched. These, and any new, employees and/or service providers will be imported to the non-master database through scheduled syncs once set up. Click here for more information on setting this up.
It may take a few minutes to match all users depending on how many records there are. When complete, the spinning hourglass will become a tick and you can click Continue.
Step 9: Finished
Your Brivo integration setup is now complete. Click Finish to confirm this.
You will be taken to the Brivo integration settings page where you can configure the sync settings, adjust the matching of sites, doors, and users, and set up sync rules.