This article introduces concepts and tools for advanced routing. You will benefit from this topic if your routing requires complex evaluations, time-based or date-based criteria, dynamic queue prioritization and more. Before reading further, familiarize yourself with the basics first.
Create complex policies using the Expression Editor
The Expression Editor allows you to configure routing policies that require complex evaluations or time-based and date-based criteria.
- Routing VIP consumers to specific agents or skills within business hours
- Routing conversations from certain channels with critical intents during the busiest months or weeks
- Joining multiple complex evaluation criteria to arrive at a logical decision for routing
The Expression Editor is only available to brands that are upgraded to Conversation Context Service v2. Please talk to your LivePerson account representative if you want to use this feature and have not been upgraded.
Using the Expression Editor
Launch the Expression Editor: Open Conversion Orchestrator, and select Manage Policies under the Dynamic Routing module. To view the policy editor, select an existing policy, or click Add Policy. Switch to the Write an expression tab to view the expression-based editor.
Write expressions: You can write expressions using logical operators, any SDEs, context variables or conversation attributes.
The following operations are possible:
Operators: and, or, not
(namespace.varA == 10) and (namespace.varC > namespace.varD)
(namespace.varA > 5) or (namespace.varC > namespace.varD)
not (namespace.varA == namespace.varB)
Operators: ==, !=, >=, <=, >, <, in
namespace.varA <= namespace.varB
namespace.varC in custom.DList
namespace.varD != namespace.varB |
Operators: +, -, *, / ,% not, sqrt, ||
(namespace.varA + namespace.varB) > 8
(namespace.varA^4) == namespace.varB*namespace.varD
namespace.varP == (namespace.varX || namespace.varY)
((namespace.varA > namespace.varB) > 8 and (namespace.varC +namespace.varD) > custom.param) or (namespace.varX in custom.listA)
Use custom variables and LivePerson Functions: Add custom variables and LivePerson Functions to extend your use cases.
Remember the following when writing expressions
Enclose strings within single quotes ‘ ’.
personalinfo.company == 'LP'
Don’t enclose numbers or boolean within quotes.
custom.VIP_FAAS == true
conversation.minutesSincePreviousMessage < 2
Debugging expressions: Use the policy logs to debug both complex and simple policies.
Routing by time range, day of the week or date range
Use predefined templates to create date-based or time-based routing policies.
Add the required template to the editor.
Update the template to create your rule.
The time range template allows you to create policies that can route conversations by time and days of the week. The template takes inputs in the following format:
isTimeRange('Start time in hh:mm:ss', 'End time in hh:mm:ss', 'Time Zone', ['Day1', 'Day2', …])
You can create time-based routing policies in the following ways:
|During work hours in Australia||isTimeRange('09:00:00', '18:00:00', 'Australia/Sydney')|
|All day every Saturday and Sunday in New York||isTimeRange('00:00:00', '23:59:59', 'America/New_York', ['SAT', 'SUN'])|
|After hours on weekdays in Los Angeles||not isTimeRange('09:00:00', '18:00:00', 'America/Los_Angeles', ['MON','TUE','WED', 'THU','FRI'])
not isTimeRange('00:00:00', '23:59:59', 'America/Los_Angeles', ['SAT','SUN'])
The date range template allows you to create policies that can route conversations by date and days of the week.The template takes inputs in the following format:
isDateRange('Start Date in mm/dd/yy', 'End Date in mm/dd/yy, 'Time Zone', ['Day1', 'Day2', …])
You can create time-based routing policies in the following ways:
|Every day between September 1st and 15th in Australia||isDateRange('09/01/21', '09/15/21', 'Australia/Sydney')|
|All weekends in New York in the month of September||isDateRange('09/01/21', '09/30/21', 'America/New_York', ['SAT', 'SUN'])|
|All weekdays in the 4th quarter||isDateRange('10/01/2021', “12/31/2021', 'America/New_York', ['MON','TUE','WED', 'THU','FRI'])|
Combining date and time
Combine date and time to create policies:
|During work hours on weekdays in the month of September in New York but excluding the Labor Day holiday||isDateRange('09/01/21', '09/30/21', ‘America/New_York')
isTimeRange('09:00:00', '18:00:00', '‘America/New_York', ['MON','TUE','WED', 'THU','FRI'] )
isDateRange('09/04/21', '09/04/21', ‘America/New_York')
Use date and time with other attributes
|VIP customers during work hours on weekdays in the month of September in New York||orchestrator.phoneNumber in custom.VipList
and isDateRange('09/01/21', '09/30/21', ‘America/New_York')
and isTimeRange('09:00:00', '18:00:00', '‘America/New_York', ['MON','TUE','WED', 'THU','FRI'] ))
Use the right formats for days and time zones
Days: Days provided should match ‘MON’, ‘TUE’, ‘WED’, ‘THU’, ‘FRI’, ‘SAT’,’ SUN’
Time zones: Universal Time Zone database name should be used. Examples: America/New_York, America/Nipigon, America/Nome, America/Noronha, America/North_Dakota/Beulah, Asia/Saigon, Australia/Adelaide, Australia/Sydney, Australia/Tasmania, Australia/Victoria, etc.
Use policy logs to debug your policies.
Nesting multiple expressions for more complex conditions
Write nested statements to combine multiple logical conditions to arrive at routing decisions. Enclose every block with brackets “( )”.
Combine other products to power more complex routing use cases
The section dives deep into two, different advanced routing configurations.
Dynamic skill fall over routing
Scenario: Routing to a different skill if the primary skill is experiencing a high load. The jump from one skill to another should cascade until a skill has available agent capacity. Example: If 80% of agents in a particular skill are busy then fall over to a different skill.
Solution: This can be solved using a combination of Dynamic Routing, Context Service, LivePerson Functions and the Queue Health API. A LivePerson Function can be configured to run every 2-5 mins and update the “average wait time” for every skill into the Context service. Dynamic routing policies can then be configured to check average wait time for every skill and fall over to a different skill as appropriate.
The above solution can be deployed relatively quickly. However, it does require a few hours of coding effort for the LivePerson function. This method cannot be used to check queue health in real time for every conversation, but we believe that checking the queue every 2-5 mins will help solve this specific use case. Most conversations live much beyond 2-5 mins and queue stats are unlikely to change significantly during this time frame.
Dynamic queue prioritization
Scenario: Recognize when a high value customer (HVC) starts a conversation and immediately escalate them to specific agents without any wait-time or queuing delays. The prioritization should vary across skills. Example if a customer is in the HVC skill their conversation can have a normal priority but on being moved to a different skill, the conversation should be placed top of the line.
Solution: This can be solved using SDE, Dynamic Routing, Conversation Builder, Context Service and LivePerson’s internal queue prioritization application. LivePerson’s queue prioritization tool can host custom business rules to boost queue priority for Conversations that have certain attributes. For this use-case LivePerson will add a new rule to boost priority of conversations that have value "VIP” for “Customer Type SDE”. (SDEs can be used to capture one/more/multiple customer attributes).
While SDEs are captured directly for conversations originating from web-engagements, they have to be manually set when conversations originate on other channels such as whatsapp or mobile apps. For this use case a routing bot will check for the customers’s VIP status through a CRM (or relevant application) and then update the SDE value for VIP customers. LivePersons Queue prioritization updates queue priority in real time whenever the SDE is updated. Next SDE based routing policies can be configured on Dynamic Routing to route VIP customers to the appropriate skill.
The above are just two out of several possible advanced routing scenarios. Please reach out to your account representative if you need help with these use cases, or you need advice on any other advanced routing use case.