Conversation Builder quick start
Create a "Hello World" bot using Conversation Builder.
Step 1: Log in and access 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.
Step 2: Create a "Hello World" bot
- 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!
Step 3: Customize the interaction
Add a new pattern
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.
Preview the bot again
- 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!"
Bots can also support small talk (chitchat). In your automation solution, consider adding support for this. It offers your consumers a more human-like experience.
Step 4: Connect your bot to the Conversational Cloud
Create the skill and user agent
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.
Assign the bot skill to an engagement
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.
Deploy the bot to the Conversational Cloud
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.
Test your bot
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.
Step 5: Expand the capabilities of your bot
- 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.
Additional quick start guides
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.