The following steps will help you set up OfficeRnD and Kisi integration.
1. Go to the ‘Settings’ tab, click on ‘Integrations’ (left-hand side of the panel) and look for ‘KISI’.
2. Make sure your Kisi account is activated and then click ‘Configure.' If you're configuring your OfficeRnD <> Kisi integration for the first time you will need to input a token that is provided by Kisi.
3. The best way to obtain the API token is by checking KISI's guide on the subject. They have a help article about their integration with OfficeRnD, which you can find here.
4. After you click 'Authenticate' the following window will pop up.
5. This window presents you with five tabs each one allowing you to map different OfficeRnD entities to Groups in Kisi. Each different entity mapping serves a certain purpose.
- The first tab allows you to map a Plan (you can manage plans by going to Billing -> Plans) in OfficeRnD to a security group in Kisi. Once you create such mapping you are basically telling OfficeRnD: "Every time someone is assigned a membership with this plan give him access to the following security groups". Access will be automatically granted or revoked depending on when a membership starts or ends. Plan mappings are most often used with the so-called "Hot desk" plans to grant members access to a common area where those desks reside, however, smaller spaces use them to map "Dedicated desk" plans as well.
- The second tab lets you map locations (you can manage locations by going to Space -> Locations) to Kisi groups. Locations mappings work a lot like floors mappings. Whenever you assign a membership to a desk in a mapped location the member will get access to the security groups mapped.
Example: On the screenshot below Floor 1 in London is mapped to "First floor access group". This means that if we go and assign a membership belonging to Joe to a desk on "Floor 1" in "London" we will grant Joe access to "First floor access group" in Kisi.
Note: If the membership does not have member assigned, access will be granted for the whole team.
- The third tab allows you to map floors (you can manage floors by going to Space -> Locations) to security groups. Mappings here works like this: assigning a membership to a desk on a certain floor will grant access to all mapped groups. To make things more clear here is an example.Example: On the screenshot below London is mapped to "General building access group". This means that if we go and assign a membership belonging to Joe to a desk on any floor in "London" we will grant Joe access to "General building access group" in Kisi.Note: If the membership does not have member assigned, access will be granted to the whole team.
- The fourth tab allows you to map Meeting rooms (you can manage meeting rooms by going to Space -> Meeting Rooms) to Kisi groups. Settings here take effect whenever someone creates a booking for a mapped meeting room.
Example: John books a meeting room through OfficeRnD Members portal or an admin creates a booking on behalf of John through the Admin portal (by going to "Calendar" view and clicking on an empty slot) for the "Elephant" meeting room. When the time of the booking approaches John is granted access to the security groups mapped to that room. When the booking is over the access for John is revoked.
- The fifth tab allows you to indicate what access users with day passes will get (you can configure day passes by going to Billing -> Plans -> Add plan -> Advanced). Every member or team that have day passes will get access to the security groups mapped in this tab. The access is revoked once all day passes are used up or when their validity ends.
- The seventh tab displays a guide on how you can set up the KISI integration's automatic checkins feature. Here are the steps that you need to take in order to automatically check in members when they access your space:
- Add integration
- Go to your Kisi account, Select a Place, then Integrations/Add Integration. Write a name for the integration, e.g. 'OfficeRnD automatic checkins'.
- Select type
- In the type field select 'Export events over HTTPs'.
- Enter URL
- In the Url field enter 'https://app.officernd.com/api/v1/hooks/Kisi/icowork/events/1'.
- Voilà! Now you are all set up. Next time someone unlocks a door in your space he/she will be checked in.
6. After clicking ‘Done’ you are all set up to start using OfficeRnD and Kisi together. All the different configuration options above give you great control over who has access to where. This means you don’t have to worry about adding or removing people manually from a Kisi group anymore, OfficeRnD will do that for you!
Providing access to members that are not present in OfficeRnD
Sometimes you want to provide access to members that are not in your OfficeRnD organisation. That would probably be cleaners, important guests and so on. If you add those people to some of the groups managed by OfficeRnD they will get removed right away (as described above). That's why we recommend creating a new group (without a prefix) that grants the appropriate permissions and adding the member there. As this group will not be included in the configuration of the integration in OfficeRnD (Settings/Integrations/Kisi) access for this member won't be revoked.