WorkestraDocs
ModulesSupport

SLA Policies

Define response and resolution time targets with live compliance tracking and automated breach alerts.

SLA (Service Level Agreement) policies define the expected response and resolution times for tickets based on their priority. Workestra tracks compliance in real time, surfaces SLA status on every ticket, and sends automated alerts when tickets are at risk.

Creating SLA Policies

  1. Go to Support > Settings > SLA Policies
  2. Click the + button
  3. Fill in the policy form:
FieldDescription
Policy NameDisplay name (e.g., "Standard Support")
DescriptionWhen this policy applies
Applicable PriorityLow, Medium, High, or Urgent
Response Time (Hours)Target time for first response
Resolution Time (Hours)Target time for full resolution
Warning Threshold (%)Percentage of resolution time at which the warning event fires (50–99, default 80)
Use Business HoursWhen on, the SLA clock skips non-working hours and workspace holidays
Escalation LadderOrdered list of actions that fire after the breach moment
  1. Click Create Policy

Example Configuration

PriorityFirst ResponseResolution
Urgent1 hour4 hours
High4 hours8 hours
Medium8 hours24 hours
Low24 hours72 hours

How SLA Tracking Works

When a ticket is created, Workestra automatically matches it to an active SLA policy based on the ticket's priority. The SLA timer starts from the ticket creation time.

SLA Status Indicators

SLA status appears in three places:

  1. Ticket list — Small dot + remaining time next to each ticket row
  2. Ticket detail sidebar — Banner at the top of the sidebar
  3. Dashboard — SLA Compliance % stat card
StatusIndicatorTrigger
On TrackGreenLess than 75% of resolution time elapsed
WarningAmber75%–100% of resolution time elapsed
BreachedRedResolution time exceeded

First Response Time

Workestra tracks when the first agent reply (non-internal) is sent on each ticket. This is displayed in the ticket metadata and used for response time reporting.

Automated Alerts

Workestra runs a daily SLA check that scans all open tickets against their applicable SLA policies:

Warning Notifications (configurable threshold)

When a ticket has used the configured warning threshold (default 80%) of its SLA resolution time:

  • The assigned agent receives an email alert and an inbox notification
  • The ticket's SLA indicator changes to amber
  • A ticket.sla_warning event is emitted (visible to automation rules and webhooks)

Breach Notifications (100% threshold)

When a ticket exceeds its SLA resolution target:

  • The assigned agent receives an email alert and an inbox notification
  • Workspace admins are also notified via inbox
  • The ticket's SLA indicator changes to red
  • A ticket.sla_breached event is emitted, which triggers the policy's escalation ladder

SLA checks run once per day. For real-time SLA indicators on individual tickets, the status is computed live when you view the ticket.

Business Hours

When Use Business Hours is on, the SLA clock pauses outside working hours and on workspace holidays. A ticket created at 5 PM on Friday with a 4-hour resolution target won't breach until 1 PM on Monday — instead of breaching overnight on a calendar clock.

Business hours come from the workspace's default working pattern (Monday–Friday, 9 AM – 5 PM unless you've changed it). Holidays are managed at the workspace level.

Turn business hours on for any team that doesn't operate 24/7. It prevents the "Monday morning all-tickets-breached" effect.

Escalation Ladder

The escalation ladder defines what happens after a ticket breaches. Each step has an offset (relative to the breach moment) and an action:

ActionWhat It DoesParams
NotifySends an alert to the chosen channelschannels: inapp,email
Reassign toMoves the ticket to a specific useruser_id: <uuid>
Set priorityBumps the ticket to a new prioritypriority: urgent

Offsets use the format +0m, +30m, or +2h — the time after the breach when the step should fire.

Example Ladder

For a 4-hour resolution policy, a useful ladder might be:

StepOffsetActionEffect
1+0mNotifyAlert the on-call team the moment the ticket breaches
2+30mSet priorityBump to Urgent if still unresolved 30 minutes later
3+2hReassign toHand off to the support lead 2 hours past breach

Each step fires at most once per ticket, even if the daily SLA check runs again the next day. The order of steps in the form is the order they fire.

Manual Escalation

You can also manually escalate a ticket from the ticket detail page by clicking Escalate, which sets the priority to Urgent and notifies workspace admins. Manual escalation runs independently of the ladder.

Managing Policies

Edit a Policy

  1. Find the policy in the list
  2. Click the Edit (pencil) icon
  3. Modify fields
  4. Click Save Policy

Delete a Policy

  1. Click the Delete (trash) icon on any policy
  2. Confirm the deletion

Deleting a policy removes SLA tracking from all tickets that were using it. Consider deactivating instead if you want to preserve historical data.

Best Practices

  • Create one policy per priority level for clear coverage
  • Turn on Use Business Hours for any team that doesn't operate 24/7
  • Start with a single notify-only ladder step; add reassignments only once you've watched a few real breaches
  • Set the warning threshold to 80% for tight policies and 70% for relaxed ones — it should give the agent enough time to react
  • Monitor the SLA Compliance metric on the dashboard weekly
  • Use the Escalate action for tickets approaching SLA breach

Next Steps