Integrating Unifi Protect into CHeKT

Integrating Unifi Protect into CHeKT

Overview

This article walks through the steps to integrate a Unifi Protect camera into the CHeKT system, including configuring the camera stream, adding it to the CHeKT bridge, and setting up alarm webhooks.

Step 1: Configure the Camera in the Unifi Web Interface

  1. Open the Unifi web interface and click Protect
  2. Click Devices
  3. Click on the camera you want to configure
  4. Rename the camera to your desired name


Info
💡Tip: If you have more than one bridge, we recommend using a naming convention such as CH1.1, CH1.2, etc. to keep track of which bridge each camera is assigned to.



Step 2: Get the RTSP Stream URL

After clicking on the camera, a settings panel will appear on the right side of the screen.

  1. Click the Settings Gear icon
  2. Set the resolution to Medium (CHeKT recommends no higher than 1280x720) for best functionality
  3. Copy the RTSPS URL that is generated


Info
📋 Recommendation: Create a Cheat Sheet to store URLs and other important information you'll need throughout this integration.

Step 3: Convert the RTSPS URL to an RTSP URL

After copying the RTSPS URL, paste it to your Cheat Sheet and modify it as follows:

  • Change RTSPS to RTSP
  • Change the port number from 7441 to 7447
  • Remove everything from the question mark (?) onward


Alert

Example of a correctly formatted RTSP URL:

rtsp://192.168.1.216:7447/epmRulR4oqHbNtqb


Info
Once you have created the new RTSP stream URL, You can add the camera to the CHeKT bridge.

Step 4: Add the Camera to the CHeKT Bridge

  1. From the Dealer Portal , navigate to Site Details
  2. Click Add > Add Camera
  3. Select the Channel you want to add the camera to
  4. Select Add Device Manually
  5. Choose Video Stream URL as the mounting type
  6. Enter the new RTSP stream URL from your Cheat Sheet
  7. Enter the camera's username and password , then click
    Authenticate


Notes
💡Tip: We recommend disabling Cloud AI during setup so that all triggers are captured when testing alarm functions at the end.

Step 5: Enable Local API on the Bridge


Notes
📌Note: We recommend using a static IP address for the bridge, or setting up a DHCP reservation , when using the Local API.

  1. Navigate to Bridge Settings
  2. Go to the Network tab  

  4. Enable Local API Service
  5. Scroll down to the API Keys section
  6. Generate and copy the API key


Alert
🔑Note: Each camera will use the same API key.

Step 6: Configure the Alarm Webhook in Unifi

  1. Navigate back to the Unifi web interface
  2. Click Protect at the top
  3. Click Alarm Manager (bottom left)
  4. Under Objects , select Person and/or Vehicles
  5. Select the one camera you are setting up


    6. Warning
    ⚠️ Important: Do not select multiple cameras at once.

    1. In the Actions section (yellow box), configure the following:
    • Action Type: Webhook
    • Webhook Type: Custom Webhook
    • Delivery URL: Bridge IP & Channel Number Ex. http://[xxx.xxx.xxx.xxx]:30003/api/v1/channels/[channel#]/events
    • Check Advanced Settings
    • Method: POST
    • Authentication: Basic
    • Username: apikey (always)
    • Password: The API key copied from the bridge
    1. Once all information has been entered, click Test Alarm to verify the webhook is functioning correctly


    Warning
    ⚠️ Important: The CHeKT system must be armed for alarms to send.

    1. Check your Monitoring Portal to confirm the test alarm was received


Step 7: Save the Alarm

  1. Once the test alarm is confirmed, click Create (top left, next to the Channel name) to save the alarm

Info
🔁Adding More Cameras? Click Create Alarm and repeat Steps 2–7 for each additional camera.