REQAGENT

This help page is for Studio. This information is also available for Desktop Studio.

 

Requests an agent with a specific ACD skillClosed Used to automate delivery of interactions based on agent skills, abilities, and knowledge. to handle an active contact. You can request an agent with a specific proficiency in the skill. You can also define how priorityClosed Skill-based designation of the importance of contacts that determines delivery order. management works for the contacts this action handles.

If an agent is immediately available, the contact is routed to that agent. If the agent is not available, the contact is placed in queue. The OnAnswer event triggers when an agent starts the interaction with the contact.

Reqagent is the point in the script where the contact moves from the Prequeue state to the Queued state. When a contact is in queue, you can define a sequence of actions that happens while the contact waits for an agent. You can also define logic to handle scenarios such as when the contact has waited a certain amount of time. The Tips and Tricks section provides examples of things you can include in a holding pattern.

Supported Script Types

A square with a line branching from it that goes to three other squares.

Generic

Email Chat Phone Voicemail Work Item SMS

Reqagent can also be used with digitalClosed Any channel, contact, or skill associated with Digital Experience. media type scripts, but it has a separate help page.

Input Properties

These properties define data that the action uses when executing.

Property

Description

Add Caption

Change the Caption to something that uniquely identifies this action in the script. The IVR Press Path report includes the action name and caption. Descriptive, unique captions make the reports easier to read and understand.

Skill Select the ACD skillClosed Used to automate delivery of interactions based on agent skills, abilities, and knowledge. you want contacts routed to. If you select Default, the script uses the default skill assigned to the associated point of contactClosed The entry point that an inbound contact uses to initiate an interaction, such as a phone number or email address.. Variable substitution is commonly used for this property.
Target Agent

Select an agent from the dropdown if you want a specific agent to handle contacts routed by Skill you specified. For example, if you have an agent who is an expert in one niche field, you could set their name to take the contact when an agent is requested. You can use a variable in this field. For example, {AgentId}.

If the target agent is unavailable or refuses the call, CXone Mpower queues the contact until the target agent becomes available.

Priority Management

