Have an account?

  •   Personalized content
  •   Your products and support

Need an account?

Create an account

System Configuration Guide for Cisco Unified Communications Manager, Release 11.5(1)

Book Contents
Find Matches in This Book
Available Languages
Download Options

Book Title

System Configuration Guide for Cisco Unified Communications Manager, Release 11.5(1)

Chapter Title

Configure Hunt Pilots

Results

Updated:
December 10, 2018

Chapter: Configure Hunt Pilots

Configure Hunt Pilots

Hunt Pilot Overview

Hunt pilots are strings of digits and wildcards that the system uses to route calls to directory numbers (DNs). Hunt pilots work in conjunction with hunt lists, which are prioritized lists of eligible paths (line groups) for incoming calls. When a call is placed to a hunt pilot DN, the system offers the call to the first line group specified in the hunt list. If no one in the first line group answers the call, the system offers the call to the next line group specified in the hunt list. Line groups control the order in which the call is distributed to phones within the group. They point to specific extensions, which are typically IP phone extensions or voicemail ports. Line groups cannot point to Computer Telephony Integration (CTI) ports and CTI route points, so you cannot use hunt pilots to distribute calls to endpoints that are controlled through CTI applications such as Cisco Customer Response Solution (CRS) or IP Interactive Voice Response (IP IVR).

A hunt pilot can distribute calls to any of its assigned line groups, even if the line groups and the hunt pilot reside in different partitions. A call distributed by the hunt pilot overrides all the partitions and calling search space restrictions.

Hunt Pilot Configuration Task Flow

Procedure

  Command or Action Purpose
Step 1

Configure Line Groups

Create a line group to enable multiple phones to answer calls that are directed to a single directory number (DN).
Step 2

Configure Hunt Lists

Configure a hunt list to prioritize the line groups. When the system routes a call through a hunt list, it uses the line groups in the order that you define in the hunt list.

Step 3

Configure Hunt Pilots

Configure hunt pilots to specify the strings of digits and wildcards that the system uses to route calls to directory numbers (DNs).

Configure Line Groups

Create a line group to enable multiple phones to answer calls that are directed to a single directory number (DN). Line groups control the order in which an incoming call is distributed to phones within the group.

Procedure

Step 1

From Cisco Unified CM Administration, choose Call Routing > Route/Hunt > Line Group.

Step 2

Choose one of the following options:

  • To add a new line group, click the Add New button.
  • To modify the settings for an existing line group, enter the search criteria, click Find, and choose a line group from the resulting list.
The Line Group Configuration window appears.
Step 3

Configure the fields on the Line Group Configuration window. See the online help for more information about the fields and their configuration options.

Step 4

Click Save.

What to do next

Configure Hunt Lists

Configure Hunt Lists

A hunt list is a prioritized list of line groups. When the system routes a call through a hunt list, it uses the line groups in the order that you define in the hunt list.

Before you begin

Configure Line Groups

Procedure

Step 1

From Cisco Unified CM Administration, choose Call Routing > Route/Hunt > Hunt List.

Step 2

Choose one of the following options:

  • To add a new hunt list, click the Add New button.
  • To modify the settings for an existing hunt list, enter the search criteria, click Find, and choose a hunt list from the resulting list.
The Hunt List Configuration window appears.
Step 3

Configure the fields on the Hunt List Configuration window. See the online help for more information about the fields and their configuration options.

Step 4

Click Save.

What to do next

Configure Hunt Pilots

Configure Hunt Pilots

Configure hunt pilots to specify the strings of digits and wildcards that the system uses to route calls to directory numbers (DNs).

Before you begin

Configure Hunt Lists

Procedure

Step 1

From Cisco Unified CM Administration, choose Call Routing > Route/Hunt > Hunt Pilot.

Step 2

Choose one of the following options:

  • To add a new hunt pilot, click the Add New button.
  • To modify the settings for an existing hunt pilot, enter the search criteria, click Find, and choose a hunt pilot from the resulting list.
The Hunt Pilot Configuration window appears.
Step 3

Configure the fields on the Hunt Pilot Configuration window. See the online help for more information about the fields and their configuration options. For information about the wildcards and special characters that you can use, see Wildcards and Special Characters in Hunt Pilots.

Step 4

Click Save.

Wildcards and Special Characters in Hunt Pilots

Wildcards and special characters in hunt pilots allow a hunt pilot to match a range of numbers (addresses). Use these wildcards and special characters also to build instructions that enable the Cisco Unified Communications Manager to manipulate a number before sending it to an adjacent system.

The following table describes the wildcards and special characters that Cisco Unified Communications Manager supports.

Table 1. Wildcards and Special Characters

Character

Description

Examples

@

The at symbol (@) wildcard matches all National Numbering Plan numbers.

Each route pattern can have only one @ wildcard.

The route pattern 9.@ routes or blocks all numbers that the National Numbering Plan recognizes.

The following route patterns examples show National Numbering Plan numbers that the @ wildcard encompasses:

  • 0
  • 1411
  • 19725551234
  • 101028819725551234
  • 01133123456789

X

The X wildcard matches any single digit in the range 0 through 9.

