A peripheral is a switch, such as an ACD, PBX, VRU, or
Unified Communications Manager (Unified CM). Calls arrive at the peripheral through
trunks that are organized into trunk groups. The Unified Intelligent Contact Management (Unified ICM) system software monitors
activity at each peripheral and can route calls to targets at each peripheral.
The logical interface controller and physical interface controller
represent the peripheral gateway (PG) through which the peripheral communicates
with the system.
To view the elements in a peripheral subsystem, see the following
figure.
Figure 1. Peripheral subsystem
The routing client figures into this subsystem only if the peripheral
acts as a routing client (that is, if it sends routing requests to the system
software).
Each peripheral communicates with the system software through a
peripheral gateway (PG). The PG is a computer that communicates
directly with the ACD, PBX, VRU, or
Unified CM at a contact center, monitoring status
information from the peripheral and sending it to the Central Controller. If
the peripheral acts as a routing client, the PG sends routing requests to the
system software.
The PG can be a single simplexed computer or a pair of duplexed
computers. A single PG can service more than one peripheral; however, each
peripheral uses one, and only one, PG.
Note
Although a PG can consist of a pair of duplexed computers, only one
of them is active at a time, so that the system software sees it as a single,
logical and physical PG.
Peripheral Gateway records
Use the PG Explorer to view, define, modify, or delete Peripheral
Gateway records.
The PG Explorer generates and maintains PG records for a logical
interface controller, a physical interface controller, associated peripherals,
and, if appropriate, an associated routing client.
Note
If you are configuring a PG for a duplexed pair, you need to
define the information only once.
The following figure shows the records generated by the PG Explorer.
From the Configuration Manager menu, select
Tools > Explorer
Tools > PG Explorer. The PG
Explorer window appears.
Step 2
In the
Select filter data box, select the filters you
want.
Step 3
Click
Retrieve. Names of retrieved PGs appear in the
tree list box.
Step 4
In the tree list box, select the PG whose records you want to
view. The configuration information displays in the tabbed fields on the right.
Step 5
To view a peripheral's record: in the tree list box, expand the
tree branch for the selected PG, and select the PG's peripheral icon.
The peripheral configuration information displays in the window on the right. For field descriptions, see the PG Explorer Tab Descriptions section.
PG Explorer tab descriptions
The following tables describe the tabbed property fields and buttons
that configure a PG. Use these fields to define and update PGs and their
associated peripherals.
Use the Logical Controller tab to view, define, and update PG
definitions. In the
Unified ICM database, a PG is identified by its logical controller.
Table 1 Logical Controller tab field descriptions
Field
Description
Logical Controller ID (required)
A unique identifier used to reference the PG's Logical Interface
Controller table.
This is a read-only field. When you create a new PG, the system
places UNASSIGNED in this field and automatically creates an ID when you save
your edits.
Physical Controller ID (required)
A unique identifier for the PG's physical controller.
This is a read-only field. When you create a new PG, the system
places UNASSIGNED in this field and automatically creates an ID when you save
your edits.
Name (required)
An enterprise name for the PG. This name must be unique for all
PGs in the enterprise.
An enterprise name:
Is a character-string name commonly used to identify an object
in the
Unified ICM database.
Must be unique among all objects of a specific type. For
example, each service must have an enterprise name that is unique among all
services.
Can be up to 32 characters. The valid characters are
upper-case and lower-case letters, digits, periods (.) and underlines (_). The
first character of the name must be a letter or digit.
Note
This name is used in composite names, which are limited to a 32
character length, for example, an agent enterprise name. Therefore, keep the
name short.
Client type (required)
(selection list) The type of client that the PG services.
When defining a new PG, select one from the pop-up selection box.
Selecting a type of peripheral automatically places that type's
default values in the associated peripheral's Client type, Peripheral Service
Level type, Service Level type, and Service Level Threshold fields.
Note
Once a client type is selected and saved in the database, the
selection box options change and you are limited on how you can change that
type. If the client type is PG Generic, you may be able to change that
type from the Peripheral tab. However, if the peripheral is online and agents
are logged onto it, the agents will be automatically logged off when the
peripheral's client type is changed.
Note
Previously configured PG types used in earlier releases that
are no longer supported, such as ACP1000, will display the following error
message when the PG is selected:
Client Type 'ACP1000' is no longer supported.
This PG should be deleted.
Configuration parameters
A string containing information, such as logon information,
specific to the PG.
For example: -rtuser UserName -rtpswd Password
Description
Additional information about the PG.
Physical controller description
Information about the physical controller.
Primary CTI address
Address for computer telephony integration (CTI) server as <IP>:<port> in either dotted
numeric or name format. If a CTI server is installed at the PG, enter its
address. This address is needed if an agent is connected through a CTI server
rather than through a peripheral.
Secondary CTI address
Address for CTI server as <IP>:<port> in either dotted
numeric or name format. The secondary CTI address is needed if a CTI server is
installed at the PG and the
Unified ICM system is duplexed.
Note
If you use a simplex system, fill in both the addresses.
Otherwise the CeM arm connection will not be established.
Reporting interval
The system software stores historical information in either
15-minute or half-hour summaries (but not both), based on the reporting
interval option set. TheCallRouter sends these records to the Logger, which in
turn writes them to the Central Database.
Select the
15 Minute or
30 Minute reporting interval option (default is 30 Minute).
Note
Be aware that the 15 Minute interval requires a larger amount
of space than the 30 Minute interval.
Interval data is populated in these tables:
Agent_Interval
Agent_Skill_Group_Interval
Peripheral_Interval
Service_Interval
Skill_Group_Interval
Call_Type_Interval
Call_Type_SG_Interval
Campaign_Query_Rule_Interval
Time Source
The time source that the PG uses to copy the historical interval
data (15 or 30 minute) and send to the CallRouter. Any change made to the time
source requires simultaneous shutdown (PG services to be stopped and restarted
simultaneously) on both PG sides.
Two time source options are available:
Use Central Controller Time. The PG uses the Central
Controller CallRouter time source to obtain the historical interval (15 or 30
Minute) data and send to the CallRouter (default time source when adding or
upgrading a PG).
Use ACD Time. The PG uses the corresponding ACD time
source to obtain only the 30-minute historical interval data and send to the
CallRouter. (15-minute historical data is not supported for PGs that use the
ACD time source.)
Note
If the
Use ACD Time option is enabled, the CallRouter-generated
Call Type and Call Type Skill Group data will not align with the
Peripheral-generated Skill Group data.
This option is available only for the following client types
for the defined PG:
Avaya (Definity)
Aspect Call Center
Aspect Spectrum
(Rockwell)
UCC Enterprise Gateway
Peripheral tab
Use the Peripheral tab and
its associated tabs to view, define, and update the peripherals associated with
a PG.
Table 2 Peripheral tab field descriptions
Field
Description
Peripheral ID (required)
A unique identifier for the peripheral. This is a read-only field.
When you create a new PG, the system places UNASSIGNED in this field and
automatically creates an ID when you save your edits.
Note
If you change the Agent ID (Peripheral ID), you must cycle the
PG to populate the new agent ID and information in the computer telephony integration (CTI OS)
Supervisor Desktop.
Name (required)
An enterprise name for this peripheral. The name must be unique
among all peripherals in the enterprise.
Peripheral name (required)
The name of the peripheral as it is known at the local site.
Unlike the Enterprise Name field, the value of this field does not have to be
unique. For example, at each site you might label the peripherals Switch1,
Switch2, and so forth.
Client type (required)
The type of peripheral. The value for this field comes from the
Logical Controller Client Type field.
Note
Once a client type is selected and saved in the database, the
selection box options change and you are limited on how you can change that
type. If the client type is PG Generic, you may be able to change that
type from the Peripheral tab. However, if the peripheral is online and agents
are logged onto it, the agents will be automatically logged off when the
peripheral's client type is changed.
Location
The peripheral's location; for example: the name of a city,
building, or department.
Abandoned call wait time (required)
Minimum time in seconds an incoming call must be queued before
being considered an abandoned call if the caller hangs up.
Configuration parameters
A string containing any parameters that must be sent to the device
to initialize it. In most cases, leave this string blank.
Call control variable map
A string that describes the mappings of the peripheral's call
control variables to the system software's call control variables.
Default desk settings
(selection list) Default desk settings for agents associated with
the peripheral.
Note
If NONE is the only option in the selection list, you need to
create desk settings. To create desk settings, use the Configuration Manager's
Agent Desk Settings List tool.
Peripheral service level type (required)
The default type of service level calculation to be performed by
the peripheral for its associated services.
Specify one of the following:
If the peripheral type is Aspect Call Center, choose the type of
calculation to be performed by default. You can override the default for each
individual service.
If the peripheral type is not Aspect Call Center, choose
Calculated by Call Center.
Agent Phone Line Control (required)
Indicates whether this agent peripheral supports multi-line
control for all agents with more than one line configured on the phone.
Specify one of the following agent phone line control options:
Single Line: Enables single line monitoring and
reporting (default).
All Lines: Enables multi-line monitoring and reporting.
Non ACD Line Impact (required)
Indicates how many non-ACD calls the agent initiated on one of the
non-ACD lines. (This field is populated only when the
All Lines option is enabled.)
Specify one of the following non-ACD line impact options:
Available Agent Goes Not Ready: Agent state is set to
NOT READY with a system reason code when agent answers or places a call on a
secondary line while in the AVAILABLE or NOT READY state.
Available Agent Stays Available: Agent state is
unchanged when agent is on a call on a secondary line.
Description
Additional information about the peripheral.
Enable post routing
If checked, indicates that post-routing is enabled. When this is enabled,
the Routing Client tab is also enabled.
If you check
Enable post-routing in the Peripheral tab,
also enter the properties in the Routing Client tab.
Note
If an existing PG does not have post-routing enabled and its
type supports it, you can enable it. However, if an existing PG has
post-routing enabled, you cannot disable it.
Peripheral auto-configured
Checked, indicates peripheral is auto configured.
Advanced tab
The Advanced tab allows you to view (and define or edit, if you have
maintenance access) the advanced properties of the selected peripheral.
Table 3 Advanced tab field descriptions
Field
Description
Available holdoff delay (required)
The number of seconds to wait after the end of a call before
recording the agent as available. The value you enter here is the default for
all skill groups associated with the peripheral. You can change the value for
individual skill groups.
Default route
The default route associated with this peripheral.
Answered short calls threshold
The maximum length, in seconds, for a short call to the
peripheral. Any calls with a duration below the threshold are considered short.
You might then choose to factor out short calls from handle times you
calculate.
Network VRU
The type of network VRU. If the peripheral is a VRU, that is, used
as a network VRU, select the name of the network VRU from the drop-down list.
Agent auto-configuration
Specifies whether agent auto-configuration is enabled for the
peripheral.
Note
Agent Reporting implies Auto Configuration. Agent Reporting
without auto-configuration is NOT supported.
Unified ICM does not support Agent Reporting on manually configured agents
with auto-configuration off.
Internal IPTA only
Specifies whether the peripheral belongs to internal IPTA.
Skill Group Mask tab
This tab allows you to view (and define or edit, if you have maintenance
access) the default number of sub-skill groups associated with the selected
peripheral.
Important: Sub-skill groups are not supported in Unified Contact Center Enterprise (Unified CCE) 9.0. Support for sub-skill groups continues, however, for Unified ICM 9.0 - and thus for TDM peripheral gateways (as configured in Avaya PG, Symposium PG, Spectrum PG and NEC PG peripherals). Sub-skill groups are also not
supported for non-voice skill groups. That is, you cannot create sub-skill
groups for these media classes: single-session chat, multi-session chat,
blended collaboration, and email.
Note
For some peripherals, the
Configuration Manager can automatically create subgroups (primary, secondary,
and so on) for each skill group.
Sub-Skill Group check boxes
Note
These check boxes are enabled only for Avaya PG, Symposium PG, Spectrum PG, and NEC PG TDM peripherals.
The maximum number of subgroups that may be created depends on the
peripheral's client type, and may be none. Where subgroups are available, a
default selection has been made. You may change this default, either to none or
any number up to the maximum number allowed for this client type.
If you later edit the subgroup selection, removing any previously used
subgroups may cause loss of reporting information and must be done carefully.
Changes done here will be reflected in all skill group entries that currently
exist for this peripheral, which do not explicitly override the settings in the
peripheral.
Check a box for each sub-skill group for each non-enterprise skill
group you want to be associated by default with the peripheral. For each box
you check, a skill group record is created in the database if the primary skill
group uses the peripheral's default.
The number of sub-skill groups used by a primary skill group is
specified in the Subgroup Mask tab of the Skill Group Explorer. There, you can
add more sub-skill groups than are defined for the peripheral if the selected
skill group requires additional ones.
Note
The Sub-Skill group check boxes are dimmed for enterprise skill
groups.
Routing Client tab
A routing client represents an entity that sends routing requests to the
system software through a logical interface controller. Use the Routing Client
tab to view, define, or update a PG's routing clients.
Table 4 Routing client tab field descriptions
Field
Description
Name (required)
An enterprise name for this routing client. The name must be
unique among all routing clients in the enterprise.
Timeout threshold (required)
The maximum time, in milliseconds, the routing client can wait for
a response to a routing request. The NIC sends a default response slightly
before this threshold.
Late threshold (required)
The threshold value, in milliseconds, for classifying responses as
late. Any response that exceeds this threshold is considered late even if it
does not exceed the TimeoutThreshold.
Timeout limit (required)
The number of seconds to wait for routing responses before the
routing client terminates communication with the system software. When a
response from the CallRouter exceeds the time-out threshold, the routing
client starts a timer. If the timer reaches the specified time-out limit before
the routing client receives any responses from the CallRouter, the routing
client assumes the
Unified ICM system is off-line and stops sending it routing requests.
Default MR domain ID (required)
(selection list) The MRD associated with the
routing client.
Default call type
The call type to be used for any route request that does not match
a defined call type mapping. The drop-down list contains all configured call
types.
The system software uses the default call type for any routing
request from the routing client that does not otherwise map to a call type. If
you do not define a default call type for the routing client, the system
software uses a general default call type.
Configuration parameters
An optional string containing the configuration parameters to be
used by the controller to initialize the routing client. For a public network
client, this field normally specifies the subsystem for the NIC to use.
Use DN/Label map
Indicates that the Dialed Number (DN) Label table is used to
determine which labels are valid for each dialed number (if checked), or that
all labels for the routing client are valid for all dialed numbers (if not
checked). Normally, leave this field unchecked.
Client type
Indicates the type of client. For an incoming-call-reply (ICRP) NIC, this is the type of
the ultimate client on the network
Unified ICM. In all other cases, it is the same as the PG's Client Type.
Description
Additional information about the routing client.
Network routing client
A name used to associate routing clients across instances.
Network transfer preferred
Checked, indicates network transfer is preferred. When the target
of a call transfer is reachable by both a label defined for the requesting
routing client and by another label defined for the network routing client that
pre-routed the call, this option indicates which choice is preferred.
Congestion Treatment Mode
Congestion treatment mode for routing
clients. The default value is 0 when you add a new routing
client.
The congestion treatment mode definitions are as follows:
0 - Use Congestion Control settings.
1 - Use Dialed Number (DN) as default label for call treatment.
2 - Use routing client as a default label for call treatment.
3 - Use global user-defined label for call treatment.
Note
To configure a user-defined label, use the Congestion Setting Configuration tool.
4 - Dialog fail with an appropriate error code.
5 - Release message to the routing client.
Default Label
Indicates the default label for the routing client to treat the
call when the system is congested.
Peripheral Monitor tab
A peripheral monitor is an entity that you want to monitor at the
peripheral. Not all peripherals require Peripheral Monitor records.
You must configure Peripheral Monitor records for Extension numbers on a Definity switch.
Table 5 Peripheral Monitor tab field descriptions
Field
Description
Current peripheral monitor entries
Lists the current peripheral monitor data (Type, Extension, and
Configuration Parameter) entered for the selected PG.
Note
The Peripheral monitor records are initially sorted by
PeripheralMonitorID (the default sort order). Click any column header to
reverse the sort order (ascending-to-descending or descending-to-ascending).
The indicator to the right always points to the lowest item in the current list
order.
Type (required)
The type of entity to be monitored: ACD Directory Number (ACD DN),
Meridian Position, Queue, Route Control Group (RCG), Routing Device, Station,
Symposium CDN, Trunk, Vector Directory Number (VDN), or Virtual Routing Device.
Extension
Extensions are:
For an Avaya (Definity), if there is a single extension number,
enter the number here (for example, 6002) and do not enter it in the parameter
string. If there is more than one number, leave this field blank and enter the
numbers as a range in the parameter string.
Configuration Parameters
A parameter string to be passed to the peripheral along with the
extension string to start monitoring on the specified extension:
For an Avaya (Definity), if there is more than one extension number,
enter them here as a range, for example, 6001-6020. If there is only one
extension number, leave the parameter string blank.
New
Click this button to enter new monitor data. Then select a type
from the Type selection list, fill in any other appropriate field information,
and press the
Enter key.
Delete
Click this button to delete the selected row item from the list of
Current peripheral monitor entries.
Extension
Displays the extension of the selected Current peripheral monitor
entries for editing purposes. Click
Save when you finish editing to save your
changes.
Configuration Parameter
Displays the Configuration Parameter of the selected Current
peripheral monitor entries for editing purposes. Click
Save when you are done editing to save your
changes.
Type
Displays the Type of the selected Current peripheral monitor
entries for editing purposes. Click
Save when you are done editing to save your
changes.
Default Route tab
Use this tab to create a default route for each MRD
that is associated with a peripheral.
Table 6 Default Route tab descriptions
Field/Button
Description
Current default route entries
Media routing domain
The media routing domain configured for the selected default route
entry.
Route
The default route configured for the media routing domain of the
selected default route entry.
Note
The default route configured for the media routing domain of
the selected default route entry. Click any column header to reverse the sort
order (ascending-to-descending or descending-to-ascending). The indicator to
the right always points to the lowest item in the current list order.
New
Click to enter new default route data. Then, enter a media routing
domain and a route.
Delete
Click to delete the selected row item from the list of current
default route entries.
Media routing domain (required)
Enter the media routing domain when creating a new default route
entry.
Route
Enter the route when creating a new default route entry.
Agent Distribution tab
Use the Agent Distribution tab to list and view the agent distributions
currently defined in the
Unified ICM database and (if you have maintenance access) to define new agent
distributions and edit or delete existing ones. This data is stored in the
database Agent Distribution table.
Note
The PG Explorer (and the assigning of agent distribution) is not
available on a
limited Administration and Data Server.
Table 7 Agent Distribution tab field descriptions
Field
Description
Enable agent reporting
Specifies whether agent reporting is enabled for the peripheral.
Select this option if you want the peripheral to report agent-level statistics
to the system software.
Note
Agent Reporting implies Auto Configuration. Agent Reporting
without auto-configuration is NOT supported.
Unified ICM does not support Agent Reporting on manually configured agents
with auto-configuration off.
Note
If the peripheral's client type is CUCM, you must select an agent desk setting in the PG Explorer's Peripheral tab
before you can enable agent reporting. The peripheral's client type is
indicated in the PG Explorer's Peripheral tab.
Agent event detail
Specifies whether agent event detail reporting is enabled for the
peripheral. This check box is enabled only if the
Enable agent reporting checkbox is selected.
Making this selection results in agent reason codes being added to agent
reporting.
Note
This checkbox is enabled by default if you are adding a
CUCM PG.
Agent distribution entries
Lists the agent distributors (Administration Clients or
Administration & Data Servers) available for distributing agent report data
for the selected peripheral.
Site name
One or more names of agent distribution sites associated with the
selected peripheral.
Agent real-time data
N indicates that agent real time data is not enabled.
Y indicates that agent real time data is enabled.
Agent historical data
N indicates that agent historical data is not enabled.
Y indicates that agent historical data is enabled.
Currently selected site
Administration & Data Server site name
The name of the currently selected site in the agent distribution
entries list.
Agent real time data
If checked, enables the flow of agent real time data from the
peripheral to the Administration & Data Server. Unchecked, disables the
flow of agent real time data.
Agent historical data
If checked, enables the flow of agent historical data from the
peripheral to the Administration & Data Server. If unchecked, disables the
flow of agent historical data.
New
Click to add a new Administration & Data Server site. This
places *NEW* in the
Administration & Data Server site name input box and in
the
Agent Distribution Entries list. Replace *NEW* in the
Administration & Data Server site name input box with the name you want.
Then check the check box if you want to enable it, and click
Save.
Delete
To delete an Administration & Data Server site, select that
site's name in the Agent Distribution Entries list and click this button. Then
click
Save.
Note
For information on how to use the agentcfg.exe command line utility to
import agent data, see
Agents.
PGs and Peripherals definition
Use the PG Explorer to define a PG and its associated peripherals.
Unified CCE System Peripheral Gateways
contains an example of how to define a PG on a child deployment, which is
documented in the
Cisco Contact Center Gateway Deployment Guide for Cisco Unified ICME/CCE/CCX.
To define a PG, perform the following:
Procedure
Step 1
From the Configuration Manager menu, select
Tools > Explorer
Tools > PG Explorer. The PG
Explorer window appears.
Step 2
In the Select filter data box, click
Retrieve. This enables the
Add PG button.
Step 3
Click
Add PG. A new PG appears in the tree list box
with a
To Be Inserted icon
next to it. Tabbed fields also
appear on the right for the new PG's configuration information.
Step 4
Fill in the tabbed fields.
Step 5
If desired, set security settings on the records.
Step 6
Click
Save to save the newly defined PG in the
database.
The selected PG's configuration information appears in the fields
on the right.
Step 2
In the tree list box, select the PG to which you want to add a
peripheral. This enables the
Add Peripheral button.
Step 3
Click
Add Peripheral. A peripheral is added to the
selected PG in the tree list box. Also, a new set of tabbed fields appear on
the right for the new PG's configuration information.
Step 4
Enter the needed peripheral configuration information in the
fields on the right.
Step 5
If desired, set security settings on the records.
Step 6
Click
Save.
After you have defined a peripheral, you can define the trunks,
agents, groups, and services associated with that peripheral.
Start the PG Explorer Tool, then in the Main window click
Retrieve.
Step 3
Click
Add PG.
This creates both the peripheral gateway and the peripheral.
Enter
UCCE for the Name.
Select
UCCE System for the Client Type.
If no desk settings are set, set them now. Click
OK.
The Agent Desk Settings List Tool appears.
Click
Add.
The Attribute tab appears.
Enter the Name
default.
Leave all other settings at their defaults and click
Save.
Close the Desk Settings List Tool.
Step 4
Go back to the PG Explorer Tool.
Select
UCCE-1 as the Peripheral.
On the Peripheral tab, set the Default Desk Settings to
default.
On the Agent Distribution tab, click
New.
Set the Administration & Data Server site name to
BELO-5C-Site 1 and leave all other settings at their
defaults.
On the Routing Client tab, enter the Name
UCCE_RC and leave all other settings at their defaults.
Click
Save.
The Logical Controller ID (5000) and the Physical Controller
ID (5000) are now indicated on the Logical Controller tab.
Reboot the System Peripheral Gateway computers (BELO-5A and
BELO-5B).
The Central Controller setup and configuration is now complete. The
Peripheral Gateways can now be installed and configured to communicate with the
Central Controller.
Add instance
This task is performed on the Child System Peripheral Gateway
computers BELO-5A (PG1A) and BELO-5B (PG1B).
To add the instance with the Web Setup Tool after the reboot:
Procedure
Step 1
Enter
http://BELO-5B/setup (or BELO-5A, as applicable) and log in to
the Web Setup Tool to add the Instance. The main Web Setup Tool window appears.
Step 2
Click
Instance Management, then click
Add.
The Add Instance dialog appears.
Step 3
Select
BELO (the Facility), then
bh03 (the Instance to add).
Step 4
Click
Save.
Step 5
Click
Log Out.
PG or peripheral modification
Use the PG Explorer to modify a PG or a peripheral.
The selected PG's configuration information displays in the fields
on the right.
Step 2
In the tree list box, select the PG or peripheral whose records
you want to delete.
Note
If you select a PG, the records for all peripherals associated
with it will also be deleted. If you select a peripheral, only its records will
be deleted.
Step 3
Click
Delete. This places a
Marked for Deletion icon
next to the selected item in
the tree list box. This also toggles the
Delete button to
Undelete.
To undelete an item marked for deletion, select it in the tree
list box and click
Undelete.
Step 4
Click
Save.
This deletes from the database the PG or peripheral marked for
deletion and removes it from the tree list box. Once you do this, you cannot
undelete the deleted item.
To configure call routing in system PG deployments, you must use an Agent Targeting Rule to specify the agent extension range versus configuring device targets and
labels for every phone and routing client. Using Agent Targeting Rules to configure call
routing for
Unified CCE agent PGs is simpler and significantly reduces the amount of time spent on configuration. Based on configured agent targeting rules, if an agent attempts to
log into an extension to which the router cannot target a call, the
peripheral gateway rejects the login request and returns an error
that includes why the login request failed.
Agent Targeting Rules are supported for System PGs, CallManager PGs,
and Generic PGs in
Unified Contact Center Enterprise/Unified Contact Center Hosted (Unified CCE/Unified CCH) deployments: standalone
Unified CCE/CCH,
Unified CCE/CCH child of a
Unified ICM parent, or a Unified ICM
Unified CCE/CCH Enterprise in a network analysis module (NAM) deployment.
In a NAM environment, Agent Targeting Rules can be used on the Unified ICM
side in a Unified CCH deployment to target agents. However, if
label validation is required on the NAM side, you must either define all the
labels that can be generated by the Agent Targeting Rules at the CICM on the
NAM side, or you must turn label validation off. The
Validate Returned Labels checkbox in the ICM
Gateway node must be
unchecked for calls routed using Agent Targeting Rules to work.
Not defining the labels, and turning label validation on, results in calls
failing at the NAM even though a response with a valid label was sent from the
CICM.
You can define one or more rules for a peripheral. However, each rule
must cover a different agent extension range for the same routing client. In
other words, if there are multiple rules that a routing client can use to
target a peripheral, there must be no overlapping extension ranges in those
rules.
Note
To use Agent Targeting Rules, you must have both the Central
Controller and the PGs upgraded to the same version of
Unified ICM that supports the Agent Targeting Rules feature.
To configure agent targeting rules:
Procedure
Step 1
Using the PG Explorer tool,
define a PG that
directly targets an agent. On the Advanced tab, select the
Rules Preferred option, which indicates that the
CallRouter will use the Agent Targeting Rule (if one exists). Save the PG.
Step 2
Using the Agent Targeting Rule List tool, create the rule:
Add a name for the rule in the
Name field.
Select the PG you just defined in the
Peripheral field.
Select the
Rule type:
Agent Extension: Enter the agent extension prefix.
This option directly targets the agent. The agent is identified by an ID,
which will display in the PreCall and Connect messages. (The agent's extension
is included as the label.)
Substitute Agent Extension: Enter the agent
extension length. When using this type, the label returned will be the combined
Agent Extension prefix and the actual agent extension. For example, if the call
from
Unified Customer Voice Portal (Unified CVP) goes through the target agent on a CallManager PG, use this
option.
Translation Route: A translation route is used to
move the call. This option allows pre-routing of calls directly to an agent
without requiring direct-inward-dial (DID) to all agents. Translation routes require the generation
of a second label, used to target the agent from the peripheral's local routing
client. For example, select a translation route associated with the peripheral
and define the extension range.
Select the routing client in the Routing client group box by
clicking
Add (defines where the call comes from).
Add the phone extension range in the Extension Ranges group
box by clicking
Add.
Click
Save.
When the CallRouter routes a call, it will check if there is a rule
for that routing client. The CallRouter decides which rule to use based on
routing client, PG, and extension range. When the CallRouter finds a rule, it
uses the rule type to decide how to construct a label to send to the routing
client.
Note
When configuring an Agent Targeting Rule for a Translation Route,
if you are using Agent Targeting Rule Type 3 (Translation Route), you must also
configure the Translation Route DNIS as dialed numbers associated with the
target agent's peripheral routing client in
Unified ICM. The dialed numbers must be mapped to the route points that are
configured in
Unified CM and associated with the Java Telephony API (JTAPI) user. This is
necessary to complete the Translation Route Rule.
Trunk groups and trunks
Every peripheral has one or more associated trunk groups, with each
trunk group containing one or more physical trunks. Trunk groups map to trunk
sets defined by the peripheral.
A peripheral dispatches a call to the appropriate skill target based
on the trunk group on which the call arrives and the DNIS value that
accompanies it. The peripheral treats all trunks with a particular trunk group
the same, but it might treat trunks within another trunk group differently.
When setting up trunk groups and trunks, you must specify:
Each trunk group that can receive calls
How many trunks are in each trunk group, or configuration
information for each trunk in the group
This section describes how to configure the trunk groups and trunks
that will be used by routing clients and peripherals.
Routing clients deliver calls to trunk groups at the peripheral.
However, a routing client might group the trunks differently from the way the
peripheral groups them. The groups as seen by the routing client are called
network trunk groups.
A network trunk group:
Is a collection of peripheral trunk groups.
Can map directly to a single trunk group at the peripheral or to
multiple trunk groups.
Can also map to trunk groups at different peripherals, provided
that all the peripherals are associated with the same PG. (Only
valid for VRU peripherals.)
View a network trunk group, its trunk groups, and trunks
To view a network trunk group, its trunk groups, and
trunks:
Procedure
Step 1
From the Configuration Manager menu, select
Tools > Explorer
Tools > Network Trunk Group
Explorer. The Network Trunk Group Explorer window
appears.
Figure 3. Example Network Trunk Group Explorer window
Step 2
In the
Select filter data box, select the filters you
want.
Step 3
Click
Retrieve. This enables the
Add button and displays a list of the
retrieved network trunk groups in a tree list box on the left side of the
Explorer window.
Step 4
In the tree list box, select the network trunk group whose records
you want to view or modify. The selected network trunk group's configuration
information displays in the tabbed fields on the right.
Step 5
To view trunk group or trunk data, expand the tree and select
the tree item whose properties you want to view or edit. In the above figure,
Trunk 99 is selected. This trunk belongs to the Boston_PG_1 trunk group, which
belongs to the Boston network trunk group.
The property tabs on the right side of the Explorer window display the
properties of the item selected in the tree list box. Properties with an
asterisk are required. If you have maintenance access, you can define or edit
these properties.
Network Trunk Group tab descriptions
The network trunk group tab allows you to view (and define or edit, if you have maintenance access)
the properties of the selected network trunk group.
Table 10 Network Trunk Group tab descriptions
Property
Description
Name (required)
An enterprise name for the network trunk group. This name must be
unique for all network trunk groups in the system.
Description
(optional) Any other information about the network trunk group.
Trunk Group tab descriptions
The trunk group tab allows you to view (and define or edit, if you have maintenance access)
the properties of the selected trunk group.
Table 11 Trunk Group tab descriptions
Property
Description
Peripheral (required)
(selection list) The enterprise name of the peripheral with which
the trunk group is associated.
Note
Once you have saved a trunk group record to the
Unified ICM database, you cannot update this field.
Peripheral number (required)
The number of this trunk group as understood by the peripheral.
This value must be unique among all trunk groups connected to the
same peripheral, but not throughout the entire system. Once you install the
data to the central database, you cannot change this field.
Peripheral name (required)
The name of this trunk group as understood by the peripheral.
This value must be unique among all trunk groups connected to the
same peripheral, but not throughout the entire system.
Name (required)
The enterprise name for the trunk group. This name must be unique
among all trunk groups in the entire system. If you click in this field when
entering a new trunk group, the system by default creates a name from the
peripheral and the peripheral name. For example: Boston_PG.TrunkGroup2 where
Boston_PG is the peripheral and TrunkGroup2 is the peripheral name.
Extension
The description is:
If the peripheral is an Avaya (Definity), the extension
number that the peripheral associates with this trunk group.
For all other peripheral types, leave this field blank.
Trunk count
(selection list) The number of trunks in this trunk group or
Use Trunk Data.
If
Use Trunk Data is selected, the system software determines
the trunk count dynamically by counting the associated records in the Trunk
table.
Config. Param.
A parameter string that the system software must send to the ACD
to configure the trunk group.
Description
A description for the trunk group.
Trunk tab descriptions
The Trunk tab allows you to view (and define or edit, if you have maintenance
access) the properties of the selected trunk.
Table 12 Trunk tab descriptions
Property
Description
Trunk number (required)
The number of this trunk within the trunk group.
Trunk type (required)
(selection list) The trunk's trunk type: DID/DNIS, Foreign
Exchange, Interflow, Local Central Office, PRI, Tie Line, or WATS.
Note
The
following table lists the types of trunks that the system software supports.
Circuit provider
The name of the carrier that provides the circuit for this
trunk. The provider is either a local phone company or an interexchange
carrier.
Table 13 Trunk types
Trunk Type
Description
Local CO
Connects the peripheral directly to the local telephone
company's central office (CO).
Foreign exchange
Connects the peripheral directly to the central office of a
non–local central office.
WATS
Dedicated to Wide Area Telecommunication Service (WATS). This
is a special service that allows a peripheral to place or receive calls from
specific regions at a discounted price.
DID/DNIS
Supports Direct Inside Dial (DID) or Dialed Number
Identification Service (DNIS). A code to identify the number dialed by the
caller accompanies each call. The peripheral can then dispatch the call to a
specific target.
PRI
Supports ISDN Primary Rate Interface (PRI). This mode
typically provides 23 channels for voice or data and one channel for signaling
information (23B + 1D).
Tie-line
Connects one peripheral directly with another across a wide
area.
Interflow
Dedicated line that allows one peripheral to off-load calls to
another peripheral.
Edit a network trunk group, its trunk groups, and trunks
To edit a network trunk group, its trunk groups, and
its trunks:
Procedure
Step 1
From the Configuration Manager menu, select
Tools > Explorer
Tools > Network Trunk Group
Explorer. The Network Trunk Group Explorer window
appears.
Step 2
In the
Select filter data box, select the filters you
want.
Step 3
Click
Retrieve. This displays a list of retrieved
network trunk groups in a tree list box on the left side of the Explorer
window.
Step 4
In the tree list box, select the item you want to edit. Expand the
tree if necessary. This displays the selected item's property tab on the right
side of the window.
Delete a network trunk group, its trunk groups, and trunks
Follow the steps to delete a network trunk group, its trunk groups,
and its trunks:
Procedure
Step 1
From the Configuration Manager menu, select
Tools > Explorer
Tools > Network Trunk Group
Explorer. The Network Trunk Group Explorer window
appears.
Step 2
In the
Select filter data box, select the filters you
want.
Step 3
Click
Retrieve. This displays a list of the
retrieved network trunk groups.
Step 4
In the tree list box, select the network trunk group, trunk group,
or trunk whose records you want to delete.
Note
If you select a network trunk group, the records for all trunk
groups and trunks associated with it will also be deleted. If you select a
trunk, only its records will be deleted.
Step 5
Click
Delete.
Step 6
This places a
Marked for Deletion icon
next to the selected item in the
tree list box. This also toggles the
Delete button to
Undelete.
To undelete an item marked for deletion, select it in the tree
list box and click
Undelete.
Step 7
Click
Save.
This deletes from the database the item marked for deletion and
removes it from the tree list box. Once you do this, you cannot undelete the
deleted item.
Define multiple trunks
You can quickly define multiple trunks of the same type for a specific
trunk group by using the
Multiple button in the Network Trunk Group
Explorer window.
To define multiple trunks:
Procedure
Step 1
From within the
Network Trunk Group Explorer, select the trunk group to which
you want to add trunks. This enables the
Multiple button.
Note
You must have an existing trunk from the peripheral defined
before you click
Multiple.
Step 2
Click
Multiple. The Multiple Trunk Creation dialog
appears.
Figure 4. Multiple Trunk Creation dialog
Step 3
Set the
First trunk number and the
Last trunk number fields so that you define the range of
trunks you want.
Step 4
In the Trunk type field, select the trunk type.
Step 5
(optional) In the Circuit provider field, enter the name of the
carrier that provides the circuit for this trunk.
Step 6
Click
Create records. The tree list box will display
a list of the numbered trunks beneath the selected trunk group and the Trunk
tab on the right side of the window will display the properties of the trunk at
the end of the series of numbers.
Step 7
In the Network Trunk Group Explorer window, click
Save.
Note
If a trunk number in the range you specified has already been used,
that trunk number is selected in the tree list box and a message displays.
Before you can save the data, you must edit the trunk number.