Integrating Kisi

What You Need to Integrate Kisi

You need to make sure some requirements are met before you can integrate Kisi with Nexudus.

A Kisi Account

If you don't have a Kisi account yet, we encourage you to get in touch with the Kisi team who will help you create your account and install the system in your space.

Resources and Passes in Nexudus

You need inventory items set up in your Nexudus account to use the Kisi integration. You can choose to connect all your resources and passes to Kisi or only some of them.

Access Groups in Kisi

You need to set up access groups in your Kisi account. These groups will then be linked to passes and resources in Nexudus.

Consider the following points before creating access groups in Kisi:

• How many access groups you need to create

We recommend you create one access group per pass and per resource you have in your Nexudus inventory.

For example, if you have 4 passes and 8 resources in your inventory, you need to create 12 access groups in Kisi.

• Which doors customers need to access

When creating an access group, think about all the doors your customers will need to unlock in order to access a specific resource or area of your building.

For example, customers booking a resource need access to the resource door as well as any other door they need to unlock to get to the resource, such as the main entrance door or a floor door.

Once you've figured out how many Kisi groups you need and which doors each of them should include, check out Kisi's article on how to set up an access group. You only need to create access groups in Kisi. Nexudus will automatically add users to the Kisi groups when they purchase passes or book resources.

A Kisi API Token

You need to create an API token in Kisi to allow Nexudus and Kisi to communicate and grant your customers access.

1. Go to web.kisi.io/users/sign_in.

2. Sign in to your Kisi account.

3. Click on your name in the top right corner of the page.

4. Select API in the drop-down menu.

5. Click Add API Key.

6. Name API key Nexudus or Nexudus Access.

7. Enter your Kisi password in the Password field.

8. Click Add.

9. Copy the API token displayed on the screen and save it somewhere.

You'll need to add this API token in Nexudus during Step 1 of the integration process.

Integrating Kisi

Integrating Kisi is an easy two-step process.

Step 1. Enabling Kisi

Once you've set up your Kisi access groups, you can link them to your Nexudus passes and resources to finalize the integration.

1. Log in to dashboard.nexudus.com if you aren't already.

2. Click Settings > Integrations > Kisi. 

3. Enable the Kisi integration toggle.

4. Add your Kisi API token.

5. Select a No access policy.

6. Click the Save Changes button.

Step 2. Linking Kisi Access Groups to Your Nexudus Inventory

After clicking on Save Changes, the Resources and Passes sections will appear below the initial form to let you link Kisi access groups to your resources and passes.

Resources

Select the Kisi access group that corresponds to each resource. You can leave the field empty if you don't want to connect a resource to Kisi.

Customers are automatically added to the relevant Kisi access group 15 minutes before the start of their bookings. They are also automatically removed from the relevant Kisi access groups 15 minutes after their booking ends.

Passes

Select the Kisi access group that corresponds to each pass. You can leave the field empty if you don't want to connect a pass to Kisi.

Customers are automatically added to the relevant Kisi access groups as long as they have valid time or day passes connected to Kisi access groups in their account. They are removed from the relevant Kisi access groups shortly after they run out of valid passes.

All set! Kisi is now integrated with Nexudus and your customers should be able to unlock doors through Kisi based on their bookings and the passes they hold.