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