Configure bot settings

To configure bot settings

  1. Open the bot, and click the ellipsis icon ( ) in the upper-right corner.
  2. Select Bot Settings from the menu that appears.
  3. Click More Settings to display all the settings.
  4. Configure the settings as needed, and click Save.

Bot settings include:

  • Name: Enter a name that’s concise and clear. Make sure abbreviations can be understood, and consider adding a prefix or suffix to indicate the environment (Dev, Prod, etc.) or language (En, Sp, Fr, etc.) if applicable. When you import a bot, by default, a date and time stamp is appended to the bot name; consider removing this because dates quickly become obsolete.

  • Description: Enter a description that’s meaningful to you and others. Consider including language that identifies the bot's goal and key behaviors.

  • Bot Type: Read-only. This is always Consumer Facing Bot.

  • Bot Language: Read-only. This setting determines the language-specific model for LivePerson NLU; it also supports the proper rendering of left-to-right and right-to-left languages. You specify the bot language when you create the bot, and it can’t be changed afterward.

  • Bot Template: Read-only. To facilitate the rapid creation of bots, all bots are based on templates. The default template is Basic, which uses English and includes just a Welcome dialog. You select the template when you create the bot, and it can’t be changed afterward.

  • Bot Group: Optionally select the bot group for the bot. A bot can be a member of exactly one group.

  • Bot ID: Read-only. This is a unique identifier that’s generated by the system. In some scenarios (for example, when using some APIs), you need to reference the bot ID. Here’s where you can find it.

  • Conversation Builder Platform Version: Read-only. This identifies the platform version of the bot. Typically, you don’t need this information, but here’s where you can find it if asked for it (for example, in a support scenario).

  • Entity: You can use this option to associate a domain with the bot. However, the NLU Assist tool provides you with help in associating domains with dialogs, so typically you don’t need to specify a domain here.

  • Bot Account: If you logged into Conversation Builder directly (i.e., not via single sign-on from LiveEngage) and you have access to multiple organizations within your LiveEngage account, you can use this setting to change the organization under which this bot exists. If you logged into Conversation Builder via single sign-on from LiveEngage, the organization you were using in LiveEngage is active and can't be changed, and nothing appears in this list.

  • Public: When you want other users in your LiveEngage account to be able to view and edit the bot, click the slider to On. The default value is Off.

  • Bot Environment: If desired, select the set of environment variables that you want to associate with the bot. Environment variables allow you to manage certain values and constants outside of the bot, and use of them when appropriate is considered a best practice.

  • Session Length: Select the length of the bot session, that is, how long the context of a conversation is maintained after the conversation becomes idle. If this is unset, the default of one hour is used. Be aware that there also exists a LivePerson conversation session; it is this setting, not the LivePerson setting, that determines the session length.

  • Log Transcripts: If you don’t want to log transcripts of conversations held via the bot, click the slider to Off. The default value is On. Transcripts can provide insights for a variety purposes. For example, they can inform the bot flow and help with tuning. However, some cases might prohibit transcript logging for privacy or other reasons.

    If you turn this off, metadata on the conversation is still logged, but the content of the conversation isn’t. If you keep this on, you can access the logged transcripts in the Bot Analytics application: Select the bot and then access the Transcripts page.

  • Shorten URLs: Enable this if you want to shorten the URLs sent in interactions, which can be desirable if you have lengthy web links. Disable this to keep URLs as they are. The default value is Disabled (Off). For more on URL shortening, see here.

    If you enable this setting, the shortened domain might need to be whitelisted. For more on whitelisting, see here.

    To support backwards compatibility, button interactions use URL shortening even though the new Shorten URLs setting is set initially to Off. To disable URL shortening for buttons, enable the setting, save the change, disable the setting, and then save the change again. From this point forward, button interactions will respect the value of the setting and work like all other interactions.

  • Default User-Friendly Response: This is an error response that gets sent to the user. Because you can supply the response, you can customize it in terms of substance and language (Spanish, Italian, etc.). If you enter a value here, it's used in two circumstances.

    First, when the bot encounters errors or throws exceptions, many times a default error response of, "Not able to understand your question. Can you please re-phrase it?" is sent to the user. Since this message is the same as the built-in, default Fallback message, it might confuse the user. To send a different response when errors occur, enter a value here. It won't replace or affect the Fallback message or a Fallback dialog, as they serve different purposes. Fallback handles when the user's utterance doesn't match a pattern or intent. In contrast, this error response is sent when the bot encounters an error or throws an exception.

    Second, during a LivePerson agent escalation, if the escalation fails four times, the escalation then stops, and a default failure response of, "Not able to transfer to Agent at this time. Please try later." is sent to the user. To send a different response, enter a value here.

    To enter a value, click the slider to activate it, enter the text in the field that appears, and save. There is no character limit.

Import a bot

You can add an bot by importing a bot JSON file that was previously exported. This is useful when you need to make a copy of a bot (just export and then import back into the same environment), or you need to copy or move a bot from one environment to another.

Before you import a bot from a different environment (that is, from one region or hosting platform to another), check whether the bot uses domains for intents and entities. If it does, you’ll need to export those domains too and import them into the target environment before importing the bot, keeping the domain names identical. If you don’t import the domains first, the associations inside the bot to the intents and entities will break during the bot import. If that happens, you’ll need to reassociate the intents and entities manually.

To import a bot

  1. If you logged into Conversation Builder directly (i.e., not via single sign-on from LiveEngage) and you have access to multiple organizations within your LiveEngage account, verify in the upper-right corner that the organization under which the bot should exist is displayed. If it isn’t displayed, select it from the Org Name dropdown list.

  2. In the Dashboard, click Import Bot in the upper-right corner.
  3. In the dialog box that appears, navigate to and select the JSON file, and click Open. The bot is imported and given a name that includes a date and time stamp.
  4. Change the name of the bot and any other configuration as needed. For help, see Configure bot settings above.

Export a bot

Export of a bot creates a JSON file.

You might need to export a bot for a few reasons:

  • You want to create a variation of the bot, so you plan to copy the bot by exporting it and then importing it back into the same environment.
  • You want to move or copy a bot to another environment, so you plan to export it and import it into a different environment.
  • You want an extra measure of back-up—above and beyond saving versions of bots that you can restore—so you plan to archive the JSON file for safekeeping.

In case 2 above—-moving or copying a bot to a different environment (that is, from one region or hosting platform to another)—-check whether the bot uses domains for intents and entities. If it does, you’ll need to export those domains too and import them into the target environment before importing the bot, keeping the domain names identical. If you don’t import the domains first, the associations inside the bot to the intents and entities will break during the bot import. If that happens, you’ll need to reassociate the intents and entities manually.

To export a bot

  1. Open the bot, and click the ellipsis icon ( ) in the upper-right corner.
  2. Select Bot Settings from the menu that appears.
  3. Click More Settings, and then click the Export Bot icon .
  4. Follow the browser prompts to access and save the JSON file to a location of your choice.

Delete a bot

Deleting a bot is a non-recoverable action, so be certain about doing so before taking this action.

If you want to delete a bot that is deployed, first stop the bot, un-deploy it, and remove any enterprise integrations that are running. This helps to ensure there are no adverse effects.

To delete a bot

  1. Open the bot, and click the ellipsis icon ( ) in the upper-right corner.
  2. Select Bot Settings from the menu that appears.
  3. Click More Settings, and then click the Delete Bot icon .
  4. In the confirmation dialog:
    1. If you want to delete all the logs and analytics data for the bot, select the checkbox.
    2. Click Proceed.