Home > How to Configure Guide Bot


(Last Updated On: October 19, 2020)

This article explains how to configure a Guide Bot.

The Guide Bot is an easy way to create complex routing flows to direct visitors to specific widgets and agents while displaying information. Using our Multi-Tier Step system, you can create a tree of questions and ensure visitors are routed to the best-suited agent. You can also qualify leads by asking questions and directing them to the right person or team. The Guide Bot is used to organically converse with the visitor, offering a better user experience. For an example of how to set the Guide Bot in a way to aid your sales workflow, check out our tailored recipe here.

Configure your first Guide Bot

To configure the Guide Bot, follow these instructions:

  • Choose a widget where you want to set up a Guide Bot
  • Navigate to Settings – Agent settings
  • Click the Add Guide Bot button.

A new window will appear.

From here, you can either choose to create a Guide Bot from scratch, or to select a template. Templates are out of the box solutions. To read more about templates, check out our documentation here. Below, we will discuss creating a Guide Bot from scratch. Once you select “Start from scratch”, but Guide Bot configuration page will open, as below:

The right side of this screen allows you to configure Chatbot dialog. Above the field input, it lets you set your bot name and image, and shows a preview of the bot dialog as you construct it. As you add options on the right-hand side, you will see buttons appear on the left-hand side.

On the left-hand side, you can navigate between a preview and a live test. The preview shows you an example workflow and gives you an idea of how the steps will look. The live test allows you to test your workflow as a visitor:

You will notice that one step is added by default, but you can add additional steps by clicking on “Add Step” underneath:

You can also add a message which is displayed to visitors when no agent in the routed widget is available:

The text contained within the squared brackets can be clicked by the visitor to send an offline request to your team.

Internal Name

You can give your Guide Bot a unique internal name. This name will appear in various places in your administrative settings, but will not be displayed to your visitors. This name allows you to name each Chatbot descriptively (e.g., SalesBot #1). It is recommended to use this to explain the primary function of the bot to aid in reporting.


Alias works similarly to chat agent alias names – it is the name that visitors will see when they engage with the bot. You may want to give the bot a snappy name for branding purposes. Also – you may want to have all your bots use the same alias so that visitors don’t notice the transition between bots and it feels more natural to them.

Guidebot Image

You can provide a unique bot image for your bot. Simply upload a JPG or PNG image of your choosing. We strongly recommend using a bot image rather than a person – people will know it is a bot and typically don’t appreciate fakery.

Creating Your Dialog

Prompt / Question

On the right side of the bot configuration screen, you can edit the initial prompt or question that the bot will ask your visitor. This can be anything you like, but we recommend keeping it short and clear. For example, you might prompt, “Hi there! What can I help you find today?”

NEW: You can now populate Guide Bot messages and buttons with JavaScript variables. Read more here.

Dialog Options

Below the prompt, you will set up the “button” answers that your visitors can choose, as well as the actions the bot will take when the visitor clicks a button. You can add, edit, or remove choices as needed. Each choice is structured as an “IF – THEN – MESSAGE” set:

  • IF the user picks this answer
  • THEN take this action
  • WITH MESSAGE to display during the transition.

You can add up to 10 buttons options, but be aware of the size of the chatbox and make sure they all fit in it.  Otherwise, visitors will need to scroll and may not see all options. We recommend keeping things simple and only using 2-5 choices for most applications.

If you are using the Facebook Messenger channel, please be aware that buttons need to be shorter than 20 characters.

THEN action options include:

  • Transfer to widget : This will transfer the chat to the widget you choose under the Select widget option, and direct it to the team on that widget. The chat will be assigned based on your rules for that widget. Make sure that widget is configured to be able to receive chat transfers from under Settings – Agent settings.
  • Route to tag : If routing by tag is enabled, you will be able to route the chat to agents in the current widget who have that tag. Bots can also have tags, allowing you to route to a specific secondary bot.
  • Jump to Step : Will prompt the bot to move to the next step in the conversational flow.
  • End the chat : This will end the chat (it can be used if an option is not available)


On the following example, we have 3 buttons.

  • I have an issue with a product I bought” – when a visitor clicks on this button, they will be transferred to a widget, the widget in question will be “Support”. A message will show saying “Our support team will help you with that”
  • I have a question about one of your products” – when a visitor clicks on this button, the second step will be prompted.
  • I am looking for a job in your company” – This will end the chat, with the message “Please check our careers page”

If the visitor clicks on “I have a question about one of your products”, they will be shown the second step in the flow:

This second step asks “What level of account do you have” and it has two options.

  • Standard” – This will route the chat to any agent in that particular widget with the tag “agent”. You can read more about tags here.
  • Enterprise” – This will route the visitor to a different widget called “Enterprise Collection”.

On the top left, under the Bot’s name, you will also be able to assign tags to this specific bot, ( the same as you would to an agent) so that other bots can assign chats to this bot. You may also assign chat via routing by tag. If the Bot transfers the chat to a widget, and the agent does not respond, the agent reassignment rules would still be triggered.

Add labels

Did you know you can also add labels to the bot, for example when transferring a chat to a widget, you can add a label so you can report on it later on. You can simply add the labels on the message during the transfer (but only the label, no messaging) : \destinationwidget = Support

Remember to Enable the bot on the left-hand side to activate it!

Proactive chat

When creating a proactive trigger for proactive chat, you can also assign that chat to the Guide bot, by clicking the checkbox “Enable special assignment settings”, and selecting the Guide bot from the dropdown.

Multi-Tier routing

You can create complex routing strategies by using our Multi-Tier routing system. To create a new step, firstly change the Then condition to “Jump to Step” as shown below:

This will open up a completely new step for you to ask an additional question. This step will be prompted if the visitor clicks that specific option.

This can create a conversational flow. Each option can trigger a different question to be asked. Up to 100 steps can be added to one Guide Bot, but for ease of use, it is best to keep it concise.

When working with steps, our recommendation would be to have a think first, and perhaps to even draw a diagram on how you want your visitor experience to be. Once you have that, creating the flow will be a piece of cake!

What about the Facebook integration or SMS to chat?

The Guide bot can also be integrated with those Channels, and the buttons will show there.

Did you find this article helpful?

Not HelpfulNeeds WorkSo-soHelpfulVery Helpful (2 votes, average: 5.00 out of 5)
Loading ... Loading ...

Published January 20, 2020