This is a tutorial series that's cumulative in nature. To start from the beginning, start here.

In this tutorial, you walk through how to link your bot to Conversational Cloud.

Watch the video

Before completing the tutorial, watch the video below to get a high-level understanding of the process involved:

Step 11: Create a bot user

In this step, you create a new user agent and skill for the bot, create a new engagement for web messaging, and connect the bot agent to the engagement.

1. Open the menu on the left side of the page, and select Manage > Users & Skills.

   

2. On the Users tab, click + Add user in the lower-left corner.

3. Fill out the Add user form with the following user details:

   • User type: Bot
   • Login name: Getting Started Bot
   • Email: Your email address
   • Nickname: Getting Started Bot

   The nickname is displayed to the consumer in the engagement window.

   • Name: Getting Started Bot

   The name is displayed elsewhere in Conversational Cloud, for example, in the Agent Workspace.

   • Choose login method: API key
   • Api key: Generate API key
   • Assignment → Assign Profile: Agent
   • Skills: Bot

   Typically, a skill's name is something like "Sales" or "Support." But for the purpose of this tutorial that involves a generic Getting Started bot, we'll give it a basic name of "Bot."

   By typing in the skill name Bot, you can create a new skill named Bot on the fly.

   

4. Click Save.

Step 12: Create an engagement

1. Open the menu on the left side of the page, and select Engage > Campaign Builder.

   

2. Click + Add Campaign in the lower-left corner.

3. On the page that appears, specify the following:

   • Campaign name: Enter "Getting Started."
   • Campaign goal: Click + Add goal. Select "Interact with consumers." And click Done.
   • Engagement: Click + Add engagement. For the engagement source, select "Web." In the gallery that appears next, select a messaging template, and click Next. In the resulting Engagement Settings, select "Messaging" for the Conversation type. For Routing, select "Specific skill," and then select the "Bot" skill.

   

4. Click Next.
5. In the Engagement Studio, click Next.
6. In the Engagement Window Library, click Done.

7. Click Publish in the upper-right corner. Then click Publish again to confirm the action.

   

Step 13: Add the agent connector

1. Open the menu on the left side of the page, and select Automate > Conversation Builder to navigate back to Conversation Builder.
2. Open the Getting Started Bot.
3. Click Agent Connectors in the menu bar in the upper-left corner.
4. Click Add Agent Connector in the upper-right corner.

5. In the Add Agent Connector dialog box, specify the following based on the bot user you created.

   • Agent User ID: Getting Started Bot
   • Role: Agent
   • Conversation Type: Messaging
   • Deploy to: Demo

   

6. Click Save.

7. As a result, you will see a row on the Agent Connectors page listing your new bot agent. Select the Start button on that row to start the agent connector. This fully deploys the bot.

   

   It might take a few minutes for the connection to be established.

   To view more details about the connector, move your mouse over the "i" icon beside Details.

   LivePerson recommends that, when you connect your bot to Conversational Cloud in a production environment, you deploy a minimum of two Conversational Cloud agent connectors for a single bot. This is so the second can serve to support failover if the first goes down.
   
   Additionally, you might need more based on traffic. Due to an enforced limit, a single bot agent connector can handle a maximum of 999 concurrent conversations. If this is exceeded, the conversations in the overflow aren't assigned to the bot agent because it's at capacity. Given these constraints, if the bot is handling, for example, 2,000 concurrent conversations, you’ll need 3 agent connectors.

Step 14: Test the deployment

1. In a browser, navigate to the Messaging test page.

   

2. Enter your account number, and click Show Window.

3. After a moment, you will see a Messaging "call to action," which corresponds to what you selected in the Campaign Builder. Click the Messaging call to action.

   Is the Messaging call to action not showing up? Try using an incognito window in the browser.

4. Start the bot by entering ‘hi’ or ‘hello.’

5. Test the bot's functionality as you would in Conversation Builder's Preview.

   

   Congratulations! You’ve successfully deployed your automation to a demo environment.

   Learn more about deployment.

What's next?

Continue on to the next tutorial in the series.