Smart Routing
Smart routing sends a transfer to a different destination depending on the contact's data or what the agent learned on the call. For example, Texas callers go to your Texas team and everyone else goes to your main line.
Go to Outreach › AI Agents › Agents, open an agent, then click Edit on Configuration › Smart routing.
Add a rule
- Click Add Routing Rule.
- After If, type the variable name, for example
Taalk_state. No curly braces needed. - Pick an operator.
- Type the value to compare, for example
TX. - After the arrow, enter the destination.
- Repeat for more rules. Click the trash icon to remove one.
- Click Save, then test with Roleplay.
A rule needs a variable and a value, or it's not saved as a condition.
Operators
| Operator | Matches when | Example |
|---|---|---|
| equals | The value is exactly the same | Taalk_state equals TX |
| not equals | The value is anything else | Taalk_state not equals CA |
| contains | The value includes the text | lead_source contains web |
| starts with | The value begins with the text | zip_code starts with 90 |
Comparisons are exact, including capital letters: TX and tx are different.
Which variables you can use
| Kind | Examples | Where it comes from |
|---|---|---|
| Contact data | Taalk_state, lead_source, plan_type |
Columns uploaded with your contacts. See Script Variables and Formatting. |
| Data the agent captures | zip_code, interest |
Values the agent collects during the call, using whatever name your script gives them |
Destinations
The destination field accepts the same formats as Call transfer › Transfer To:
| Format | Example |
|---|---|
| Phone number | +18005551111, or +18005551111,,123 to dial an extension |
| SIP address | sip:[email protected] |
| Contact field | {Taalk_RepPhone} |
| Another AI agent | agent: followed by the agent ID (copy it from the agent's … menu › Copy agent ID) |
| Taalk Phone line | vdp: followed by the line. See AI Agents on Taalk Phone. |
If the format isn't valid you'll see "Please provide the number such as +1XXXXXXXXX or sip:xxxxx".
Example: route by state
| Rule | If | Destination |
|---|---|---|
| 1 | Taalk_state equals TX |
+18005551111 |
| 2 | Taalk_state equals CA |
+18005552222 |
| No match | Call transfer › Transfer To |
[Confirm] Rules are checked top to bottom, the first match wins, and calls that match no rule use Call transfer › Transfer To.
Availability
Smart routing works for any workspace that has transfers. If the section is blurred with an Upgrade button (Go live on free workspaces), transfers aren't included yet. The transfer type, whisper and fail messages still come from Call transfer. See Transfers and call flow.
Tips
- Keep to a handful of rules. Long lists are hard to check.
- Agree on variable names with whoever builds your contact files.
- Upload a few test contacts with known values and run Roleplay for each.
Troubleshooting
| Problem | Fix |
|---|---|
| Every call goes to the default number | The variable name or value doesn't match exactly. Check spelling and capitals. |
| Rule won't save | The destination isn't a valid format. |
| The agent transfers but to the wrong team | Two rules overlap. Put the more specific rule first. |