Skip to main content
Version: 4.2.0

CCE Routing with Universal Queue

This manual provides information on installing and configuring the Multichannel Add-on for the b+s Connects for Oracle Service Cloud Routing with Universal Queue solution. It contains architectural diagrams and descriptions of the software components, as well as guidelines for installing and setting up the additional components for a multi-channel enabled b+s Connects.

 Cisco Contact Center Configuration​

The configuration steps for UCCE and PCCE are slightly different.

After configuring UCCE or PCCE , continue with chapter CCE Script

UCCE Configuration​

For the UCCE configuration you will need:

  • Unified CCE Administration (web application) at https://<FQDN>/cceadmin
  • Configuration Manager on Unified CCE AW-HDS-DDS
  • Script Editor on Unified CCE AW-HDS-DDS or Internet Script Editor
  • Peripheral Gateway Setup on the Cisco Unified CCE PG server

The following configuration steps are required

  • Configure Network VRU for Media Routing
  • Configure Media Routing PG and PIM
  • Set up the Media Routing PG and PIM
  • Add Media Classes
  • Media Routing Domains
  • Define Application Path and add Application Path Members
  • Configure Call Type
  • Configure Dialed Number / Script Selector
  • Configure Skill Group

Configure Network VRU for Media Routing​

  1. On Unified CCE AW-HDS-DDS open CCE Configuration Manager > Network VRU Explorer
  2. Add new Network VRU
  3. Name: Connects_UQ
  4. Type: Type 2
  5. Add Description: Network VRU for Connects Media Routing Universal Queue

Network VRU Explorer

Configure Media Routing PG and PIM​

As soon as the new Network VRU is configured, open CCE Configuration Manager > PG Explorer. Create a media routing PIM and routing client for the b+s Harmony Routing Adapter.

  1. Add PG
    1. Name: Connects UQ
    2. Client type: MediaRouting
  2. Add Peripheral
  3. On the Peripheral tab
    1. Name: Connects UQ PG <MR PG Number>
    2. Client type: MediaRouting
    3. Check the «Enable post routing» check box.

PG Explorer Peripheral Tab

  1. Advanced tab
    1. Network VRU: select Network VRU configured in the previous step

PG Explorer Advanced Tab

  1. Routing client tab
    1. Add values as outlined:
      1. Name: Connects_UQ_PG2
      2. Time threshold: 2000
      3. Late threshold: 1000
      4. Timeout limit: 10
      5. Default media routing domain: NONE
      6. Default call type: NONE
      7. Dialed Number/Label map: Do not use DN/Label map
      8. Client Type: Media Routing
      9. Description: Routing Client Connects MR (PG2)
      10. Congestion Treatment Mode: Use System Congestion Control

PG Explorer Routing Client Tab

Please Note the Logical Controller ID and the Peripheral ID. Both IDs are required for the PG setup.

Set up the Media Routing PG and PIM​

Now switch to the Cisco Unified CCE PG server and open Peripheral Gateway Setup in Cisco Unified CCE Tools. Again, perform the following steps:

  1. On the Components Setup screen, in the Instance Components panel, select the PG Instance component. Click Edit.
  2. In the Peripheral Gateways Properties screen, click Media Routing. Click Next.
  3. Click Yes at the prompt to stop the service.
  4. From the Peripheral Gateway Component Properties screen, click Add, select the next PIM, and configure with the Client Type of Media Routing with the following steps:
    1. Check Enabled.
    2. In the Peripheral Name field, enter “Media Routing”.
    3. In the Peripheral ID field, enter the Peripheral ID for the unused Multichannel peripheral that you completed in previous step.
    4. For Application Hostname (1), enter the hostname of the b+s Routing Adapter server A.
    5. By default, b+s Routing Adapter accepts the MR connection on Port 7021. The Application Connection Port (1) setting must match the port setting on the b+s Routing Adapter.
    6. Configure Application Hostname (2) and Application Connection Port (2) for b+s Routing Adapter server B
    7. Click OK.
  5. Accept defaults and click Next until the Setup Complete screen opens.

Add Media Classes​