The route pattern 9XXX routes or blocks all numbers in the range 9000 through 9999.

!

The exclamation point (!) wildcard matches one or more digits in the range 0 through 9.

The route pattern 91! routes or blocks all numbers in the range 910 through 91999999999999999999999.

?

The question mark (?) wildcard matches zero or more occurrences of the preceding digit or wildcard value.

The route pattern 91X? routes or blocks all numbers in the range 91 through 91999999999999999999999.

+

The plus sign (+) wildcard matches one or more occurrences of the preceding digit or wildcard value.

The route pattern 91X+ routes or blocks all numbers in the range 910 through 91999999999999999999999.

[ ]

The square bracket ([ ]) characters enclose a range of values.

The route pattern 813510[012345] routes or blocks all numbers in the range 8135100 through 8135105.

-

The hyphen (-) character, used with the square brackets, denotes a range of values.

The route pattern 813510[0-5] routes or blocks all numbers in the range 8135100 through 8135105.

^

The circumflex (^) character, used with the square brackets, negates a range of values. Ensure that it is the first character following the opening bracket ([).

Each route pattern can have only one ^ character.

The route pattern 813510[^0-5] routes or blocks all numbers in the range 8135106 through 8135109.

.

The dot (.) character, used as a delimiter, separates the Cisco Unified Communications Manager access code from the directory number.

Use this special character, with the discard digits instructions, to strip off the Cisco Unified Communications Manager access code before sending the number to an adjacent system.

Each route pattern can have only one dot (.) character.

The route pattern 9.@ identifies the initial 9 as the Cisco Unified Communications Manager access code in a National Numbering Plan call.

*

The asterisk (*) character can provide an extra digit for special dialed numbers.

You can configure the route pattern *411 to provide access to the internal operator for directory assistance.

#

The octothorpe (#) character generally identifies the end of the dialing sequence.

Ensure the # character is the last character in the pattern.

The route pattern 901181910555# routes or blocks an international number that is dialed from within the National Numbering Plan. The # character after the last 5 identifies this digit as the last digit in the sequence.

\+

A plus sign preceded by a backslash, that is, \+, indicates that you want to configure the international escape character +.

Using \+ means that the international escape character + is used as a dialable digit, not as a wildcard.

Performance and Scalability for Hunt Pilots

The following performance and scalability restrictions apply:

  • A single Unified CM Cluster supports a maximum of 15,000 hunt list devices.

  • A single Unified CM Subscriber supports a maximum of 100 hunt pilots with call queuing enabled per node

  • Hunt list devices may be a combination of 1500 hunt lists with ten IP phones in each hunt list, 750 hunt lists with twenty IP phones in each hunt list, or similar combinations


    Note

    When using the broadcast algorithm for call coverage, the number of hunt list devices is limited by the number of busy hour call attempts (BHCA). Note that a BHCA of 10 on a hunt pilot pointing to a hunt list or hunt group containing 10 phones and using the broadcast algorithm is equivalent to 10 phones with a BHCA of 10.

  • The maximum number of simultaneous callers in queue for each hunt pilot that you can configure ranges from 1 to 100 (default 32).

  • The maximum wait time in queue for each hunt pilot that you can configure ranges from 0 to 3600 seconds (default 900). An increase in the number of hunt lists can require you to increase the dial plan initialization timer that is specified in the Unified Communications Manager service parameters. We recommend that you set the dial plan initialization timer to 600 seconds if you have 1500 hunt lists configured.

  • We recommend having no more than 35 directory numbers for a single line group when using broadcast algorithms with call queuing. Additionally, the number of broadcast line groups depends on the busy hour call completion rate (BHCC). If there are multiple broadcast line groups in a Unified CM system, the number of maximum directory numbers in a line group must be less than 35. The number of busy hour call attempts (BHCA) for all the broadcast line groups should not exceed 35 calls set up per second.

Hunt Pilot Interactions and Restrictions

Table 2.

Feature

Interactions and Restrictions

Single Number Reach with Hunt Groups

If you have a hunt group configured and one or more of the directory numbers that the hunt group points toward also has Single Number Reach (SNR) enabled, the call does not extend to the SNR remote destinations unless all devices in the hunt group are logged in.

For each device within the hunt group, the Logged Into Hunt Group check box must be checked within the Phone Configuration window for that device.

Calls Not Being Distributed

Calls are not being distributed with circular algorithm:

Restriction

Description

Calls are not being distributed correctly in Circular algorithm for a line group with BOT and TCT devices.

When a call is extended to an agent who is in a logged off state and the call is rejected with a different reject type other than the "Huntlogout" type. Then the index will not get incremented and the call will go to the same agent who had answered the previous call.

Calls are not distributed correctly in Circular algorithm for a line group.

While distributing the calls in a circular algorithm, when an agent is busy, the call is extended to the next available agent (i.e. the next agent will answer the call on behalf of the busy agent).

Note 

In the case of multiple calls at the same time, the next available agent answers the call.

Was this Document Helpful?

FeedbackFeedback

Contact Cisco

Related Cisco Community Discussions

About Us
Contact Us
Work with Us