From Bright Pattern Documentation
Jump to: navigation, search
 
(4 intermediate revisions by 2 users not shown)
Line 3: Line 3:
 
[[File:Ask-a-Bot-Block-53.PNG|225px|Ask a Bot scenario block]]
 
[[File:Ask-a-Bot-Block-53.PNG|225px|Ask a Bot scenario block]]
  
Scenarios use the Ask a Bot block to submit the most recent message received from the user to the bot, and deliver suggestions from the bot to the customer. You can think of this block as the facilitator of bot-automated conversations. This block passes messages between the user and the bot.
+
Ask a Bot allows your [[5.3:contact-center-administrator-guide/IntegrationAccounts/BotChatSuggestionsEngine |
 +
integrated bot/chat suggestions engine]] to reply automatically to customers as well as provide suggestions to agents during active chat interactions.
 +
 
 +
Scenarios use the Ask a Bot block to submit the most recent message received from the user to the bot, and deliver suggestions from the bot to the customer. You can think of this block as the facilitator of bot-automated conversations; this block passes messages between the user and the bot.
 +
 
 +
 
 +
[[File:Ask-a-Bot-Chat-Suggestions-50.PNG|450px|thumb|center|Ask a Bot can provide chat suggestions to agents in Agent Desktop]]
 +
 
 +
 
 +
Ask a Bot may be used with the [[scenario-builder-reference-guide/Self-ServiceProvided|Self-Service Provided]] block, allowing customers to complete self-service tasks without the help of an agent. Additionally, when an agent is included in a chat scenario, Agent Desktop uses content of the suggestions engine to show one or more suggestions. If an agent clicks a suggestion, the text is copied to the chat response field.
 +
 
 +
Note that the [[scenario-builder-reference-guide/ChatBotSelectAccount|Chat Bot Select Account]] block will override the Ask a Bot block if both blocks are in the same scenario.
  
 
== Settings ==
 
== Settings ==
[[File:Ask-a-Bot-Settings-53.PNG|650px|thumbnail|center|Ask a Bot scenario block settings]]
+
[[File:Ask-a-Bot-Properties-5399.PNG|650px|thumbnail|center|Ask a Bot scenario block settings]]
  
  
Line 17: Line 28:
 
If building a scenario that also uses the [[Scenario-builder-reference-guide/PlayListen |  Play-Listen]] block, you can enter variable ''$(item.transcript) in this Message field.
 
If building a scenario that also uses the [[Scenario-builder-reference-guide/PlayListen |  Play-Listen]] block, you can enter variable ''$(item.transcript) in this Message field.
  
=== Suggestions ===
+
=== Responses ===
Variable receiving array of suggested responses (data)
+
The variable receiving array of suggested responses (data).
  
=== Response ===
+
=== Raw response ===
The variable (string) that receives the raw bot suggested response. For example, ''raw_response''.
+
The variable (string) (e.g., ''raw_response'') that receives the raw bot response (i.e., the raw JSON answer from the bot engine before being parsed by the Bright Pattern system.
  
 
=== Timeout after, sec ===
 
=== Timeout after, sec ===
The number of seconds to wait before the ''Timeout'' conditional exit is taken.
+
The number of seconds to wait before the ''Timeout'' conditional exit is taken. This field is required.
  
  
Line 31: Line 42:
  
 
Here's a closer look at why these exits may be taken:
 
Here's a closer look at why these exits may be taken:
* '''Failed''' - Client Web Server is unavailable
+
* '''Failed''' - System error
  
 
* '''Timeout''' - The timeout is reached but there is no response
 
* '''Timeout''' - The timeout is reached but there is no response

Latest revision as of 23:59, 5 August 2020

• 5.3 • 5.8

Ask a Bot

Ask a Bot scenario block

Ask a Bot allows your integrated bot/chat suggestions engine to reply automatically to customers as well as provide suggestions to agents during active chat interactions.

Scenarios use the Ask a Bot block to submit the most recent message received from the user to the bot, and deliver suggestions from the bot to the customer. You can think of this block as the facilitator of bot-automated conversations; this block passes messages between the user and the bot.


Ask a Bot can provide chat suggestions to agents in Agent Desktop


Ask a Bot may be used with the Self-Service Provided block, allowing customers to complete self-service tasks without the help of an agent. Additionally, when an agent is included in a chat scenario, Agent Desktop uses content of the suggestions engine to show one or more suggestions. If an agent clicks a suggestion, the text is copied to the chat response field.

Note that the Chat Bot Select Account block will override the Ask a Bot block if both blocks are in the same scenario.

Settings

Ask a Bot scenario block settings


Title text

The name of the scenario block (any).

Message

The variable that gets the text of the last received message: $(item.message)

If building a scenario that also uses the Play-Listen block, you can enter variable $(item.transcript) in this Message field.

Responses

The variable receiving array of suggested responses (data).

Raw response

The variable (string) (e.g., raw_response) that receives the raw bot response (i.e., the raw JSON answer from the bot engine before being parsed by the Bright Pattern system.

Timeout after, sec

The number of seconds to wait before the Timeout conditional exit is taken. This field is required.


Conditional Exits

This block has a default exit and three conditional (i.e., "error") exits: Timeout, Failed, and No Data.

Here's a closer look at why these exits may be taken:

  • Failed - System error
  • Timeout - The timeout is reached but there is no response
  • No Data - There are no bot suggestions (i.e., data)

For each of the conditional exits, the scenario will send a message and then connect to the agent.


< Previous | Next >