Conversation Builder quick start
Create a "Hello World" bot using Conversation Builder.
- Log into the Conversational Cloud.
- On the left sidebar, click the bot icon ("Conversational AI").
- In the Conversational AI dashboard, click Conversation Builder.
- Click New Bot in the upper-right corner.
- Select the Custom Bot template.
- In the dialog that appears, specify the following:
- Name: Enter a unique name, such as "Hello World."
- Description: Enter a meaningful description.
- Bot Language: Select a language.
- Bot Group: Leave this unset.
- Click Create Bot. Since you selected the Custom Bot template, by default this creates a bot with a “Welcome” dialog that matches and responds to simple forms (patterns) of “hello.” The bot also has a Fallback dialog with some fallback text.
- In the Dialogs panel on the left, click 1 Welcome and 2 Fallback to open and examine both dialogs.
- Preview the bot:
- Click Preview in the upper-right corner of the screen to open the Preview window.
- Enter “hello” and click Send. You will see the response, “Hi there! Thanks for coming!”
Congratulations! You’ve just created your first bot!
1 - If the Welcome dialog isn't already open, open it by clicking 1 Welcome in the Dialogs panel on the left.
2 - Select the first interaction (a Dialog Starter interaction), and click the pattern that's displayed directly on the tile.
3 - In the Interaction Settings dialog, under Patterns, enter "aloha," and press Enter.
4 - Click Save.
5 - Select the second interaction, and change the text statement from "Hi there!" to "Hello World!"
6 - Click the interaction's Save button.
- Open the Preview window like you did before, and start a new session by clicking Reset in the upper-right corner.
- Enter “aloha.” You will see that the bot responds to this new greeting with "Hello World!"
In this step, you create a user agent for the bot. The user agent will have an assigned skill, which you'll create first.
1 - On the left sidebar in the Conversational Cloud, click the user icon ("Manage users and skills").
2 - Click the Skills tab, and then click Add skill at the bottom of the page.
3 - On the Add Skill page, specify the following:
- Name: Enter "BotSkill."
- Description: Enter "Bot skill."
4 - Click Save. The BotSkill skill will be the default skill connected to the bot agent. Next, you create a user agent for the bot.
5 - Click the Users tab, and then click the Add user button at the bottom of the page.
6 - On the Add User page, specify the following:
- User type: Set this to "Bot." If you don't see this field, contact your LivePerson representative to enable this for you.
- Login name: Enter any value, e.g., "myBotUser."
- Email: Enter any value, such as your own email address.
- Nickname: Enter any value, e.g., "Bot User."
- Name: Enter any value, e.g., "Bot User."
- Choose login method: Select "API key," and then, for Api key, select "Generate API key" from the dropdown list. This fills in the keys automatically. If you don't see the "API key" option, contact your LivePerson representative to enable this for you.
- Assignment: Click this field, and select "Agent" from the list that appears.
- Max no. live chats: Select "Unlimited."
- Skills: Click this field, and select "BotSkill" from the list that appears. This is the default bot skill. Do NOT add additional skills.
7 - Click Save.
You will test the connection with a standard Messaging engagement, so now you create a campaign and an engagement that routes to the new BotSkill skill.
1 - Click the Manage campaigns and engagements icon on the left toolbar.
2 - Click the Add campaign button at the bottom of the page.
3 - On the page that appears, specify the following:
- Campaign name: Enter "My Bot Test."
- Campaign goal: Click + Add goal, select "Interact with consumers" on the page that appears, 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 Engagement Settings that appear next, select "Messaging" for the Conversation type. For Routing, select "Specific skill," and then select the "BotSkill" 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, and then click Publish again to confirm the action.
Next, you use Conversation Builder to connect your bot to the bot agent you just created and get the connection running in the Demo environment.
1 - Return to Conversation Builder by clicking the Conversational AI icon on the toolbar on the left.
2 - Open your Hello Word bot.
3 - Click Agent Connectors on 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: Select “myBotUser.” This is the login name you used for the user agent.
- Role: Select "Agent."
- Conversation Type: Select "Messaging."
- Deploy to: Select "Demo." The Demo environment is a testing environment.
6 - Click Save.
7 - Click the Start button to start the agent connector. This fully deploys the bot. It might take a few minutes for the connection to be established.
1 - In a browser, navigate to this test page.
2 - Enter your account number, and click Show Window.
3 - Click the Messaging call to action. This connects you with the bot in the BotSkill skill.
4 - Test the bot. In the Messaging window, enter a greeting (such as "aloha"), and press Enter.
- Extended Getting Started tutorial: Expand the capabilities of your bot using intents and integrations. Learn how to transfer a bot conversation to a live agent.
- Bot templates: Reference bots for common use cases, such as Routing, FAQ, Lead Generation and Order Status.
- Intent Builder: Learn about intents, how to build new ones and how to incorporate them into your bot.
- Bot Analytics: Visualize and tune the performance of your bot with usage and intent matching metrics.
Check out our Developer Center for more in-depth documentation. Please share your documentation feedback with us using the feedback button. We'd be happy to hear from you.