Go back to the CCE Configuration Manager in Unified CCE AW-HDS-DDS and open Media Class List. Configure the Media Classes, depending on the solution (mail, chat, ticket)

  1. For Ticket
    1. Add new Media Class
    2. Name: MC_Connects_UQ_Ticket
    3. Description: Ticket routing integration for Connects
    4. Life: 300 seconds
    5. Start timeout: 30 seconds
    6. Max duration: 28800 seconds
  2. For Chat
    1. Add new Media Class
    2. Name: MC_Connects_UQ_Chat
    3. Description: Chat routing integration for Connects
    4. Life: 300 seconds
    5. Start timeout: 30 seconds
    6. Max duration: 28800 seconds
  3. For Mail
    1. Add new Media Class
    2. Name: MC_Connects_UQ_Mail
    3. Description: Mail routing integration for Connects
    4. Life: 300 seconds
    5. Start timeout: 30 seconds
    6. Max duration: 28800 seconds

UCCE Media Class List

Media Routing Domain​

When the required Media Classes are added, go to open Media Routing Domain List in CCE Configuration Manager of the Unified CCE AW-HDS-DDS. Create the Media Routing Domains, depending on the solution (mail, chat, ticket)

  1. For Ticket

    1. Add new Media Routing Domain
    2. Name: MRD_Connects_UQ_Ticket
    3. Media routing domain ID: is assigned by the system
    4. Media Class: MC_Connects_UQ_Ticket
    5. Task Life: (already filled with default from Media Class)
    6. Task Start timeout: (already filled with default from Media Class – recommended: 5 sec)
    7. Task Max duration: (already filled with default from Media Class)
    8. Calls in Queue Max: <empty>
    9. Calls in Queue Max per call type: <empty>
    10. Calls in Queue Max time in queue: <empty>
    11. Service level threshold: 30 (default)
    12. Service level type: Ignore Abandoned Calls
    13. Interruptible: <not selected>
    14. Description: <empty>

  2. For Chat

    1. Add new Media Routing Domain
    2. Name: MRD_Connects_UQ_Chat
    3. Media routing domain ID: is assigned by the system
    4. Media Class: MC_Connects_UQ_Chat
    5. Task Life: (already filled with default from Media Class)
    6. Task Start timeout: (already filled with default from Media Class – recommended: 5 sec)
    7. Task Max duration: (already filled with default from Media Class)
    8. Calls in Queue Max: <empty>
    9. Calls in Queue Max per call type: <empty>
    10. Calls in Queue Max time in queue: <empty>
    11. Service level threshold: 30 (default)
    12. Service level type: Ignore Abandoned Calls
    13. Interruptible: <not selected>
    14. Description: <empty>

  3. For Mail

    1. Add new Media Routing Domain
    2. Name: MRD_Connects_UQ_Mail
    3. Media routing domain ID: is assigned by the system
    4. Media Class: MC_Connects_UQ_Mail
    5. Task Life: (already filled with default from Media Class)
    6. Task Start timeout: (already filled with default from Media Class – recommended: 5 sec)
    7. Task Max duration: (already filled with default from Media Class)
    8. Calls in Queue Max: <empty>
    9. Calls in Queue Max per call type: <empty>
    10. Calls in Queue Max time in queue: <empty>
    11. Service level threshold: 30 (default)
    12. Service level type: Ignore Abandoned Calls
    13. Interruptible: <not selected>
    14. Description: <empty>

UCCE Media Routing Domain List

Please write the configured Media Routing Domain ID’s down. You will need these ID’s later during the installation process of the software.

Define Application Path and add Application Path Members​

In the Unified CCE AW-HDS-DDS open Application Path List in the CCE Configuration Manager, select the Application Path xxxx.UQ.Desktop that represents your Finesse desktop. xxxx is the “Logical Controller ID” or your voice PG. For example:

  • Application Instance: UQ.Desktop
  • Peripheral gateway: CUCM_PG
  • Name: 5000.UQ.Desktop (cisco_voice PG)
  1. Add Application Path Members (for Ticket Domain if configured in the previous steps)
    1. Peripheral: <select your voice Peripheral>
    2. Media routing domain: MRD_Connects_UQ_Ticket
  2. Add Application Path Members (for Mail domain if configured in the previous steps)
    1. Peripheral: <select your voice Peripheral>
    2. Media routing domain: MRD_Connects_UQ_Chat
  3. Add Application Path Members (for Mail Domain if configured in the previous steps)
    1. Peripheral: <select your voice Peripheral>
      1. Media routing domain: MRD_Connects_UQ_Mail

