Integrating Kisi
  • 01 Sep 2022
  • 3 Minutes to read
  • Comment

Integrating Kisi

  • Comment

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, Passes, Desks & Offices 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, passes, desks and offices 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.

Access groups can only be created and edited in Kisi.

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.

Treat your API token as you would any password.

Save it somewhere safe and don't share it with anyone.

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. If the navigation menu isn't visible, click the menu icon in the top left corner of the page.

  2. Enable the Kisi integration toggle.

  3. Add your Kisi API token.

  4. Select a No access policy.

Suspend Kisi user account
Users are automatically suspended if they don't have connected passes, bookings or contracts with connected desks and offices in their account.
Delete Kisi user account
Users are automatically deleted if they don't have connected passes, bookings or contracts with connected desks and offices in their account.

  1. 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.

Kisi_Resources.png

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.

Kisi_Passes.png

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.


Was this article helpful?