Integrate Kisi with Microsoft Teams

info

This is a Kisi-built integration, maintained and supported by Kisi.

As an admin, you can easily integrate Kisi with Microsoft Teams to enable real-time Kisi event and custom incident policy notifications within your Microsoft Teams channels. This allows you to stay fully informed, without the hassle of switching between multiple apps or worrying about missing essential updates.

Prerequisites

• A Microsoft Teams account
• Kisi administrator access rights

info

Each Kisi organization can have only one Microsoft Teams integration. One integration can post to many Teams channels through Add Channel.

Configure the integration in Microsoft Teams

1. Sign in to Microsoft 365 and open the Teams app
2. Ensure that you have at least one Microsoft Teams channel to receive Kisi notifications
3. Hover over the channel's name and click on More options > Workflows
4. Under Notify a team, select Post to a channel when a webhook request is received
5. Enter a name for this workflow, e.g. "Kisi Notifications". Meanwhile, a small green checkmark should appear next to your account.
6. Click Next
7. Click Add Workflow
8. Under Workflow added successfully!, you now have the webhook URL. Copy it to the clipboard, as you will need it in the next step.
9. Click Done

Configure the integration in Kisi

1. Sign in to Kisi
2. Click the integrations icon (3x3 grid of dots) > Add Integration
3. Provide a name for your integration and select Microsoft Teams from the dropdown
4. Click on Add
5. Click on Add Channel
6. Under Configuration Name, provide a name, e.g. "Door unlocks"
7. Under Webhook URL, paste the webhook URL you copied from Microsoft Teams
8. Choose what the channel receives:
   • Kisi events - under Events, select specific Kisi events (e.g. lock.unlock), or select All to receive notifications for all events
   • Incident policy notifications - turn on Allow incident policies notifications and (optionally) select specific policies under Select Incident Policy. Leave it empty to post all incident policies.
9. (Optional) Under Select Place, choose one or more places to limit notifications to. Leave it empty to receive events from all places.
10. Click Save. Save stays disabled until both Configuration Name and Webhook URL are filled in.
11. After you click Save, a confirmation message appears in the Teams channel. To check event delivery, trigger an event or incident that matches the configuration's event or incident policy selection and any place filter.

Each notification is a Teams card that shows the Kisi event message and a Go to Kisi link. For incident notifications, the link opens the incident. For other events, it opens the event history filtered by place and actor.

info

• The integration only sends notifications from Kisi to Microsoft Teams. Replies or actions in Teams are not sent back to Kisi.
• Turning on Allow incident policies notifications replaces the event selection with incident creation and update events. To combine a specific Kisi event selection with incident policy notifications in the same Teams channel, add two channel configurations with the same webhook URL. Selecting All under Events already includes incident events alongside other Kisi events.
• If you filter a configuration by place, it only receives events directly related to that place (e.g. door unlocks) and incidents that happen at that place. It won't receive organization-scoped events (e.g. user or access link creation). To receive these, add a separate configuration without place filtering.

Manage channel configurations

Open your Microsoft Teams integration in Kisi to see all channel configurations.

• Add a configuration - click Add Channel and configure it as described in Configure the integration in Kisi
• Edit a configuration - click its row to open Edit Channel Configuration, update the name, places, events or incident policies, then click Save
• Delete configurations - select the rows with the checkboxes, click Delete and confirm in the Delete Channels dialog

The webhook URL can't be edited. To use a different Teams channel or workflow, delete the channel configuration and add a new one. Deleting a configuration in Kisi doesn't delete the workflow in Microsoft Teams, so remove the workflow in Teams if you no longer need it.

tip

You may receive the same notification more than once when:

• All is selected under Events, because incident events are included alongside the underlying events
• Incident policy notifications are turned on, because the channel receives both incident creation and incident updates, so one incident can produce more than one message

Channel statuses

The Status column shows the state of each channel configuration:

Status	Meaning
Ok	The configuration is set up and receives notifications
Incomplete	No events are selected
Error	Microsoft Teams rejected the webhook, so Kisi stopped posting to it. See Troubleshooting.

Troubleshooting

A channel configuration shows the Error status

If Microsoft Teams rejects or no longer recognizes the webhook, for example because the workflow was deleted, Kisi marks the configuration invalid and stops posting to it. The edit dialog shows "Webhook is invalid, please create a new configuration".

To fix it, create a new workflow in Teams as described in Configure the integration in Microsoft Teams, then add a new channel configuration with the new webhook URL and delete the old one.

Configuration error messages

When you save a new channel configuration, Kisi posts a confirmation message to the webhook. If that fails, the configuration isn't saved and one of these messages appears in a Configuration Error dialog:

Error	What to do
The webhook URL has been deleted or the connector configuration is not found.	Check that the workflow still exists in Teams. If it was deleted, create a new workflow and use its webhook URL.
The webhook URL is invalid.	Copy the URL again from the Teams workflow and paste it in full.
Microsoft Teams is currently unavailable. Please try again later.	Try again later.
Something went wrong. Please double-check your credentials and try again or contact support for assistance.	Check the webhook URL and try again. If it persists, contact our support team.

There can be only one Microsoft Teams installation per organization

Your organization already has a Microsoft Teams integration. Add more channel configurations to the existing one instead.

Remove the integration

1. Sign in to Kisi
2. Click the integrations icon (3x3 grid of dots) and select your Microsoft Teams integration
3. Click Delete and confirm

Removing the integration deletes all of its channel configurations in Kisi. The workflows in Microsoft Teams stay in place, so remove them in Teams if you no longer need them.