UCCE Application Path List

Configure Dialed Number / Script Selector​

Next, open CCE Configuration Manager > Dialed Number / Script Selector List on Unified CCE AW-HDS-DDS. Click New to create a new Script Selector

  1. Script Selector for Ticket:

    1. Routing Client: Connects MR (Routing client configured in previous step)
    2. Media Routing Domain: MRD_Connects_UQ_Ticket (media routing domain configured in previous step)
    3. Dialed Number String: <dialed number string configured in RoutingAdapter.ini>
    4. Call Type: Call Type configured in previous step

  2. Script Selector for Chat

    1. Routing Client: Connects MR (Routing client configured in previous step)
    2. Media Routing Domain: MRD_Connects_UQ_Chat (media routing domain configured in previous step)
    3. Dialed Number String: <dialed number string configured in RoutingAdapter.ini>
    4. Call Type: Call Type configured in previous step

  3. Script Selector for Mail

    1. Routing Client: Connects MR (Routing client configured in previous step)
    2. Media Routing Domain: MRD_Connects_UQ_Mail (media routing domain configured in previous step)
    3. Dialed Number String: <dialed number string configured in RoutingAdapter.ini>
    4. Call Type: Call Type configured in previous step

Configure Skill Group​

If media task routing is Skill Group based, open CCE AW-HDS-DDS open CCE Configuration Manager > Skill Group Explorer. Click New to create the new Skill Group. For Media Routing Domain, select one of the Task Routing MRDs you created. Assign agents to the skill group.

PCCE Configuration​

For the PCCE configuration you need:

  • Unified CCE Administration (web application) at https://<FQDN>/cceadmin
  • Configuration Manager on Unified CCE AW-HDS-DDS
  • Script Editor on Unified CCE AW-HDS-DDS or Internet Script Editor
  • Peripheral Gateway Setup on the Cisco Unified CCE PG server

The following configuration steps are required:

  • Determine the Peripheral ID for a Multichannel peripheral
  • Set up the Media Routing PG and PIM
  • Add b+s RoutingAdapter server(s) as External Machine(s)
  • Add Media Routing Domain
  • Define Application Path
  • Configure Call Type
  • Configure Dialed Number / Script Selector
  • Configure Skill Group
  • Labels
  • CCE Script for Media Routing

Determine the Peripheral ID for a Multichannel peripheral​

Navigate to Unified CCE Administration > System > Peripheral Gateways. Determine the Peripheral ID for a Multichannel peripheral that is unused.

note

PCCE has three pre-defined MR PIMs

  • Multichannel: pre-defined for ECE
  • Multichannel 2: pre-defined for Social Miner
  • Multichannel 3: pre-defined for 3rd party integration,

b+s Media Routing use Multichannel 3

PCCE Peripheral Gateways

Set up the Media Routing PG and PIM​

On the Cisco Unified CCE PG server: from Cisco Unified CCE Tools, select Peripheral Gateway Setup.

  1. On the Components Setup screen, in the Instance Components panel, select the PG Instance component. Click Edit.
  2. In the Peripheral Gateways Properties screen, click Media Routing. Click Next.
  3. Click Yes at the prompt to stop the service.
  4. From the Peripheral Gateway Component Properties screen, click Add, select the next PIM, and configure the Media Routing Client Type as follows.
    1. Check Enabled.
    2. In the Peripheral Name field, enter “Media Routing”.
    3. In the Peripheral ID field, enter the Peripheral ID for the unused Multichannel peripheral that you identified in previous step.
    4. For Application Hostname (1), enter the hostname of the b+s Routing Adapter server A.
    5. By default, b+s Routing Adapter accepts the MR connection on Port 7021. The Application Connection Port (1) setting must match the port setting on the Media Manager.
    6. Configure Application Hostname (2) and Application Connection Port (2) for b+s Routing Adapter server B
    7. Click OK.
  5. Accept defaults and click Next until the Setup Complete screen opens.

