This topic assumes that you are familiar with Intent Manager.

You can create policies to recognize a consumer's intent from their utterance and transfer to the appropriate agent or skill. Routing by intent is very useful when agents or bots are organized by functional departments.


  • When a VIP consumer says, “I want to upgrade my service,” they should be transferred to the Upgrade Service skill that includes all upgrade specialists or bots.
  • When a member says, “I have an outage,” they should be escalated to an Outage specialist.

Please Note: The technique is very useful for advanced routing use cases, such as scenarios that involve a combination of intent recognition, contextual information and/or transferring to both humans and bots.

If all your operations are contained within LivePerson Conversation Builder bots, and you already have different bots for specific intents, please use the direct approach of bot collaboration.

Prerequisite steps


There are two ways to accomplish intent-based routing:

  • If you have a limited number of intents, use the dialog starter approach.
  • If you have many intents and corresponding skills, enable intent routing in the Conversation Orchestrator bot.

Some users might be using older approaches to routing by intents. Typically, this involves writing custom JavaScript to store context variables and call the Next Actions API. However, LivePerson recommends that you use the approaches discussed in this topic; they leverage Conversation Builder's Dynamic Routing interaction, which reduces the need to write custom code. Still, for information to aid in troubleshooting older approaches, you can access an older version of this topic.

Routing by intent using the dialog starter approach

When an intent triggers a dialog starter, the intent name is automatically saved to the default “orchestrator” namespace in the Context Service in a variable named “intent”. This approach is useful when using a small number of intents (5-10).

  1. Create a new dialog in your Conversation Builder bot.

  2. In the newly created dialog starter, select the + Intent option to add a domain and intent to trigger this dialog.

  3. Set the Next Action to the Dynamic Routing interaction.

    The dialog starter that's mapped to an intent named ‘book flight’

  4. Create intent-based routing policies. For more on this, see the section at the end of this topic.

Enabling intent routing in the Dynamic Routing bot

When working with larger domains, assigning individual dialogs to each intent can be difficult to scale. By using the Conversation Orchestrator bot template, bot developers can manually call the analyze intent API and save the intent name to the default namespace, enabling routing to any intent-based skill in the account.

This approach is powered by an API provided by the Dynamic Routing Bot template. This API is not suitable for use with legacy versions of LivePerson’s NLU engine. Please upgrade to the current NLU domain offering if using this approach.

  1. Create the Dynamic Routing bot, and open Global Functions.

    Create a new bot using the Dynamic Routing Bot by following the steps in the Getting Started topic. Then open Global Functions, and change two configurations (botAppKey and domainId) as highlighted in the next, few steps.

  2. Retrieve the botAppKey.

    Retrieve the botAppKey value from a bot user agent. This can be found in the User Management section of the Conversational Cloud. Copy this value.

    The App key field in the User Management section of Conversational Cloud

  3. Retrieve the intent domain ID.

    Retrieve the Domain ID for your intent domain. You can find this in the Domain Settings for your domain in Intent Manager. Copy this value.

    The Domain Settings option for a given domain that's listed on the dashboard in Intent Manager

    The Domain ID field in the settings for a given domain

  4. Update configurations in the Global Functions.

    Enter the botAppKey and domainId values into their associated variables within the Global Functions editor of your bot.

    The lines of code in the bot's global functions where you need to enter the botAppKey and domainID values

  5. Enable the intent dialogs in the bot.

    Delete the COLLECT_PHONE_NUMBER interaction. Enable both the ASK_INTENT and getIntent_API interactions using the interaction settings for each. Make sure the Dynamic Routing interaction is directly below the getIntent_API as shown below.

    Enabling ASK_INTENT and getIntent_API interactions:

    The dialog flow, illustrating how the Dynamic Routing interaction is below the getIntent_API interaction

    To enable interactions, go to the Interaction Settings, and enable the toggle:

    The Interaction Enabled setting in the Basic settings of a given interaction

  6. Create intent-based routing policies. For help with this, see the next section.

Create intent-based routing policies

The policy creation flow is identical for both approaches:

  • Dialog starter
  • Enabling intent routing
  1. Navigate to Manage Policies.

    Use the Manage routing policies link in the Dynamic Routing interaction to navigate to Conversation Orchestrator.

    The Manage routing policies link that's directly on the face of the Dynamic Routing interaction

  2. Create your policy.

    Create a new policy by selecting Add Policy. Give the new policy a name. In the conditions editor, select “orchestrator.intent” from the dropdown, and set it equal to the relevant intent name.

  3. Configure your policy.

    In the actions editor, select "Transfer to skill" from the left-hand dropdown and the relevant skill from the right-hand dropdown. Ensure that agents are assigned to the book_flight skill.

    The configured Book flight policy

  4. Enable your policy.

    Once saved, toggle the switch for the policy in the policy list to enable the policy.

    The enabled Book flight policy

  5. Test your policy.

    You can test your setup on the web client emulator.

    Alternatively, to test, you can deploy the bot and connect it to a campaign that’s linked to the production/staging channel of your choice.

    Follow these steps once you have configured your testing setup:

    The conversation flow to follow

    The message routing flow is identical for both approaches (Dialog Starter and Enabling Intent Routing) because we have used the same intent and the same policy in our demonstration.

    Start by saying “Hi.”

    When prompted by the routing bot, provide the phone number 1111. This is when the Dynamic Routing interaction evaluates all your policies to make the routing decision.

    The conversation will be routed to the skill SeattleEmployeeSkill. A specific agent within the skill will be picked.

    For this example, it will be routed to Agent Bob if you have configured Agent Bob to be the only user who maps to SeattleEmployeeSkill.