How to Configure a Watchlist

How to Configure a Watchlist

Overview

This article walks you through creating a Watchlist in Horizon — using a concrete example: detecting tickets with no activity for 3 or more days and creating a floating todo to remind the technician to call the customer.

Where to find it: Admin Panel → Components → Watchlists

Quick note, this HOWTO is about configuring a Watchlist to trigger a Watchlist Lifecycle Rule. It's important to realize that you can also view Watchlists on the Agent and Dispatcher Panels and by clicking on a Stage, you can view the relevant tickets!

Prerequisites

  • An active helpdesk integration with synced ticket fields, including at least one datetime field (e.g., due date, last activity date)

What You're Configuring

Before the steps, here's the full picture.

A Watchlist monitors a single datetime field across all open tickets. You define a direction — are you counting down to a future deadline, or measuring time since a past event? — and a set of Stages: threshold boundaries that tickets cross as time elapses or a deadline approaches.

Lifecycle Rules are separate objects linked to a watchlist. Each rule targets a specific stage (or all stages) and fires a single action — like creating a todo, triggering triage, or sending a scheduling link — the first time a ticket enters that stage.

The scan runs on a schedule. Each cycle, it finds tickets that have newly crossed into a stage, fires any matching rules, and records the entry so the rule does not fire again for that ticket.

Steps

1. Create the Watchlist

Navigate to Admin Panel → Components → Watchlists and click Create Watchlist.

  • Name: 3-Day No Activity
  • Active: On

Click Save.

2. Configure the Watched Field and Direction

Under Monitoring:

  • Watched Field: Select lastActivityDate (or your helpdesk's equivalent field for last ticket activity)
  • Direction: Elapsed — you're measuring time since the last activity, not time until a future deadline

Direction controls how thresholds are interpreted. Approaching counts minutes remaining before a future value; Elapsed counts minutes that have passed since a past value.

3. Add a Stage

Scroll to Stages and click Add Stage.

FieldValue
LabelStale
Threshold (Minutes)4320
ColorWarning

4,320 minutes equals 3 days. A ticket enters the Stale stage the first time the scanner detects that 4,320 or more minutes have elapsed since its last activity date.

You can add multiple stages at different thresholds — for example, a Warning at 4,320 minutes and a Critical at 7,200 (5 days) — each able to trigger its own rules.

Click Save.

4. Set a Ticket Filter Before Adding Lifecycle Rules

Important: When you first activate a watchlist that has Lifecycle Rules attached, the initial scan will fire those rules against every existing ticket that already meets a stage threshold. On a large account, this can mean hundreds of todos created or triage jobs run at once.

Before attaching any Lifecycle Rules, set a Ticket Filter that restricts the watchlist to a small, known set of tickets — for example, a single queue or a specific company. Validate that the rules behave as expected on that limited scope, then broaden the filter once you're confident.

Under Filtering, select a Ticket Filter. Leave it empty only if you have no Lifecycle Rules attached, or if you have explicitly accounted for the full population of matching tickets.

5. Save the Watchlist

Click Save.

6. Add Lifecycle Rules

Navigate to Admin Panel → Components → Watchlists → Lifecycle Rules and click Create Lifecycle Rule.

  • Watchlist: 3-Day No Activity
  • Stages: Stale
  • Action: Create Floating Todo
  • Configure the todo details — for example: "Call customer to follow up on ticket"
  • Active: On

Click Save.

Multiple rules can be attached to the same watchlist and all fire when a ticket enters a matching stage. Rules execute in the order defined by their position.

Monitoring Scan Activity

Navigate to Admin Panel → Components → Watchlists → Scan Logs to see which tickets entered which stages on each scan cycle and whether a workflow was triggered.

Result

When the scanner next runs, any ticket whose last activity date is 3 or more days in the past will enter the Stale stage. A floating todo is created on that ticket — once. Future scans will not re-trigger the rule for tickets already recorded in that stage.

Related Articles

    • Related Articles

    • How to Configure a Triage Policy

      Overview This article walks you through configuring a Triage Policy in Horizon, including setting up classification steps, text generation steps, title formulas, and triage hints that give you deterministic control over how tickets are classified and ...
    • Configure User Notification Channels and Ticket Assignment Alerts

      Overview The user notification system delivers personal alerts (e.g., on ticket assignment) to a user's chosen channel. This article walks through the channels available, how to set them up as a user or as an admin, and how to opt in to ticket ...
    • How to Set Up SMTP Relay

      Overview Configure an SMTP Relay so that Horizon sends emails directly through your own mail server, improving deliverability and ensuring emails arrive as your address — not ours. This is especially important for calendar invites and other ...
    • Ticket Lifecycle: Overview

      What Is Ticket Lifecycle? Ticket Lifecycle connects helpdesk statuses to automated actions — when a ticket hits the status you configure, the system runs triage, routing, or both. Where to find it: Admin Panel → Ticket Lifecycle Key Concepts ...
    • Setting Up AI Integration

      Overview This guide walks you through connecting Horizon to an AI provider. Horizon uses AI for triage, smart tagging, and other capabilities. You can bring your own API key from any of the 10 supported providers. Where to find it: Admin Panel → ...