Queuecallback

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

A variation of Callback without requiring a pre-existing live call. Queuecallback allows: 

Supported Script Types

The icon for the Phone script type - an old-style phone handset with curved lines indicating sound coming out of it.

Phone

Comparison of Similar Actions

The following actions have similar functions, but with some key differences: 

  • Callback: Allows an existing live call to be marked for callback when an agent becomes available.
  • Queuecallback: Allows the user to add a callback without a preexisting live call.

Input Properties

These properties define data that the action uses when executing.

Property

Description

Caption

Enter a short phrase that uniquely identifies this action in the script. The caption appears on the script canvas under the action icon. The default is the action name.

PhoneNumber

The phone number the action searches for in the queue callbackClosed Holds a customer's place in queue and automatically calls the customer when they move to the front of the queue. state in queue. The default value is {ANI}.

CallerID

The phone number displayed on the contact's caller ID when the callbackClosed Holds a customer's place in queue and automatically calls the customer when they move to the front of the queue. is returned by the agent.

The pricing for a call can change based on the Caller ID. Contact your account representative if you have any questions about which Caller ID numbers are valid.

Defaults to {DNIS}.

CallDelaySec

The number of seconds between when the contact center agent picks up the phone and when the system dials the contact callback number. The maximum delay is 59 seconds. If you enter 60 seconds or more, agents will be placed in a refused state.
Skill Select an ACD skillClosed Used to automate delivery of interactions based on agent skills, abilities, and knowledge. If you select Default, the script uses the default skill set in the script when this action fires. If no skill is set in the script, it uses the 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.. You can use a variable in this property.

TargetAgent

Select an agent from the dropdown if you want a specific agent to handle contacts routed by the skill you specify in the Skill property. 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, CXone queues the contact until they become available. If the target agent refuses the call, CXone routes the contact to any other available agent with the same skill.

PriorityManagement

Allows you to specify how you want priority management handled for this action.

The default is DefaultFromSkill. This means the script uses the priority management defined in the Skill you selected.

Select Custom if you want to override the priority settings for the skill and specify different handling. Set the levels you want this action to use in the InitialPriority, Acceleration, and MaxPriority fields.

InitialPriority

Specify the base priority of the contact as it enters the system. You only need to complete this field if you are defining Custom PriorityManagement for this action.

The priorityClosed Skill-based designation of the importance of contacts that determines delivery order. grows incrementally based on the function you select. When an agent becomes available, the contact with the highest priority in the skill set of the agent will be routed to the agent.

Defaults to 0.

Acceleration

Determines how quickly the priority increases with every minute the contact stays in queue. You only need to complete this field if you are defining Custom PriorityManagement for this action.

The default value is 1. The minimum value is 0 and the maximum priority is the value configured in the MaxPriority property.

For example, if the InitialPriority is 4 and you set Acceleration to 1, then with each passing minute that the contact is not handled, the priority increases by one. If the contact is still in queue after three minutes, the priority will be raised to 7.

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

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

MaxPriority

Specify the maximum priority that a contact using this skill can have. You only need to complete this field if you are defining Custom PriorityManagement for this action.

If a contact reaches max priority, priority is the only factor CXone uses to route the contact. This can cause issues if multiple contacts all reach max priority at the same time.

Defaults to 1000.

Sequence

Define the prompt that the action plays. A prompt can be a prerecorded WAV audio file or text-to-speechClosed Allows users to enter recorded prompts as text and use a computer-generated voice to speak the content. (TTS).

If the prompt is an audio file, enter the file name enclosed in double quotes. For example, "greeting.wav". If the audio file is located in a different folder, include the path to the file. For example, if the script is in the root folder and the audio file is in a subfolder two levels down, enter "Subfolder\Subfolder2\Audio-file.wav". If the script is in a subfolder one level down from the root and the audio file is in a different subfolder on the same level, enter "\..\Subfolder\Audio-file.wav".

If the prompt is text-to-speech, enter the text you want the TTSClosed Allows users to enter recorded prompts as text and use a computer-generated voice to speak the content. service to read. Each segment must be enclosed in double quotes and include a string reference character to identify the type of information it is. For example: 

"%Your account balance is" "silence.wav"  "${accountBalance}"

For more information about formatting prompts in this property, including the string reference prefix characters to use, see the Prompts page. Some actions with the Sequence property have access to the sequence editor, which is a graphical interface you can use to create prompts. This action doesn't access this editor. However you can use the sequence editor from an action that supports it, such as Play. Add Play to your script and create your prompt sequence. Paste the sequence text from the Sequence field in Play into this action and then delete Play.

ZipTone

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

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

The default value is NoZipTone. This property replaces the Ziptone action.

ScreenPopSource

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

  • DefaultFromSkill: Uses the information set in CXone for the skill. This is the default value.
  • UseOnPageOpen : Runs the Onpageopen action.
  • Custom: Uses the URL you provide in the ScreenPopURL property.

ScreenPopURL

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.

HighProficiency

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.

LowProficiency

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.

RoutingAttribute

Select the specific attribute to use in the routing criteria. When requesting agents, only agents with the specified Skill and RoutingAttribute combination are selected to receive contacts. Use the UpdateContact action to change or remove the routing attribute 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

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

Error

Path taken when the action fails to execute properly. For example, when there is an unexpected problem such as poor connectivity, syntax errors, and so on. The _ERR variable, with a single underscore character, should be populated with a condensed explanation of the problem.