Allows you to specify how you want priority management handled for this action. Click Default to use the priorityClosed Skill-based designation of the importance of contacts that determines delivery order. management from the Skill you selected. Click Custom to override the priority settings for the specified Skill and define different handling. Set the levels you want this action to use in the fields that appear: 

  • Initial Priority: Enter a numeric value you want to set as the base level priorityClosed Skill-based designation of the importance of contacts that determines delivery order. for all contacts in an inbound skill or for fresh records and retries in an outbound skill (callbacksClosed Holds a customer's place in queue and automatically calls the customer when they move to the front of the queue. always take priority and are not affected by this setting). The default value is 0.

    Acceleration: Follow these guidelines to complete this property:

    Enter a numeric value to determine how quickly the priority of the skill increases. For every minute a contact stays in queue, the priority increases by the value you configure for Acceleration.

    The default value is 1. The minimum value is 0 and the maximum priority is the value configured in the Maximum Priority field.

    For example, if the Initial Priority is 4, and you set Acceleration to 1, then with each passing minute that the contact is not handled, the priority increases by one. In this example, if the contact has been in queue for three minutes, then the priority will be raised to 7.

    Priority increments in seconds. For example, when Acceleration is 1, a contact's priority increases by 0.5 after 30 seconds in queue.

    For Personal Connection skills, set this value to 0 because there is no queue of contacts.

    You can set Initial Priority for one skill lower than another skill, but if you set Acceleration for that skill higher, it can jump spots in the queue. For example, you set Initial Priority for Skill A to 1 and Acceleration to 5. You set Initial Priority for Skill B to 3 and Acceleration to 1. Initially, a contact for Skill B will be first in queue because it has a priority of 4, but after one minute, Skill A will take its place at the top because its priority will be 6.

    CXone Mpower combines the acceleration value with the time the contact has been in queue and the initial priority using the formula Overall Priority = (Time * Acceleration) + Initial Priority.

    Max Priority: Enter a numeric value to determine the maximum priority a contact can have. If you choose not to use Acceleration, this value should match the Initial Priority. The default value is 1000.

Screen Pop Source

Select the source for screen pop information. Complete this field only if you want to incorporate screen pops into this action. Options are:

  • Default: Uses the information set in CXone Mpower for the skill. This is the default value.
  • On Page : Runs the Onpageopen action.
  • Custom: Uses the URL you provide in the URL property that appears when you select this option. Click Preview in new window to verify the URL you entered. The page opens in a new window. When entering the URL, follow these guidelines:
    • Specify the URL you want opened for the agent as a screen pop. You can use a variable in this property.

    • The URL must be complete, including the http://. For example, http://www.yourdomainhere.com.

    • You can append additional information to the end of the URL using variables from Assign actions earlier in the script. The ScreenPop property of the Assign action must be set to True for each variable you want to append to the URL. You also need to modify the ScreenPopURL to include the variables as parameters. Use this format: http://www.yourdomainhere.com?var1=value1&var2=value2

    • You can customize the title of the tab that pops up in the MAX interface by appending the icAgentPanelTitle= parameter to the URL.

    • The URL specified in this property opens in the default browser. The screen pop appears for the agent when the ACD decides to route the contact to that agent and changes the contact's state to Routing. If you want screen pops to appear at a different time during an interaction, you can use the Runapp action.

Agent Audio Sequence

Allows you to customize the audio cue given to agents when they have a new contactClosed The person interacting with an agent, IVR, or bot in your contact center. routed by this action. The audio cue can be a prerecorded audio file or a text-to-speechClosed Allows users to enter recorded prompts as text and use a computer-generated voice to speak the content. prompt. The cue can also be a combination of both.

If you want to use an audio file only, enter the name and path to the file enclosed in double quotes. For example, "newContact.wav". You can upload an audio file to Studio to use for this action.You can use a variable instead of naming a specific audio file.

To create a more complex audio cue, use the Sequence Editor in the Play action. When the prompt is finished, copy the contents of the Play action's Sequence property into the Agent Audio Sequence property in this REQAGENT action. Delete Play if you don't need it in your script.

If you don't specify an audio file in this property, REQAGENT uses the default zip tone. If you don't want an audio cue, set Zip Tone Alert to No Zip Tone.

Zip Tone Alert

Select when you want the zip tone sound played to alert the agent of a new contact. Options are:

  • No Zip Tone: The system does not play a zip tone.
  • After Sequence: The system plays a zip tone after the audio file defined in the Agent Audio Sequence property.
  • Before Sequence: The system plays a zip tone before the audio file defined in the Agent Audio Sequence property.

The default value is No Zip Tone. This property replaces the Ziptone action.

High Proficiency

The highest skill proficiency an agent must have in order to receive a contact. Proficiency values are whole numbers from 1 to 20, with 1 being best and 20 being worst.

Low Proficiency

The lowest skill proficiency an agent must have in order to receive a contact. Proficiency values are whole numbers from 1 to 20, with 1 being best and 20 being worst.

Routing Attribute

Select the specific attributes to use in the routing criteria. When requesting agents, only agents with the specified Skill and RoutingAttribute combination are matched. When used for routing decisions, you can use the UpdateContact action to change or remove the routing attributes later in the script. The default option is Not Applicable. You can use a variable for this property.

Result Branch Conditions

Result branch conditions allow you to create branches in your script to handle different outcomes when an action executes.

Condition

Description

Default

The path taken unless the script meets a condition that requires it to take one of the other branches. It is also taken if the other branches are not defined.

Error

The path taken when the action doesn't execute properly. For example, when there's an unexpected problem, such as poor connectivity, syntax errors, HTTP error codes, and so on. The ERR variable should be populated with a condensed explanation of the problem.

Specific Use Case: A second Reqagent action in the script attempts to change the contact's skill. If the contact is actively routing to an agent when the skill change is attempted, it goes to the OnError branch.

Tips & Tricks

  • You can place actions after Reqagent to create a holding pattern. Common things to include in a holding pattern are:

    • Playing prompts and music.

    • Providing the current queue count.

    • Providing the current estimated wait time.

    • Offering the option of leaving a voicemail.

    • Performing a blind transfer after a certain amount of time.

    • Changing skill proficiency and other settings to increase the pool of available agents the longer the contact waits.

    • Fallback logic.

  • As soon as the contact is in the Routing state, the __agentID variable is present in the script.
  • This action adds a large number of pre-defined variables to the script. You can do a trace on the script to see what variables are present. If you have previously added these variables to your script, they are overwritten when the script gets to Reqagent.
  • You can use bullseye routing to dynamically increase or decrease the pool of available agents. To do so, establish skill proficiency, a routing attribute, or both in the Reqagent action. Then use an UpdateContact action to change those values when specific criteria are met.
  • If you use WFM, review the documentation for your WFM product before you set up bullseye routing. Determine the best practices and potential forecasting impacts of using bullseye routing with proficiency ranges, routing attributes, or both.

    • If you use IEX WFM, review the Distribution Rules Guide.
    • If you use WFM, review the online help.

Script Example

This is an example to show how this action can be used in scripts. It is not intended to be a complete script. Additional scripting may be required.

In this example, Begin triggers a Menu, which uses synthesized text to tell the caller to press 1 to speak to a contact center agent. If an agent is not immediately available, a loop plays music for 30 seconds, waits for five seconds, and repeats until an agent answers the call.

Sample script using these actions in order: Begin, Menu, Reqagent, Music, Wait

Would you like to download this script?