Our integration with Kisi 2.0 provides a way for your parents/guardians and employees to unlock your Kisi door locks via their Kangarootime apps. This article contains all of the information you will need to set up and maintain your integration.
Kisi Place – A Place in Kisi is equivalent to a Center in Kangarootime
Kisi Place ID – The ID number that Kangarootime uses to connect Centers to Places
Kisi Group – A group of people with a shared set of permissions
Kisi Group ID – The ID number that Kangarootime uses to add the correct parents and staff to Groups
Step One: Setup
To start setting up your integration, open Kangarootime in your web browser and navigate to Settings > Integrations, then select the Kisi tab. This page will be the hub within Kangarootime for the integration.
In another tab, open Kisi. In Kisi, you’ll need to have someone with either Organizational Owner or Administrator permissions (you can check this under “Users”) to go to My Account > API > Add an API Key.
Once the API key is created, make sure that you copy it as you won’t be able to access the key again.
Then, head back to your Kangarootime tab and paste the API key into the Kisi API Key textbox and click Save.
Step Two: Places
In order for Kisi and Kangarootime to understand which locks are located at which Center, you need to associate your Kisi Places with your Centers in Kangarootime. In Kisi, head to Places and then select a place. You should see your Place Dashboard with information about all of your doors that are associated with this place.
In Kangarootime, you will see a table that contains the Place Names and Place IDs from Kisi. Make sure that you refresh the page if you have updated Kisi since you opened the page in Kangarootime.
In the table, for each Place entry, select the Center you want that Place associated with. Once the Centers are selected, the link is formed between the two systems.
Step Three: Groups Setup
Now that your locks are mapped to their respective centers, we need to tell the locks who can open them. First, you will need to configure your Groups in Kisi. Groups control who has access to which locks.
There are many ways you can choose to configure your groups. For example:
1. The top tier as a global Group – you would add permissions to this to unlock any lock and any center any time. This would be for your highest level employees/owners.
2. The medium tier would have one Group for each district for your district level staff.
3. The bottom tier would have two Groups for each Center – one for parents, and one for staff.
Regardless of how you choose, in order for the connection with Kangarootime to work correctly, you will need to make sure you have a Group created for each Center specifically for parents, and another Group for each Center specifically for Staff.
In order to set up your groups in Kisi, navigate to Groups and select Add Group. On the configuration page, you do not need to enter users at this time as the connection will be set up through Kangarootime.
Step Four: Parent Groups
We are going to start by connecting our parent groups to our Centers. In Kisi, navigate to Groups and then select your parent group for your first center. Click on the Copy ID button.
Paste it into the “Kisi Group ID” column in Kangarootime. Continue this for all the parent groups for each of your Centers.
Step Five: Employee Groups
Now that your parents have access, you’ll need to extend this to your employees as well. This is done on an employee-by-employee basis. Just like you did for your parent group, head into Kisi and copy the ID for your employee group for your first Center. Then, in Kangarootime, navigate to the profile of your employee in question. Head to the Kisi tab and paste the Group ID there.
For employees who need to be a part of multiple groups, paste the Group ID of the employee group for their home Center here. Once that ID has been added, the employee will be automatically as a user in Kisi and can be added to other groups manually to be given additional access.
You did it! You can test the locks right in Kangarootime from the Kisi configuration page. You can also continue to manage your groups in Kisi. Parents’ access will be automatically updated as contracts begin and change. Employees are more manual, so make sure to add the correct Group ID to their profiles as they are created in Kangarootime.