To create a hunt
group for phones in a Cisco Unified Communications Manager Express (Cisco
Unified CME) or Cisco Unified Session Initiation Protocol (SIP) Survivable
Remote Site Telephony (SRST) system, use the
voice
hunt-group command in global configuration mode.
To delete a hunt group, use the
no form of
this command.
voice hunt-group hunt-tag {longest-idle | parallel | peer | sequential}
no voice hunt-group hunt-tag
Syntax Description
hunt-tag
|
Unique
sequence number that identifies the hunt group. Range is 1 to 100.
|
longest-idle
|
Allows
an incoming call to go first to the number that has been idle the longest for
the number of hops specified when the hunt group was defined. The longest-idle
time is determined from the last time that a phone registered, reregistered, or
went on-hook.
|
parallel
|
Allows
an incoming call to simultaneously ring all the numbers in the hunt group
member list.
|
peer
|
Allows
a round-robin selection of the first extension to ring. Ringing proceeds in a
circular manner from left to right. The round-robin selection starts with the
number left of the number that answered when the hunt-group was last called.
|
sequential
|
Allows
an incoming call to ring all the numbers in the left-to-right order in which
they were listed when the hunt group was defined.
|
Command Default
By default, voice
hunt group is not created.
Command Modes
Global configuration (config)
Command History
Cisco
IOS Release
|
Cisco
Product
|
Modification
|
12.4(4)T
|
Cisco
CME 3.4
|
This
command was introduced.
|
12.4(15)XZ
|
Cisco
Unified CME 4.3
|
This
command was modified to add support for Cisco Unified SCCP IP phones.
|
12.4(20)T
|
Cisco
Unified CME 7.0
|
This
command was integrated into Cisco IOS Release 12.4(20)T.
|
15.2(4)M
|
Cisco
Unified SIP SRST 9.1
|
This
command was introduced in Cisco Unified SIP SRST 9.1.
|
15.3(4)M
|
Cisco
Unified CME 10.5
|
This
command was modified to include support for wildcards which is indicated by "*" . symbol.
|
Usage Guidelines
The
voice
hunt-group command enters voice hunt-group
configuration mode to define a hunt group. A hunt group is a list of phone
numbers that take turns receiving incoming calls to a specific number (pilot
number), which is defined with the
pilot
command. The specific extensions included in the hunt group and the order and
maximum number of extensions allowed in the list are defined with the
list
command.
If a number in
the list is busy or does not answer, the call is redirected to the next number
in the list. The last number tried is the final number, which is defined with
the
final
command. If the number of times that a call is redirected to a new number
exceeds 5, you must use the
max-redirect
command to increase the allowable number of redirects in the
Cisco Unified CME or Cisco Unified SIP SRST system.
To configure a
new hunt group, you must specify the
longest-idle ,
parallel ,
peer , or
sequential
keyword. To change an existing hunt group configuration, the
keyword is not required. To change the type of hunt group, for instance from
peer to sequential or sequential to peer, you must remove the existing hunt
group first by using the
no form of
this command and then re-create it.
The
parallel
keyword creates a dial peer to allow an incoming call to ring multiple phones
simultaneously. The use of parallel hunt groups is also referred to as
application-level forking because it enables the forking of a call to multiple
destinations. A pilot dial peer cannot be used as a voice hunt group and a hunt
group at the same time.
While ephone
hunt groups only support Cisco Unified SCCP IP phones, a voice hunt group
supports either a Cisco Unified SCCP IP phone or a Cisco Unified SIP IP phone.
With the voice
hunt group feature preconfigured in the Cisco Unified SIP SRST router, voice
hunt groups continue to be supported after phones fallback from a Cisco Unified
Communications Manager (Cisco Unified CM) to a Cisco Unified SIP SRST router.
Examples
The following
example shows how to define longest-idle hunt group 1 with pilot number 7501,
final number 8000, and nine numbers in the list. After a call is redirected six
times (makes 6 hops), it is redirected to the final number 8000.
Router(config)# voice hunt-group 1 longest-idle
Router(config-voice-hunt-group)# pilot 7501
Router(config-voice-hunt-group)# list 7001, 7002, 7023, 7028, 7045, 7062, 7067, 7072, 7079
Router(config-voice-hunt-group)# final 8000
Router(config-voice-hunt-group)# hops 6
Router(config-voice-hunt-group)# timeout 20
Router(config-voice-hunt-group)# exit
The following
example shows how to define peer hunt group number 2. Callers dial the pilot
number 5610 to reach the hunt group. The first extension to ring the first time
that this hunt group is called is 5601. If 5601 does not answer, the hunt
proceeds from left to right, beginning with the extension directly to the
right. If none of those extensions answer, the call is forwarded to extension
6000, which is the number for the voice-mail service.
The second time
someone calls the hunt group, the first extension to ring is 5602 if 5601 was
answered during the previous call.
Router(config)# voice hunt-group 2 peer
Router(config-voice-hunt-group)# pilot 5610
Router(config-voice-hunt-group)# list 5601, 5602, 5617, 5633
Router(config-voice-hunt-group)# final 6000
Router(config-voice-hunt-group)# timeout 30
Router(config-voice-hunt-group)# exit
The following
example shows how to define sequential hunt group number 3. When callers dial
extension 5601, the first phone to ring is 5001, then 5002, 5017, and 5028. If
none of those extensions answer, the call is forwarded to extension 6000, which
is the number for the voice-mail service.
Router(config)# voice hunt-group 3 sequential
Router(config-voice-hunt-group)# pilot 5601
Router(config-voice-hunt-group)# list 5001, 5002, 5017, 5028
Router(config-voice-hunt-group)# final 6000
Router(config-voice-hunt-group)# timeout 30
Router(config-voice-hunt-group)# exit
The following
example shows how to define a parallel hunt group. When callers dial extension
1000, extensions 1001, 1002, and so forth ring simultaneously. The first
extension to answer is connected. All other call legs are disconnected. If none
of the extensions answer, the call is forwarded to extension 2000, which is the
number for the voice-mail service.
Router(config)# voice hunt-group 4 parallel
Router(config-voice-hunt-group)# pilot 1000
Router(config-voice-hunt-group)# list 1001, 1002, 1003, 1004
Router(config-voice-hunt-group)# final 2000
Router(config-voice-hunt-group)# timeout 20
Router(config-voice-hunt-group)# exit
The following
example shows the support for wildcard slots in voice hunt-groups.
Router(config)#Voice hunt-group 1 parallel
Router(config-voice-hunt-group)#pilot number 100
Router(config-voice-hunt-group)#List 1001, 1002, 1002, *, *
Router(config-voice-hunt-group)# exit