Add b+s RoutingAdapter server(s) as External Machine(s)​

Navigate to Unified CCE Administration > System > Deployment and add b+s Routing Adapter servers as External Machines (3rd Party Multichannel)

Add Media Classes​

On the Unified CCE AW-HDS-DDS open CCE Configuration Manager > Media Class List. Configure the Media Classes, depending on the solution (mail, chat, ticket)

  1. For Ticket
    1. Add new Media Class
    2. Name: MC_Connects_UQ_Ticket
    3. Description: Ticket routing integration for Connects
    4. Life: 300 seconds
    5. Start timeout: 30 seconds
    6. Max duration: 28800 seconds
  2. For Chat
    1. Add new Media Class
    2. Name: MC_Connects_UQ_Chat
    3. Description: Chat routing integration for Connects
    4. Life: 300 seconds
    5. Start timeout: 30 seconds
    6. Max duration: 28800 seconds
  3. For Mail
    1. Add new Media Class
    2. Name: MC_Connects_UQ_Mail
    3. Description: Mail routing integration for Connects
    4. Life: 300 seconds
    5. Start timeout: 30 seconds
    6. Max duration: 28800 seconds

PCCE Media Class List

Add Media Routing Domain​

When the required Media Classes are added, open Media Routing Domain List in CCE Configuration Manager of the Unified CCE AW-HDS-DDS. Configure the Media Routing Domains, depending on the solution (mail, chat, ticket)

  1. For Ticket
    1. Add new Media Routing Domain
    2. Name: MRD_Connects_UQ_Ticket
    3. Media routing domain ID: is assigned by the system
    4. Media Class: MC_Connects_UQ_Ticket
    5. Task Life: (already filled with default from Media Class)
    6. Task Start timeout: (already filled with default from Media Class – recommended: 5 sec)
    7. Task Max duration: (already filled with default from Media Class)
    8. Calls in Queue Max: <empty>
    9. Calls in Queue Max per call type: <empty>
    10. Calls in Queue Max time in queue: <empty>
    11. Service level threshold: 30 (default)
    12. Service level type: Ignore Abandoned Calls
    13. Interruptible: <not selected>
    14. Description: <empty>
  2. For Chat
    1. Add new Media Routing Domain
    2. Name: MRD_Connects_UQ_Chat
    3. Media routing domain ID: is assigned by the system
    4. Media Class: MC_Connects_UQ_Chat
    5. Task Life: (already filled with default from Media Class)
    6. Task Start timeout: (already filled with default from Media Class – recommended: 5 sec)
    7. Task Max duration: (already filled with default from Media Class)
    8. Calls in Queue Max: <empty>
    9. Calls in Queue Max per call type: <empty>
    10. Calls in Queue Max time in queue: <empty>
    11. Service level threshold: 30 (default)
    12. Service level type: Ignore Abandoned Calls
    13. Interruptible: <not selected>
    14. Description: <empty>
  3. For Mail
    1. Add new Media Routing Domain
    2. Name: MRD_Connects_UQ_Mail
    3. Media routing domain ID: is assigned by the system
    4. Media Class: MC_Connects_UQ_Mail
    5. Task Life: (already filled with default from Media Class)
    6. Task Start timeout: (already filled with default from Media Class – recommended: 5 sec)
    7. Task Max duration: (already filled with default from Media Class)
    8. Calls in Queue Max: <empty>
    9. Calls in Queue Max per call type: <empty>
    10. Calls in Queue Max time in queue: <empty>
    11. Service level threshold: 30 (default)
    12. Service level type: Ignore Abandoned Calls
    13. Interruptible: <not selected>
    14. Description: <empty>

PCCE Media Routing Domain List

Alternatively, navigate to Unified CCE Administration > Manage >Media Routing Domains and click on New. Configure Name, for example “Case”, and select Interruptible if required.

Please write the configured Media Routing Domain ID’s down. You will need these ID’s later during the software installation process.

Define Application Path and add Application Path Members​

