How to create and manage routing rules
Last updated November 20, 2026
Overview
Routing rules process, tag and assign incoming tickets automatically. Each rule checks conditions such as customer segment, channel, business hours, keywords in the subject or message and custom field values, then sends the ticket to the right team or agent. This removes manual triage and gets tickets to the right people faster.
Every routing rule uses AND logic: a rule is triggered only when all of its conditions are true. Keywords in the same field work as OR: the rule applies if any keyword matches. If you need OR logic between different conditions, create similar rules, each with a different condition.
Key Features
- AND logic: A rule is triggered only when all its conditions are true. If even one doesn't match, such as the channel or business hours, the rule is skipped.
- First match wins: Atlas checks rules from top to bottom and applies only the first rule that matches. The remaining rules are skipped.
- Default fallback: If no rule matches, the ticket keeps your default settings.
- Keyword matching: Check the ticket subject or message for one or more keywords. The rule applies if any keyword matches, and Python regular expressions are supported.
- Custom fields (preview): Match tickets created with any of the selected values of list-like custom fields.
- Shift-aware assignment: Distribute tickets by round robin or least busy, and only to agents who are on shift.
- Multiple actions in one rule: Route to a team, assign an agent, send an automatic reply, add tags, and set priority or status at the same time.
- Real-time evaluation: A new or updated rule starts evaluating new tickets immediately.
Conditions and actions
A rule is triggered only when all the conditions you set are true. Then Atlas runs all the actions in the rule.
How conditions work together
A routing rule uses AND logic: it's triggered only when all of its conditions are true. For example, a rule with the "Email" channel and the keyword refund only applies to email tickets that contain "refund". A chat ticket with "refund" doesn't trigger it.
Inside "Subject contains" and "Message contains", keywords work as OR: the rule applies if any keyword matches. For example, to route tickets that mention "refund" or "chargeback" in the subject, add both keywords to one rule:
| Rule | "Subject contains" | Actions |
| Billing – refunds | refund, chargeback | Assign team: Billing |
To get OR logic between different conditions, for example the subject or the message, create similar rules with a different condition in each one. See the example below.
How to create a routing rule
- Go to "App Configuration > Ticket Management > Routing" and click "Add rule".
- Enter a descriptive "Name".
Conditions
- Set "Escalated by Zeus":
- Enabled: The rule is evaluated only after a Zeus Agent escalates a ticket.
- Disabled: The rule ignores tickets escalated by a Zeus Agent.
- Select the customer "Segment" the rule applies to. To create one, click "Add customer segment".
- Optionally, configure "Subject contains". Add keywords by pressing Enter or typing a comma and a space, for example
refundandchargeback. The rule applies if the ticket subject contains any of them. Python regular expressions are supported. - Optionally, configure "Message contains". Add keywords the same way. The rule applies if the message contains any of them.
- Select the "Channels". Only tickets created through these channels are evaluated.
- In "Business hours", choose "During business hours", "Outside business hours" or "All hours". To set your hours, click "Set up business hours".
- Optionally, in "Custom fields (preview)", click "+" and select the ticket fields and values. The rule applies to tickets created with any of the selected values. Only list-like fields are supported for now.
Actions
- Click "Add action" and select one or more actions. Each action opens its own settings:
- Assign team: In "Select Team", choose the team that handles the ticket.
- Assign agent: Choose the "Distribution method": "Round robin", "Least busy" (fewest assigned open tickets) or "Specific Agent". Then select the "Agents to assign". Optionally, turn on "Restrict to on-shift" and "Enable maximum tickets per agent" (enter the maximum number of open tickets).
- Send response: Sends an automatic reply to the customer. Write the "Message". You can add formatting, canned responses, Help Center articles, mentions, variables
{{ }}and emojis. - Set priority: Select "Low", "Medium", "High" or "Urgent".
- Set tags: Select the tags to add to the ticket.
- Set status: Select "Open", "Closed" or "Pending".
- Click "Create routing rule". The rule starts evaluating new tickets immediately.
To remove an action from the rule, click "Remove" in its section.
Example: Route password issues to Technical Support
These rules send email tickets from visitors about passwords to the Technical Support team during business hours, tag them and set them to Pending. Because all conditions in a rule must be true, matching the subject or the message needs one rule for each.
| Setting | Rule 1: Password – subject | Rule 2: Password – message |
| Escalated by Zeus | Disabled | Disabled |
| Segment | Visitors | Visitors |
| Subject contains | password | — |
| Message contains | — | password |
| Channel | ||
| Business hours | During business hours | During business hours |
| Team (action) | Technical Support | Technical Support |
| Tags (action) | Account Login | Account Login |
| Status (action) | Pending | Pending |
A visitor emails on Tuesday at 10:30 AM, during business hours, with the subject "Password reset needed". The ticket meets every condition in Rule 1, so Atlas:
- Routes it to the Technical Support team.
- Adds the Account Login tag.
- Sets the status to Pending.
If the subject were "Can't log in" but the message said "I forgot my password", Rule 1 wouldn't apply and Rule 2 would.
How to edit a routing rule
- Go to "App Configuration > Ticket Management > Routing" .
- Click the rule, or click the ellipsis icon on its row and select "Edit".
- Make your changes and click "Update routing rule".
How to change the order of routing rules
- Go to "App Configuration > Ticket Management > Routing" .
- Move a rule up or down in the list. Atlas evaluates rules in this order, from top to bottom.
How to delete a routing rule
- Go to "App Configuration > Ticket Management > Routing" .
- Click the ellipsis icon on the rule's row and select "Delete".
- Click "OK" to confirm.
FAQs & Troubleshooting
Why wasn't my routing rule applied?
The most common reason is the order of your rules. Atlas checks routing rules from top to bottom and applies only the first rule that matches the ticket. A rule matches when all of its conditions are true for that ticket. Once a rule matches, Atlas stops and doesn't check the rules below it.
For example, you create a rule for tickets from your #VIP Slack channels. Above it, there's a rule that applies to all channels and has no other conditions. That rule matches every ticket, including your VIP tickets, so Atlas applies it first and never gets to your specific rule, even though your rule is set up correctly.
To fix it:
- Go to "App Configuration > Ticket Management > Routing" .
- Open each rule above yours and compare its conditions with the ticket: segment, channels, business hours, keywords, custom fields and if it was escalated by Zeus.
- If all the conditions of a rule above yours are true for the ticket, that rule is the one being applied. Drag your rule above it.
If no rule above yours matches the ticket, check that the ticket meets all the conditions of your rule:
- Belongs to the selected segment.
- Came through a selected channel.
- Arrived within the selected business hours.
- Contains at least one of the "Subject contains" or "Message contains" keywords.
- Has one of the selected "Custom fields (preview)" values, if you set any.
- Matches the "Escalated by Zeus" setting.
Can a rule apply when only one of its conditions is true?
No. Rules use AND logic, so all conditions must be true. For OR logic, create similar rules with a different condition in each one.
Can I add several keywords to "Subject contains" or "Message contains"?
Yes. Add each keyword by pressing Enter or typing a comma and a space. The rule applies if any keyword matches. To match a literal comma followed by a space, write ,\ (comma, backslash, space).
What happens when several routing rules match a ticket?
Atlas checks rules from top to bottom and applies only the first rule that matches. The rest are skipped.
What happens when no routing rule matches?
The ticket keeps your default settings.
Why isn't the ticket assigned when "Restrict to on-shift" is on?
Tickets go only to agents who are on shift right now. Check that the shift is set up in "App Configuration > Shifts > Scheduling" , that the agents are assigned to it, and that all of them share one shift.
Does a routing rule apply to existing tickets?
No. Rules evaluate only new tickets received after the rule is created or updated.
Can I deactivate a routing rule?
No. If you no longer need a rule, delete it.

