# Helix Alerts

Helix is Verkada’s customizable video search and integration engine that brings third-party data from on-premises or cloud-based systems into Command. This data indexes footage with user-defined attributes, making searching and identifying specific events easier.

With Helix alerts, users can receive proactive notifications in Command for integrated events, either for all new Helix events or only those that meet defined thresholds.

***

## Configuration

### Create Alert > Events

{% stepper %}
{% step %}
**On the Command homepage, left navigation, click Alerts.**
{% endstep %}

{% step %}
**At the top, click New Alert.**
{% endstep %}

{% step %}
**On Select Event, choose Camera > Helix.**
{% endstep %}

{% step %}
**On Cameras:**

a. Choose to receive alerts from **Sites** or **Individual Cameras**.\
b. Click **Done** to continue.

{% hint style="warning" %}
&#x20;Helix alerts are tied to specific Helix event types. We recommend selecting all cameras to ensure no important events are missed.
{% endhint %}
{% endstep %}

{% step %}
**On Helix Event Type:**

a. Select a Helix Event Type.

{% hint style="info" %}
The event types listed are the ones [you configured](https://apidocs.verkada.com/reference/getting-started).
{% endhint %}

b. Click **Done** to continue.
{% endstep %}

{% step %}
**On Thresholds:**

a. Enable the **All Events** toggle to receive alerts whenever a new Helix Event is generated.\
b. For more granular control, define up to two thresholds joined by **AND** or **OR** logic. An alert will be triggered whenever a Helix event meets the specified threshold conditions.

<div align="left" data-with-frame="true"><img src="https://1795869993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FylYKicREo6JpuOJH4teK%2Fuploads%2Fgit-blob-83861db4518116277bde9d60c5f016bdb32ffb5b%2Fc8230d031126a3dd2a9c782c0e61e05055061c59.png?alt=media" alt="" width="211"></div>

c. Click **Done** to continue.
{% endstep %}

{% step %}
**Click Done and continue with the alert** [**recipients**](#h_7b9581b6e8)**.**
{% endstep %}
{% endstepper %}

### Create Alert > Recipients

{% hint style="warning" %}
To prevent excessive notifications, users are limited to 500 SMS messages per day, per user.
{% endhint %}

{% stepper %}
{% step %}
**On Recipients, add users individually or assign the alert to a group.**
{% endstep %}

{% step %}
**Select the dropdown menu next to a user or group to choose their notification method(s). Recipients can be notified via push, SMS, or email notifications.**

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

{% step %}
**(Optional) By default, you will be an alert recipient. Select the dropdown menu and click Delete to remove yourself.**
{% endstep %}

{% step %}
**Click Done and continue with the alert** [**notification schedule**](#h_317d483072)**.**
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
Any recipient added to this alert will see it appear under the **Shared Alerts** section of their **Alerts** page.
{% endhint %}

### Create Alert > Notification Schedule

{% stepper %}
{% step %}
**On Notification Schedule, specify the days and times for the alerts to send notifications. Alerts generate 24/7 by default.**

<div align="left" data-with-frame="true"><figure><img src="https://1795869993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FylYKicREo6JpuOJH4teK%2Fuploads%2FLGReMlIJJZHOhecnbdWV%2Fimage.png?alt=media&#x26;token=1b2ce80f-f79a-43f7-b4ba-4e6144e72fae" alt="" width="375"><figcaption></figcaption></figure></div>

{% hint style="warning" %}
Helix email and SMS alerts use a 1-minute cooldown per device. Any events triggered during this window are suppressed and labeled as **Cooldown** in Command.
{% endhint %}
{% endstep %}

{% step %}
**Click Done and continue with the alert** [**device actions**](#h_a426fdc345) **or** [**finish the alert**](#h_207adbdaf2)**.**
{% endstep %}
{% endstepper %}

### Create Alert > Device Action

{% stepper %}
{% step %}
**On Device Action, select the horn speaker(s) you want to play your message.**
{% endstep %}

{% step %}
**Select your notification preference (Text to Speech or Audio File).**

a. For **Text to Speech,** enter a message up to 200 characters.\
b. For **Audio File,** drag and drop the file or click **choose a file** to upload your audio clip.

<div align="left" data-with-frame="true"><img src="https://1795869993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FylYKicREo6JpuOJH4teK%2Fuploads%2Fgit-blob-6eebd070cac52d81c895573628cb7b21ba245804%2Fbd7aa4597a411933461874e312ac1e72683f4dab.png?alt=media" alt="" width="263"></div>
{% endstep %}

{% step %}
**Click Done and continue with** [**finish the alert**](#h_207adbdaf2)**.**
{% endstep %}
{% endstepper %}

### Finish the alert

{% stepper %}
{% step %}
**In the bottom right of the configuration window, click Next.**
{% endstep %}

{% step %}
**Enter a descriptive name for the alert.**
{% endstep %}

{% step %}
**Click Done to complete the setup.**

<div align="left" data-with-frame="true"><img src="https://1795869993-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FylYKicREo6JpuOJH4teK%2Fuploads%2Fgit-blob-75fcc30636d14fdd34cc9e376db710c1542f4ef2%2F943420792c6bfe40aee47eab735038e52669e4ac.png?alt=media" alt="" width="188"></div>
{% endstep %}
{% endstepper %}