In the Unified CCE AW-HDS-DDS, open Application Path List in the CCE Configuration Manager. Select Application Path xxxx.UQ.Desktop that represents your Finesse desktop. xxxx is the “Logical Controller ID” or your voice PG. Example

  • Application Instance: UQ.Desktop
  • Peripheral gateway: CUCM_PG
  • Name: 5000.UQ.Desktop (cisco_voice PG)
  1. Add Application Path Members (for Ticket Domain if configured in the previous steps)
    1. Peripheral: <select your voice Peripheral>
    2. Media routing domain: MRD_Connects_UQ_Ticket
  2. Add Application Path Members (for Mail domain if configured in the previous steps)
    1. Peripheral: <select your voice Peripheral>
    2. Media routing domain: MRD_Connects_UQ_Chat
  3. Add Application Path Members (for Mail Domain if configured in the previous steps)
    1. Peripheral: <select your voice Peripheral>
    2. Media routing domain: MRD_Connects_UQ_Mail

PCCE Application Path List

Configure Call Type​

When the Application Paths are configured, open Unified Call Type List in the CCE Configuration Manager. Click New to create a new Call Type. For each Call Type configure a Call type name and define a Call Type ID (unique value).

PCCE Call Type List

Configure Dialed Number / Script Selector​

Navigate to Unified CCE Administration > Manage > Dialed Number. Click New to create the new Script Selector

  • Dialed Number String: <dialed number string configured in RoutingAdapter.ini>
  • Routing Type: 3rd Party Multichannel
  • Media Routing Domain: the media routing domain configured in previous step
  • Call Type: the Call Type configured in previous step

Configure Skill Group​

Navigate to Unified CCE Administration > Manage > Skill Groups. Click New to create Skill Group for Media Routing

  • Name: <name of Skill Group>
  • Media Routing Domain: the media routing domain configured in previous step

CCE Script​

Labels​

With UCCE, you can configure global predefined labels that can be used in the different UCCE routing scripts, or you can use Dynamic Labels in the CCE routing script. With PCCE, it is not possible to configure global predefined labels that can be used in the different PCCE routing scripts. For each routing script, the labels must be configured directly in the script editor as Dynamic Labels.

PCCE Dynamic Labels

The RoutingAdapter is able to handle labels received from CCE routing script.

LabelDescription
OverflowToo many tasks in queue – a task will be rerouted after n seconds (configurable with OverflowDefaultTimeInSec-parameter).
Overflow_<WaitTimeMin>Too many tasks in queue – a task will be rerouted after <WaitTimeMin>_minutes (e.g. OVERFLOW_90 initiates reroute after 90 minutes).
ErrorRouting error, cannot be recovered, do not try to reroute again
EndDelete Task. Do not try to reroute again. No Failure is written.
TimeoutNo agent found – task is rerouted immediately.

CCE Script​

A Script Editor on Unified CCE AW-HDS-DDS or Internet Script Editor. Sample Script to route media tasks:

CCE Script for Media Routing

Time in Queue / CCE Script Wait node​

After the task is queued, a Wait node is called with a time lower than the system limit (Max-TimeInQueue)

MaxTimeInQueue​

The maximum duration of queued tasks of both Routers have to be increased from the default 3600 seconds up to 432'000 seconds (5 days) in the registry (HLM\SW\cisco...\<instance>\RouterA\Router\CurrentVersion\Configuration\Queuing\MaxTimeInQueue).

The settings on the PGs are not relevant in this case and can be kept as they are. The Wait within the script before the task timeout has to be shorter than the MaxTimeInQueue and should be set to a maximum value of 430'000 to ensure the script returns with the Timeout label and is not terminated by the MaxTimeInQueue value.

MaxCalls & MaxCallsPerCallType​

The maximum number of calls and tasks summarized for all queues (MaxCalls) and the allowed amount of calls or tasks per CallType (MaxCallsPerCallType) may be easily exceeded with Media Routing (default = 10’000) and cause overflows. These two settings should also be changed in the registry to a value that is expected for the customers contact center (HLM\SW\cisco...\<instance>\RouterA\Router\CurrentVersion\Configuration\Queuing\...)

Last updated on