# Third-Party VMS Integrations for Air Quality Sensor Events

Air Quality sensors offer your organization a way to monitor essential indoor air quality factors, such as [vape index](https://help.verkada.com/air-quality/sensor-data/air-quality-sensor-readings), [temperature](https://help.verkada.com/air-quality/sensor-data/air-quality-sensor-readings), [humidity](https://help.verkada.com/air-quality/sensor-data/air-quality-sensor-readings), and more.

Third-party video management system (VMS) integrations allow Verkada sensors to send alert events to on-premise VMS, such as Milestone X-Protect, Wisenet WAVE, or exacqVision. These integrations allow you to receive and view sensor event data within your VMS system, eliminating the need to build custom APIs or manually match sensor events to camera footage.

![](https://3057705728-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJtgmyWYlTEX9DpjvBwTL%2Fuploads%2Fgit-blob-fe0498641943c044c411b519e87337b33500b76a%2F8ec4da5f1f1f0425f7a1241d4d724098c86537cb.png?alt=media)

Each VMS integration varies based on integration prerequisites set by the manufacturer. You will receive an alert that can be easily linked to a camera and includes the sensor name, sensor reading, reading value, threshold surpassed, and timestamp.

{% hint style="warning" %}
At this time, the **video integration feature only sends alert event data**. It does not send time-series data or graph data.
{% endhint %}

#### Supported third-party VMS providers

* Milestone X-Protect
* Wisenet WAVE
* exacqVision

***

## Enable third-party VMS integrations

{% hint style="danger" %}
You need [Org Admin permissions and Site Admin permissions](https://app.gitbook.com/s/NRq5qDDjsYNxwNzF1bcB/users-and-permissions/roles-and-permissions-for-command) for each site that the sensors are located in to enable this feature.
{% endhint %}

To activate the Third-Party VMS Integration functionality on your sensors, you first need to enable the feature for your organization.

{% stepper %}
{% step %}
**In Verkada Command, go to All Products > Admin .**
{% endstep %}

{% step %}
**Select Privacy & Security> Feature Manager.**
{% endstep %}

{% step %}
**Under Air Quality > Third-Party VMS Integration, select Enable from the dropdown.**
{% endstep %}
{% endstepper %}

### Set up a third-party VMS integration

{% hint style="warning" %}
A sensor may only be connected to a single VMS server. Once integrated, the device will appear as **Unavailable** if a different video integration is initiated.
{% endhint %}

{% hint style="danger" %}
Sensor **must be on the same local network and VLAN** as the third-party VMS server.
{% endhint %}

{% stepper %}
{% step %}
**In Command, go to All Products > Air Quality.**
{% endstep %}

{% step %}
**On the left navigation, click VMS Integration .**
{% endstep %}

{% step %}
**Select a Video Management System.**

a. Click **Submit a suggestion** to send a suggestion to our product team.\
b. In the top right, click **+ Add Integration** select another supported VMS

<div align="left" data-with-frame="true"><img src="https://3057705728-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJtgmyWYlTEX9DpjvBwTL%2Fuploads%2Fgit-blob-a5527b163c47c8f4188df12382c78bc68eb3d3d5%2F78cdc1a1b23c77dec60d0410f23da53185a383a6.png?alt=media" alt="" width="353"></div>
{% endstep %}

{% step %}
**Each VMS integration will be slightly different, but you will need to enter the following:**

a. Server **IP Address**: The IP address of your VMS server.\
b. Server **Port** Number: The port on your VMS server which will be able to receive events.\
c. (If applicable) **Username**: A configured username that is capable of receiving alerts into the system.\
d. (If applicable) **Password**: Password for the configured user above.

<div align="left" data-with-frame="true"><img src="https://3057705728-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJtgmyWYlTEX9DpjvBwTL%2Fuploads%2Fgit-blob-3e07d27e46e0b6a4e4f51acb22ea301fc37b2e4a%2Fda75ba5b863422246a2242892df463009d37aea5.png?alt=media" alt="" width="344"></div>
{% endstep %}

{% step %}
**Select the sensors you would like to connect and click Integrate.**
{% endstep %}

{% step %}
**The devices will begin to receive the configuration and attempt to establish a connection to the VMS server. This may take a few minutes to complete.**
{% endstep %}
{% endstepper %}

***

### Status indicators on Command

* Green: Successfully connected or submitted an event.
* Orange: The device may be offline or has **not yet** submitted a status to the backend.
* Red: Failed to connect or failed to submit an event to the VMS server.

{% hint style="warning" %}
The **Refresh** button checks if any of the devices have submitted any events or attempted connections to the server. It does not force the device to connect to the server.
{% endhint %}

***

## Mange Third-Party VMS Integration

### Edit integration

{% stepper %}
{% step %}
**In Command, go to All Products > Air Quality.**
{% endstep %}

{% step %}
**On the left navigation, click VMS Integration .**
{% endstep %}

{% step %}
**You will see a list of existing integrations**
{% endstep %}

{% step %}
**Next to the integration you want to edit click > Edit Integration.**

a. Modify the configuration as needed.\
b. Click **Edit Devices.**\
c. Click **Save Changes.**
{% endstep %}
{% endstepper %}

### Delete integration

{% stepper %}
{% step %}
**In Command, go to All Products > Air Quality.**
{% endstep %}

{% step %}
**On the left navigation, click VMS Integration .**
{% endstep %}

{% step %}
**Next to the integration you want to delete click > Delete Integration.**

a. Enter the confirmation code.\
b. Click **Delete.**
{% endstep %}
{% endstepper %}

***

## What needs to be done on the VMS Server Side?

The process differs between each VMS. Refer to their documentation for precise instructions.

In general, the following steps must be completed:

* Create generic or user defined events for each device & reading.
* Create alarms for the events.
* Create rules to set up custom actions such as trigger camera recording or notifications.
* Create mappings between these different elements:
  * Event → Alarms → Rules → 3rd Party Camera Association

You may need to repeat these steps for each device.
