- Scenario Builder Reference Guide Introduction
- Scenario Builder OverviewExercises
- Scenario-Building ExercisesScenario Blocks Definitions
- Scenario BlocksReference
- Scenario Reference Material
- Add to Calling List
- Ask a Bot
- Attached Data
- AWS Lambda
- Bright Pattern Create Object
- Bright Pattern Delete Object
- Bright Pattern Search Object
- Bright Pattern Update Object
- Chat Bot Select Account
- Collect Digits
- Connect Call
- Connect Chat
- DB Execute
- Exception Handler
- Fetch URL
- Find Agent
- 1.1 Settings
- 1.1.1 Title text
- 1.1.2 Agent skills required
- 1.1.3 Overflow call handling starts at
- 1.1.4 HTML code
- 1.1.5 Initial Message
- 1.1.6 Periodic Message
- 1.1.7 Escape button
- 1.1.8 Keep call in queue
- 1.1.9 Virtual Queue option
- 1.1.10 Periodic reminder - repeat every
- 1.1.11 Other reminders
- 1.1.12 Keep playing hold music while ringing on agent
- 1.2 Conditional Exits
- 1.3 Prompts
- 1.1 Settings
- Get Agent State
- Get Next Record
- Get Statistics
- Get User Configuration
- Identify Contact
- Internal Message
- Microsoft Dynamics Create Object
- Microsoft Dynamics Delete Object
- Microsoft Dynamics Screen Pop
- Microsoft Dynamics Search Object
- Microsoft Dynamics Select Account
- Microsoft Dynamics Update Object
- Play Prompt
- Request Callback
- Request Input
- Request Skill or Service
- Retrieve Internal Record
- RightNow Create Object
- RightNow Screen Pop
- RightNow Search
- RightNow Select Account
- RightNow Update
- Salesforce.com Delete
- Salesforce.com Insert
- Salesforce.com Screenpop
- Salesforce.com Search
- Salesforce.com Select Account
- Salesforce.com Update
- Save Survey Response
- Search Directory
- Self-Service Provided
- Send Message
- ServiceNow Create Object
- ServiceNow Screen Pop
- ServiceNow Search
- ServiceNow Select Account
- ServiceNow Update Object
- Set Agent State
- Set Case
- Set Custom Reporting Field
- Set Disposition
- Set Priority
- Set Prompt Language
- Set Variable
- Start Another Scenario
- Stop Prompt
- Web Screen Pop
- Zendesk API Request
- Zendesk Create Object
- Zendesk Screen Pop
- Zendesk Search
- Zendesk Select Account
- Zendesk Update Object
In the Scenario Builder application, the Find Agent scenario block finds an agent qualified to handle a given interaction. When the agent becomes available, the block creates a variable called $(destination) and sets it to the agent’s phone number (for voice) or username (for chat). Note that Omni-Channel Routing settings may determine the frequency with which certain interaction types are routed to your agents.
For example, the scenario should proceed in the following way:
- The scenario collects data from a caller.
- Based on the collected data, the scenario determines the qualifications necessary to handle the call.
- The scenario uses the Find Agent block to find an agent with the necessary qualifications (e.g., Peter at extension 151).
- That agent’s extension is stored internally in the $(destination) variable. In this example, the variable is set to 151.
- The scenario uses the Connect Call block to distribute the call to the number stored in the $(destination) variable.
Note that the block properties will be different depending on whether it is used in a voice or a chat scenario.
Title text is the name of the instance of the block. Enter a name in the text field and click the Update button at the bottom of the Edit pane. The new name of the block appears in the flowchart.
Agent skills required
You can select the agent skills required for handling the interaction.
The agent selection rule is expressed as a sequence of escalation intervals with different agent selection criteria defined for each. The term "escalation" implies that each subsequent interval will normally have less stringent selection criteria, thus increasing the probability of finding an agent available to attend to the waiting interaction.
If there are multiple conditions specified in the escalation interval, ALL conditions must match for an agent to be considered. A set of conditions in each interval is independent from conditions in other intervals.
Any number of escalation intervals can be defined within the expression. The last interval can be finite or infinite (leave the end time empty to use an infinite interval). To specify an interval, first define its length. Then click add to define your agent selection condition for this interval, which are as follows.
- Skill from skill group – This condition matches the interaction to qualified agents according to skill requirements specified in the preceding Request Skill or Service blocks. This is the condition that is normally used for skill-based routing. You can define multiple skill groups within the same interval. A minimum acceptable skill level must be assigned to each skill group.
- Specific skill – This condition matches the interaction to qualified agents according to an explicitly specified skill. This option can be used instead of the option Skill from skill group in simple scenarios without IVR-based service/skill selection. You can define multiple skills within the same interval. A minimum acceptable skill level must be assigned to each skill group.
- Specific skill from variable – This condition matches the interaction to the skill in the specified variable. It can be used as a logical extension of the Specific agent option. If a specific agent does not become available within the first interval, the interaction can then be routed to a group of agents who share a particular property with that specific agent (e.g., work in the same office). Such a property can be represented by an auxiliary skill. You can obtain this skill and store it in the specified variable using the property Skill name of the Get User Configuration block. This option will ignore any skills requested by the interaction and any agents’ skills except the one identified by this variable.
- Region – This condition matches a customer's region to a user with the same region. If no region is found for the customer, the interaction will be routed to any user; if no user region is set, the user is matched to any interaction. Note that this condition may be combined with other conditions except with the Agent currently handling this customer condition.
- Specific agent – This condition matches the interaction to the specified agent (e.g., the agent who handled the previous interaction with the same customer). The variable’s value must be the agent’s global identifier in the system configuration (see property User ID of the Get User Configuration block). This option is available for the first interval only. If the specified agent is logged out, the next interval will be tried immediately. This option will ignore any of the skills requested by the interaction and any skills possessed by the specified agent.
- Agent currently handling this customer – This condition matches the agent currently handling the same customer in another type of interaction. For example, during a phone call with an agent, the customer sends an SMS message; the SMS is delivered to the same agent.
Overflow call handling starts at
This setting defines at which escalation interval the identified agent will be considered an overflow destination, unless his skills/levels match the skill/level requirements of the preceding escalation intervals.
HTML code defines the HTML page that the customer will use during the chat session. This setting applies to chat scenarios only.
For chat scenarios only (see image below), the initial message (i.e., first periodic message) is sent in 5 seconds after the interaction enters the queue, and subsequent periodic messages are sent according to the configured timeout, until the interaction leaves the queue.
For chat scenarios only (see image below), the periodic message is used to send a periodic regular text message in the same way that the Send Message block does. For example, the periodic message could include variables that provide the customer information about EWT or placement in queue.
The Escape button is the key on the telephone keypad (0-9, *, or #) that a caller can press to exit the queue. When the caller presses the escape button, the scenario executes the Escape Digit conditional exit. Typically in such situations, the scenario sends the caller to a voicemail or terminates the call. This setting applies to voice scenarios only.
Keep call in queue
If selected, the scenario will keep the call in queue even if there are no agents currently logged on. If not selected, the No Agents conditional exit will be used. This setting applies to voice scenarios only and finite intervals only. It does not apply to the condition Specific agent.
Virtual Queue option
The Virtual Queue option allows the callers to request a callback instead of waiting for an agent in the queue. Calls that requested callbacks will be waiting in a virtual queue. The decision to offer the callback option is made based on the call’s estimated wait time (EWT) in queue. If a caller selects this option, the Callback exit is taken. This exit would normally lead to a Request Callback block where the caller’s original inbound call will be disconnected while his position in the service queue will be preserved. The callback is made when it is the caller’s “turn” to be routed to an agent. Note that the callback option must also be enabled in the general properties of the corresponding service.
To enable the Virtual Queue option, select the enable if EWT is greater than checkbox and specify the threshold EWT; the Virtual Queue option will be offered only if the Estimated Waiting Time for a given call exceeds this threshold value. Specify the Callback button (i.e., the phone key that the caller will have to press to select the Virtual Queue option) to request a callback instead of waiting in the queue. If the Virtual Queue option is selected, the Callback conditional exit will be executed, allowing the scenario to collect the callback data and place the call in the virtual queue (see block Request Callback). The Virtual Queue option applies to voice scenarios only. For more information, see the Virtual Queue Tutorial.
Periodic reminder - repeat every
This setting allows you to specify the number of seconds you want the scenario to wait between playing the Periodic Reminder prompt. Set this field only if you want the scenario to play the Periodic Reminder prompt. Enter 0 if you want to disable this feature. This setting applies to voice scenarios only.
Periodic reminder - when interaction EWT becomes less than
If the Periodic reminder - repeat every setting is configured and you enable this option, if the interaction EWT becomes less than the specified number of seconds, you may configure the scenario to either change the periodic reminder prompt that plays or stop playing the prompt. If this option is not enabled, the Periodic reminder - repeat every setting will continue to play as specified. Note that this setting applies to voice scenarios only.
This setting allows you to configure one-time prompts to play at specific times (i.e., in seconds); note that these prompts do not repeat. This setting applies to voice scenarios only.
Keep playing hold music while ringing on agent
If selected, the Music on hold will continue after the Find Agent blocks exits; the prompt is stopped only when the subsequent Connect Call block actually connects the caller to the destination (destination answers). Otherwise, the caller will hear the ring-back tone from the moment the call is delivered to the agent and until the agent answers. This option only works if the block actually finds an agent; for all conditional exits, the hold music stops immediately. This setting applies to voice scenarios only.
The Find Agent block may take one of the following conditional exits: No Agents, Queue Limit, Escape Digit, Callback, or Timeout.
The No Agents exit is taken if no agents with matching skills are logged in (or when the last such agent logs out before the call is routed.)
Your service provider may have set up a limit for the number of items you can have queued for distribution to agents simultaneously (for all services combined). If an interaction processed by the given scenario exceeds this limit upon entering the queue, the Queue Limit exit will be used. Note that a repeated attempt to place the interaction in the same queue will result in the termination of the scenario.
The caller presses the escape digit to exit the queue. The Escape Digit exit will be displayed only if the Escape button setting is defined (see below). This exit applies to voice scenarios only.
The Callback exit will be taken if the Virtual Queue option is offered to and is accepted by the caller. This exit applies to voice scenarios only.
The Time Out exit will appear only if you define one or more escalation intervals for Agent skills required, provided that the last interval is finite. The Time Out exit will be taken if the last interval expires before any agents with matching skills become available. Note that if the last matching agent logs out before the timeout expires, the No Agents exit will be taken.
The Find Agent block can play any of the following prompts for the caller: Music on hold, Initial Prompt, EWT Announcement, Virtual Queue availability announcement, or Periodic reminder.
Music on hold
The scenario plays the Music on hold prompt while the call is in queue. If not defined, the default Hold and queue music treatment will be played. The Keep playing hold music while ringing on agent parameter controls when the music is stopped.
If defined, this optional Initial Prompt will be played to the caller as soon as the call is placed in queue; all other prompts are played after this prompt.
The voice scenario plays the EWT Announcement when providing the estimated wait time (EWT). The scenario uses the system to read the actual EWT. For example, the prompt announces The estimated wait time is, and then the system announces the EWT, such as eight minutes.
Virtual Queue availability announcement
The Virtual Queue availability announcement prompt is played to callers to offer them an option of requesting a callback instead of waiting in the queue. See the description of the Virtual Queue option for details.
The scenario will periodically play the Periodic reminder prompt to the call in queue at the frequency you set in the Periodic reminder - repeat every field. If you do not set this prompt, the reminder does not play. You can use the EWT Announcement prompt as a reminder prompt.
Keep playing hold music while ringing on agent
The scenario plays the Music on hold prompt while the call is in queue. If not defined, the default Hold and queue treatment will be played. The Keep playing hold music while ringing on agent parameter controls when the music is stopped.
Play random segment
The Play random segment option offers variety of queue audio treatments for voice calls, allowing you to vary the audio treatments played while waiting in the queue.