> For the complete documentation index, see [llms.txt](https://docs.usepylon.com/pylon-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.usepylon.com/pylon-docs/support-workflows/slas-and-timers.md).

# SLAs and Timers

Set differentiated service level agreement timers on customer issues.

SLAs (Service Level Agreements) define how quickly you want to respond to, follow up on, and resolve customer issues.

Pylon supports four types of issue SLAs:

1. First Response Time: How long the customer waits for the first qualifying customer-visible reply. For tickets, timing begins when the issue is created or when the SLA policy is applied, depending on your counting settings. For conversations, it begins with the first qualifying customer message. Counting settings also decide which replies count as a first response: agent replies, trigger replies or human replies. Internal notes and private messages do not count.
2. Next Response Time ends when a qualifying customer-visible reply is sent. Follow-up Time measures whether another qualifying customer-visible update is sent when your team was the last to respond. For both, counting settings decide which replies qualify: agent replies, trigger replies or human replies.
3. Follow-up Time: How long it takes your team to send another customer-visible update when your team was the last to respond. Unlike Next Response Time, Follow-up Time is proactive and it measures whether your team follows up without waiting for another customer message. Internal notes do not count.
4. Resolution Time: How long it takes to resolve an issue. Closing the issue finalizes resolution time. Pylon measures it through the latest qualifying customer-visible reply from your team. If there is no qualifying reply, it uses the time the issue was closed. For a team SLA, Pylon uses that team’s latest qualifying reply or falls back to the close time.

Changes to SLA policies and support-hour settings apply going forward. Completed historical metrics are not recalculated.

Pylon also tracks **active time** — how long teammates actually spend working an issue. It has no target and cannot breach, so it is not an SLA, but it appears alongside the SLA timers on the issue and shares their [counting settings](https://docs.usepylon.com/pylon-docs/support-workflows/slas-and-timers.md#counting-settings).

## Setup <a href="#setup" id="setup"></a>

1. Visit the SLAs page **(Settings > Workflows > SLAs)** and create an SLA policy
2. Set the policy's targets and rules
3. Create or edit a trigger that applies the policy, and set its conditions. SLAs can be applied based on many factors, including the priority of the issue, the type of customer who raised it, etc.

### Notification <a href="#sla-alerts" id="sla-alerts"></a>

To setup notifications for SLAs, choose the "Send Slack notification on SLA breaches" template. Update the channel to your preferred one, or the action to a different notification type (such as email).

When an issue violates an SLA

1. The configured action will be taken, for example notifying a Slack channel
2. Users can also subscribe to notifications for SLA breaches on issues they are assigned to on the [notifications page](https://app.usepylon.com/settings/notifications).

### Support Hours or Calendar Hours <a href="#support-hours" id="support-hours"></a>

Each SLA can count **support hours** or **calendar hours**. With support hours, only time within the [support-hours schedule](https://app.usepylon.com/settings/support-hours) assigned to the issue counts toward the target. Calendar hours include evenings and weekends while the SLA timer is running. Choose the counting basis when configuring the SLA.

### Business Days <a href="#business-days" id="business-days"></a>

An SLA that counts support hours can set its target in **business days**, for example "resolve within 3 business days". Choose **business days** as the unit when you set the target. Targets can be up to 90 business days. Business days aren't available for SLAs that count calendar hours.

A business day is a day with open hours on the issue's [support-hours schedule](https://docs.usepylon.com/pylon-docs/support-workflows/support-hours.md), in that schedule's timezone. Days without open hours and holidays on the schedule are skipped. The SLA is due when support hours close on its last business day.

| When                                                              | What happens                                                     |
| ----------------------------------------------------------------- | ---------------------------------------------------------------- |
| The SLA starts before support hours open                          | That day is the first business day                               |
| The SLA starts after support hours open                           | The first business day is the next one                           |
| The timer runs at any point during a business day's support hours | That day counts, even if the SLA was paused for the rest of it   |
| The timer is paused for all of a business day's support hours     | That day doesn't count, so the SLA is due one business day later |

For example, with support hours of 9 AM to 5 PM, Monday to Friday, a 2-business-day resolution SLA that starts Monday at 11 AM is due Wednesday at 5 PM. If the issue is on hold all of Tuesday, it's due Thursday at 5 PM. If it's on hold only Tuesday morning, it's still due Wednesday at 5 PM. Which statuses pause the timer is set in [counting settings](https://docs.usepylon.com/pylon-docs/support-workflows/slas-and-timers.md#counting-settings).

On a 24/7 schedule, each 24 hours the timer runs counts as one business day, and holidays on the schedule are still skipped.

You can also express a business-day target in support hours, for example 40 hours for 5 business days of 8 hours each. That counts hours rather than whole days, so the deadline is different. With support hours of 9 AM to 5 PM, Monday to Friday, an SLA that starts Monday at 11 AM is due the next Monday at 11 AM with a 40-hour target, and at 5 PM that Monday with a 5-business-day target.

### Counting Settings

Counting settings control when SLA and metric timers run. Find them under **Settings > Workflows > SLAs > Counting settings**. Changes apply to new issues only.

For each metric, choose the statuses in which **Time counts when**:

| Metric              | Timer runs while                                                       |
| ------------------- | ---------------------------------------------------------------------- |
| First response time | The issue is in a selected status                                      |
| Next response time  | The customer was last to respond and the issue is in a selected status |
| Follow-up time      | Your team was last to respond and the issue is in a selected status    |
| Resolution time     | The issue is in a selected status                                      |

`New` and `On You` always count, and closed statuses never do. Add other statuses, including your custom statuses, to keep the timer running in them. Leave a status out to pause the timer while an issue sits in it. For example, leave out `On Hold` so resolution time pauses while you wait on an engineering fix.

Without counting settings, first and next response time count in `New` and `On You`. Follow-up and resolution time also count in `On Customer`.

#### Start counting time when the conversation becomes a ticket

When this is enabled, timers still run while an issue is a conversation, but they restart when the conversation becomes a ticket. A reply sent before the conversation became a ticket no longer counts as the first response; the first reply after it does.

{% hint style="info" %}
Counting settings are available on the Enterprise plan.
{% endhint %}

### Team SLAs

Team SLAs allow setting SLAs on how long a team is assigned to an issue. These run independently from issue SLAs. Like issue SLAs, team SLAs are defined in SLA policies: create a policy on the SLAs page, then apply it from a trigger.

Team SLAs are available on the Enterprise plan.

<figure><img src="https://982123570-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9hXBoCTTNw5flARlUVJf%2Fuploads%2FHZuGLkerHusj1HEJLqxi%2FCleanShot%202025-11-09%20at%2016.20.55%402x.png?alt=media&amp;token=6b8f81df-d6af-47eb-a717-6359fcbc42de" alt="" width="375"><figcaption></figcaption></figure>

### SLAs vs Team SLAs

The key difference is what each SLA measures. Issue SLAs measure the customer's overall experience. For tickets, timing begins when the issue is created or when the SLA policy is applied, depending on your counting settings; for non-ticket conversations, it begins with the first qualifying customer message. Team SLAs measure a specific team’s performance and start when the SLA is applied or the issue is assigned to that team, whichever happens later. This prevents a team from being penalized for\
time before it owned the issue.

Issue SLAs should be used when:

* You want to measure the overall customer experience from issue creation to resolution.

Team SLAs should be used when:

* You want to measure individual team performance separately from the overall customer experience.

### Active Time

Active time measures hands-on effort per person, per issue, rather than elapsed time. It is configured in the same place as SLA counting, **Settings > Workflows > SLAs > Counting settings**, and appears in the SLAs sidebar module on every issue. Active time is available on the Enterprise plan. See [Active Time](https://docs.usepylon.com/pylon-docs/support-workflows/slas-and-timers/active-time.md) for the full behavior.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.usepylon.com/pylon-docs/support-workflows/slas-and-timers.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
