What is a Policy

A policy in Maven is comprised of a condition, action, and exception, represented as a JSON block.

To create a policy, start with the consumer journey you want to achieve. For example, you may want to achieve the following outcome: “Route a group of intents (e.g. order inquiry, cancellation, scheduling) to a general order skill, unless customer is a VIP, then send them to their dedicated advisor.”

Next, identify which attributes you may need to build this policy. For example, you may need Intents, whether the customer is a VIP, and the customers' dedicated advisors. These attributes can be created, accessed, or managed in the Maven Context Warehouse.


Conditions can be applied to each Attribute in Context Warehouse. A condition block may have multiple conditions. They are represented in JSON as follows.

Example 1: Use a list to check if an email address is in that list.

"conditions": [
      "property": "customerinfo.email",
      "type": "IS_IN",
      "value": "{{custom.vipList}}"

Example 2: Check if customer is returning within 24 hours.

"conditions": [
      "property": "conversation.minutesSincePreviousMessage",
      "type": "LESS_THAN_OR_EQUAL",
      "value": 1440

Conditions can compare both named attributes as well as constant values:

  1. Attributes: Attributes can be used with their qualified names, for example custom.vipList above
  2. Constants: use the value directly with a number or string, for example time in minutes 1440 in above

Maven will support the following conditional operators:

  • IS_IN


Actions define what to do next if the conditions are valid. An action block may have multiple actions. They are represented in JSON as follows.

Example: Route a conversation to a specific VIP skill.

"actions": [
      "type": "TRANSFER_TO_SKILL",
      "payload": {
        "skillId": "{{custom.vipSkill}}"

Similar to conditions an action such as transferring to a skill can use either a variable or a constant value.

Get SkillIds from LiveEngage

To route to skills, you will need the SkillIds used by LiveEngage. To retrieve all the skill IDs:

  1. Login to LiveEngage and then go to Users tab and then Skills
  2. Then click on Actions and then export all

  3. Save the zip file and then open Skills.csv
  4. All Skill IDs with associated skill name should be in this file. Copy and paste the skill IDs into your policy to transfer to a skill.

The following list of actions will be supported:



Exceptions define conditions and actions when unusual situations may occur. For example, an outage. Exception block takes precedence over the conditions/actions block at the root level. Exceptions are also provided as condition-action blocks.

Example: Send a VIP customer to a specific skill

"exception": {
  "conditions": [
      "property": "custom.vipList",
      "type": "EQUAL",
      "value": "True"
  "actions": [
      "type": "TRANSFER_TO_SKILL",
      "payload": {
        "skillId": "<vipSkill>"

Create and Manage Policies

Create a new policy

  1. Log in to Maven and navigate to AI Powered Routing/Intent & Context Policies

  2. Click on the button "New"

  3. Edit the policy in JSON format using the inline text editor in the experience. You may also use your preferred JSON editor and then copy and paste the JSON.

  4. Click Save button to save the new policy configuration

Enable or disable a policy

  1. Each policy can be enabled or disabled. A policy will not be executed by Maven if it is disabled.

  2. Only policies that are enabled are evaluated by Maven to make a routing decision

  3. Use the on/off toggle switch to enable or disable a policy

Set the policy order

Maven evaluates policies in the order they are created and shown in the user experience. Maven will execute the first policy that satisfies all the conditions. To change the order of a policy

  1. Select the policy

  2. And then click the Up or Down buttons to move the policy in the list

Using Policies in Conversations

Once you have created some policies there are two ways of using the policies to route conversations:

  1. Setup Maven in LivePerson to send your conversations to the Maven bot. The Maven bot will evaluate all the policies and then route them to the optimal agent, skill, or bot
  2. Use Maven with your bot using the AskMaven and Context Warehouse APIs. Your bot will handle branded greetings, intents, and other other attributes and then use AskMaven to get the policy decision.