Integrate Zoom with Kisi
This is a Kisi-built integration, maintained and supported by Kisi.
With the Kisi x Zoom Workspace integration, admins can seamlessly manage access to reserved rooms. When a reservation is made or canceled, access is automatically granted or revoked, ensuring that only authorized individuals can enter. The integration offers two convenient options:
-
Access links (Group links): Upon booking, users receive access links that allow them to unlock the room with a simple tap. These links remain valid for the duration of the meeting and can be shared with other participants.
-
Check-in (Unlock schedules): Doors unlock when at least one user checks in and automatically lock when they check out or when the booking ends, thereby enhancing security. To enable this feature, simply activate the check-in functionality.
Each Kisi organization can have only one Zoom integration, and each Zoom account can be connected to only one Kisi organization.
Set up the integration in Kisi
- Sign in to Kisi
- Click the integrations icon (3x3 grid of dots) > Add Integration
- Define the name of your new Zoom integration
- Open the Type dropdown and select Zoom
- Click Add
- Once redirected to Zoom, review the app permissions and click Allow
- Click Edit Configuration in the top right corner
- Select your desired configuration. New integrations start in Access Link mode:
- Access Link: When a reservation is made for a mapped workspace, a group link for the mapped Kisi group is emailed to the person it is reserved for
- Check-In: When someone checks in to a reservation for a mapped workspace, an unlock schedule is created for the doors of the mapped Kisi group
- Click Save
- Next, click on Import Zoom Workspace
- Under Select Zoom Workspace, choose your desired Zoom Workspace
- Under Select Group, choose the Kisi group you would like to map to this workspace
- Click Save
- Repeat the previous step as many times as necessary to create as many mappings as you wish
- Click Save and return
- To utilize the check-in functionality, the check-in option in the Zoom workspace settings must be enabled.
- For access links, only the person the workspace is reserved for receives the link. They are responsible for sharing it with other participants.
In Access Link mode, if no access link exists for a reservation when someone checks in (for example, for recurring bookings), the link is created and sent at check-in.
How it works
Access Link mode
- Reservation created: a group link is emailed to the person the workspace is reserved for. The link is valid from the reservation's start time to its end time
- Reservation updated: the old link is deleted, and a new link with the new times is created and sent
- Reservation deleted: the link is revoked
- Check-out: the link is revoked, even if the reservation hasn't ended yet
Check-In mode
- Reservation created, updated or deleted: nothing happens in Kisi
- Check-in: every door in the mapped Kisi group unlocks from the moment of check-in until the reservation ends. The unlock schedule is named after the reservation topic
- Check-out: the unlock schedule is deleted
While the integration is disabled, Zoom reservation events are ignored. No links or schedules are created or revoked, and events from that time are not replayed after you turn the integration back on.
Manage workspace mappings
Each Zoom workspace can be mapped once, and each Kisi group can be mapped to only one workspace. Workspaces and groups that are already mapped don't appear in the Import Zoom Workspace dialog.
To find a mapping, search the mappings table by workspace or group name.
To remove a mapping:
- In the mappings table, click Delete next to the mapping
- In the Remove Workspace dialog, confirm the removal
Kisi removes a mapping automatically when its Kisi group is deleted, or when its Zoom workspace or Zoom Room is deleted in Zoom. To keep access working, import the workspace again with a new group or workspace.
Troubleshooting
The Zoom authorization expired
If Kisi can no longer refresh the Zoom authorization (for example, because access was revoked in Zoom), the integration is disabled automatically. Organization admins receive an email with the reason "Refresh token expired".
To reconnect:
- Sign in to Kisi
- Open the Zoom integration. You are sent back to Zoom
- Review the app permissions and click Allow
- If the integration is still disabled, enable it again
Error messages
| Message | What to do |
|---|---|
| There can be only one Zoom installation per organization | Use the existing Zoom integration in your organization |
| Duplicate Zoom Installation: You can only install one zoom integration per organization | This Zoom account is already connected to another Kisi integration. Use that integration, or remove it first |
| Zoom Authorization failed: Please contact Kisi Support | Contact our support team |
| OAuth Configuration could not be created | Contact our support team |
Remove an integration
If an integration is no longer needed, as a Kisi admin you can either temporarily disable it or permanently delete it.
- Sign in to Kisi
- Navigate to Settings > Integrations
- Select the integration you wish to disable or delete from the list
- Depending on your preference, either click on Disable to temporarily disable the integration or Delete to permanently remove it
Removing the Kisi app from the Zoom App Marketplace permanently deletes the Zoom integration in Kisi, including all workspace mappings.