Integrate Kisi with Eagle Eye Networks

By integrating Kisi with Eagle Eye Networks security cameras, you can map your facility doors to cameras and retrieve footage as Kisi events (e.g., an unlock) occur.

info

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

Prerequisites

• Eagle Eye Networks end-user (customer) account that owns the cameras
• Kisi administrator access rights
• At least one camera set up in the location

tip

For a comprehensive list of all camera types supported by Eagle Eye Networks, refer to this catalog on the Eagle Eye Networks website.

note

Cameras can't be imported from an Eagle Eye Networks reseller account. If you sign in with a reseller account, select the end-user (customer) account that owns the cameras from the account dropdown.

Each Kisi organization can have only one Eagle Eye Networks integration.

Set up the integration

1. Sign in to Kisi
2. Click the integrations icon (3x3 grid of dots) > Add Integration
3. Enter a name for your application and select Eagle Eye from the dropdown
4. Click on Add
5. You'll be redirected to the Kisi marketplace and then to Eagle Eye Networks
6. Sign in to Eagle Eye Networks and approve access. You'll then return to the Eagle Eye Networks integration page
7. Select your Eagle Eye Networks account from the dropdown and click Add Camera
8. From the Search Cameras dropdown, pick the camera that you want to assign to a door
9. In the Select Place dropdown, choose the place where your door is located
10. From the Search Doors dropdown, select the door you wish to associate with the camera
11. Click Save. You'll return to the camera list
12. Click Save and return to go back to Kisi

info

In Kisi, you can only connect at most one door to a camera, but doors might have multiple cameras associated.

Supported events for video clips

Once the integration is set up, camera footage will appear in the Event History, marked with a camera icon. The integration attaches video clips, not still images, on the following Kisi events:

• Door unlocked (lock.unlock)
• Door unlock failed (lock.unlock)
• Door opened (lock.opened)
• Door held open (lock.held_open)
• Door forced open (lock.forced_open)
• Tailgating incident (incident.create)

Each clip covers about 20 seconds around the event: roughly 10 seconds before and 10 seconds after. Footage usually appears in Event History a few minutes after the event, as Kisi waits for Eagle Eye Networks to finish the recording before fetching the clip.

info

Clips appear only if the camera was recording in Eagle Eye Networks at the time of the event. Otherwise, no footage is attached to the event.

The default recording setting in Eagle Eye ('Record When') is event-based, triggered by the motion sensor. For proper integration, position the camera to monitor the door and adjust motion settings accordingly. Alternatively, setting recording to 'always' may require more cloud storage and strain the bridge, potentially filling the hard drive faster.

Manage cameras

Open your Eagle Eye Networks integration in Kisi to see all configured cameras.

• Add a camera - click Add Camera and configure it as described in Set up the integration
• Edit a camera - click its row to change the place and door. The camera itself can't be changed; to use a different camera, delete this one and add a new one
• Sync Name - updates the camera name in Kisi from Eagle Eye Networks. The name is otherwise copied only when the camera is added and doesn't update on its own
• Delete Camera - removes the camera mapping and the camera in Kisi

Deassign cameras

1. Sign in to Kisi
2. Navigate to the place where you have your camera assigned
3. On the dashboard, click on Hardware
4. Select the Cameras tab
5. Click on the camera that you wish to deassign
6. Click on Delete Camera in the top right corner
7. If you are planning to reassign this camera, click on Copy Token to save the device token
8. Click Delete

After deletion, you will receive an email notification confirming that the corresponding camera has been deassigned.

Deleting a camera from Hardware > Cameras also removes its mapping in the integration.

Troubleshooting

The integration was disabled

If Eagle Eye Networks access expires or is revoked, Kisi disables the integration and emails the organization admins with the reason "Refresh token expired". Open the integration in Kisi and sign in to Eagle Eye Networks again.

A camera was disabled

If the Eagle Eye Networks account linked to a camera can no longer be reached, Kisi disables that camera automatically. Sign in to Eagle Eye Networks again with access to that account, or delete the camera and add it again from an account you can access.

No cameras to select

If the selected account has no cameras left to add, the app shows "All Eagle Eye cameras are configured or add a new camera on your Eagle Eye account to continue. Please note that you cannot import cameras from Eagle Eye reseller accounts." Add a camera in Eagle Eye Networks, or switch to the end-user (customer) account that owns the cameras.

Error messages

Error	What to do
"This camera is already configured with the selected place and lock!"	The camera is already mapped to this place and door. Choose a different door.
"Unable to continue app configuration, can't get Eagle Eye access token!"	Restart the setup and sign in to Eagle Eye Networks again.
"Session could not be created – Please contact Kisi Support"	Contact Kisi Support.
"Unable to continue app configuration, cannot get configuration parameters!"	Reload the page and try again. If the error persists, contact Kisi Support.
"There can be only one Eagle Eye installation per organization"	Use the existing Eagle Eye Networks integration instead of adding a new one.

Remove the integration

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

Removing the integration deletes every Kisi camera it created.