> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usertick.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Usertick runs surveys on websites, by link, by QR code and by email, and collects every response in one inbox with reports, dashboards and workflows. The REST API lives at https://app.usertick.com/api/public/v1 and uses Bearer API keys or OAuth access tokens; the JavaScript SDK is the @usertick/snippet package on npm.

# Threshold alerts

> Run a workflow when a survey's number, such as NPS or the count of urgent responses, crosses a line you set, and post the alert to Slack, Teams or teammates.

Threshold alerts run a workflow when a number of its survey crosses a line, instead of on each response. Usertick checks the number every hour.

## Set up an alert

**1. Change the trigger**

In edit mode, select the trigger card and set **Starts** to **When a number crosses a line**.

**2. Set the number and the line**

Choose the **Number**, the direction under **When it** and the **Line**, then how far back it is **Measured over** and **How often** it may run.

**3. Add the steps**

Add **Notify teammates**, or **Post a message** in Slack or Microsoft Teams, with a **Wait** between them if you need one.

**4. Test and publish**

Select **Test run**, then **Publish workflow**.

## Alert settings

* **Number** can be **NPS**, **Average score**, **Share of detractors**, **Responses**, **Responses the AI marked urgent** or **Responses of a type**, and Usertick offers only the numbers the survey can measure.
* **Question** selects the NPS, rating or scale question for **NPS**, **Average score** and **Share of detractors**.
* **Type** selects Bug, Idea, Complaint, Question or Praise for **Responses of a type**.
* **When it** sets the direction, either **Falls below** or **Rises above**.
* **Line** sets the value to watch, and for **Share of detractors**, the field reads **Line, in percent**.
* **Measured over** sets the window, which can be **The last hour**, **The last 24 hours**, **The last 7 days** or **The last 30 days**.
* **How often** limits the alert to **At most once an hour**, **At most once every 6 hours**, **At most once a day** or **At most once a week**.
* **Also run when it is back** runs the workflow once more when the number returns to the other side of the line.

Usertick measures NPS, averages and shares only after the window has 30 responses.

## What an alert sends

Because an alert has no response behind it, it can't use **Only if** conditions or **If / else**, and its only tool steps are **Notify teammates** and **Post a message**. Each message starts with the alert's own words, a headline such as "NPS fell below 30 on Checkout feedback" followed by a line with the numbers. **Insert field** has an **Alert** group with **Headline**, **Detail line**, **Current number**, **Previous period number** and **Link to the results**. In a chat tool, Usertick posts an alert as a single message with an **Open results** button.

A **Test run** measures the number as it is now and runs the steps only when the number is past the line, unless you select **Run anyway**. See [Test a workflow](https://docs.usertick.com/workflows/test-run.md).

An alert counts toward the survey's [workflows per survey](https://docs.usertick.com/workflows/overview.md#plans-and-limits).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.