SECURESPACE: Brivo Integration Guide

Brivo Device Compatibility

• Please note that this integration is only applicable with Brivo Doors with nodes and not readerless doors. For any questions regarding this, please contact Brivo Support at technicalsupport@brivo.com.

Prerequisites

1. Confirm that your organization has SECURESPACE added to your subscription (a sub-module of FACILITeSPACE). This module allows events that are fully approved in Event Scheduler to schedule your Brivo doors, therefore Event Scheduler is also required on your eSPACE subscription in order for this integration to work. An admin with billing permissions in eSPACE can confirm or add both of these modules if needed under Settings > Other > Billing > Manage. 
   • A. When you add SECURESPACE to your subscription, there is a 1-time setup fee and an on going subscription charge. 
   • B. To see our latest pricing, please visit the pricing page on our website: https://www.smartchurchsolutions.com/software/pricing/
   • C. It is your responsibility to confirm and agree to any additional pricing that Brivo may include for their role in this integration.  
2. Once SECURESPACE is added to your eSPACE subscription, email us at support@smartchurchsolutions.com so we can initiate the integration. Only after this is complete will you see the specific door option on your FACILITeSPACE account under Access control in the left side menu (assuming the admin on your organization’s eSPACE account has granted you access to see FACILITeSPACE).                                                                                               
3. Once you have access to FACILITeSPACE - SECURESPACE for your specific door company, you may grant other eSPACE users access to FACILITeSPACE  -SECURESPACE.  To do this click Settings > Users in the FACILITeSPACE on the left navigation menu.  Then under each person’s profile within the FACILITeSPACE Permissions you can enable access to SECURESPACE for them and click save. 

Contacting Brivo For Integration Information & Activating your Account

1. In order to get the information that is needed to actually link eSPACE/FACILITeSPACE/SECURESPACE to your Brivo doors, you will need to obtain information from Brivo to enter into your FACILITeSPACE account. To assist with this request, you may elect to copy and paste the following into an email to your Brivo contact: 

1. 1. 1. “Hello (Brivo Salesperson), We are a Smart Church Solutions/eSPACE customer and we want to integrate our Brivo doors with our eSPACE account. We need a quote for the Brivo API and the form that we need to fill out (as provided by Brivo) so we can send it to BrivoAPI@brivo.com. Then we need to have the Brivo API activated on our Brivo account. Can you please help me with this? Thank you!”

2. Once Brivo activates the API on your account, they will send you an email with the API Key. This key is the first part of the information that you will need to copy and paste into the Credential Setup under your FACILITeSPACE/Access Control/Brivo Doors Setup.

3. For the client ID and secrete you will need to create an application within your Brivo account.

• A. Click on "Generate API Token".

• B. You will need to provide a name and description for the application. 
  

• C. Set the authorization grant type. 
  

  *If you are using 3-Legged, you will need to provide a redirect URI. 

• D. Then save the application. 
• E. Under Enabled you will see your new application listed.
• F. Click on the application to view the client ID and secret.
  *If you do not see this Integrations page you will need to have the API activated on your account. 
• If you need help with the API key, client secret, and/or client ID please reach out to brivoapi@brivo.com for assistance.

Setting Global Unlocking & Relocking Buffers

After typing in the credentials for your FACILITeSPACE account to link to your Brivo door account, you can set a global “Buffers” that will apply to all doors. This "Buffer" will send the "unlock" and "Return to Internal Brivo Scheduler" commands X min before the start time and x min after the end time. 

Importing Doors from Brivo into FACILITeSPACE

You are now ready to click “Start Discovery Process”, which will import all of the doors on your Brivo account into FACILITeSPACE. 

Assigning Doors to Spaces

Assign the correct spaces in eSPACE to the correct doors in Brivo in FACILITeSPACE. This will allow eSPACE to automatically schedule doors based on the spaces that are reserved on events.

Setting Individual Door Buffers

Once the doors are synced in, you can assign an individual buffer per door. Once a door has an individual buffer, it will ignore the global buffer set at the top of the FACILITeSPACE Access Control/Brivo page. When setting an individual buffer you can decide for the door to "Unlock" x min before the start time of the event and either  A. "Return to internal Brivo Schedule" x min after the end time or B. "Return to internal Brivo Schedule" x min after the start time of the event.

A.

  B.

Assigning Doors to a Location

In order for the right doors to appear on the Items > Doors Tab in Event Scheduler they must be assigned to a location in your account under Settings > Basic > Locations.

• A. To assign them to a location, click the edit icon for that location.
• B. Then click inside the "Door" field to start selecting doors. If your eSPACE account has one location then you can assign all the doors to that location.   

• C. After selecting all the right doors for that location, click Save at the bottom right side. 

How Doors Are Automatically Scheduled By Events

Once doors are assigned to their location if 1. that same location is chosen on the Details tab of an event and 2. a space is chosen on the Items > Space tab, then 3. based on how you assigned spaces to doors in FACILITeSPACE, doors will automatically be selected on the Items > Doors tab.

             1. Details Tab

             2. 

            3.   

Door API Calls

 This integration checks every 2 minutes to see if there is a new schedule to “push to the doors”. It is a “live push”, so it is not limited to a certain amount of event schedules into the Brivo doors.

Schedule Logs for Doors in eSPACE

In order to see the door logs in eSPACE to confirm that eSPACE tried to send the “unlock” and “relock” commands go to FACILITeSPACE>Access Control > Brivo Door Setup and click the plus symbol to the left of any door (you may sort the logs by time by clicking in the empty space of the “Created On” column).

Overriding Doors on Events

If you want to manually choose doors and/or manually choose the time that they unlock and relock on an individual event, you can place an override on the main Detail tab of the event or go to the Items > Door tab to do so. 

• Door overrides for events are considered event specific so they will not copy over if you copy the event. For security purposes, the doors on copied events should either be automatically selected based on the spaces chosen or a new override should be created on the main Details tab or the Items > Door tab. 

• You can also set overrides for doors on events on the FACILITeSPACE dashboard. From the dashboard, select "Edit Door Access" to either turn OFF door access or set an override.

• If you need to override the doors for a specific occurrence on the event, go to the Occurrence tab on an event, expand the one that you need to edit, then click "Edit Services" and switch to the doors tab and add the door override that you need. Finally, click "Back to Occurrecnes" and submit the event for approval. 

NOTE: Door access cannot be controlled for events that cross a 24-hour period in eSPACE (where the start date/end date and/or setup date/end date on the Details tab are different dates).

Preventing Doors from Being Scheduled by an Event

• On the main Details tab of an event, you can also "Turn Off Door Access for this Event" and thus NOT have eSPACE unlock and relock the doors for that event.

Immediate Override for Emergencies

In the event there is an organizational emergency and you need to lock one, all or some doors, you can go to the FACILITeSPACE > Access Control > Brivo Door Setup and either click "Override" on individual doors or "Override All" and then choose a status and duration of the override.

Location

Whether you have one or more locations, because locations are the foundation of every eSPACE account, doors must be assigned to their proper location under Settings > Basic > Locations in Event Scheduler in order for this integration to work properly.