Programming Avaya Aura Call Vectors
Programming Avaya Aura Call Vectors
Call Center
6.0
June 2010
server platforms.
Associated application documentation
The most recent application documentation for Communication Manager and Avaya Call
Management System is available on the Avaya Support web site: http://www.avaya.com/
support.
Related documents
14 Programming Call Vectors in Avaya Aura
Call
Center Implementation document.
Limitations of traditional ACD call processing
Programming Call Vectors in Avaya Aura
Call Center
Feature Reference)
Dial-ahead digit vector examples (SeeAvaya Aura
Call
Center Feature Reference. )
Queue calls to up to three splits
simultaneously, consequently
improving the average speed
of answer and agent
productivity.
Customer service center on page 42
Example application - distributed call centers on page
48
Multiple split queuing on page 283
Implement routing to local or
distant destinations.
Customer service center on page 42
Example application - mutual fund company on page
45
Example application - distributed call centers on page
48
Example application - help desk on page 50
About interflow routing on page 297
Using Call Prompting to route by collected digits (See the
Avaya Aura
Call
Center Feature Reference. )
Information Collection
Provide customized or
personalized call treatment
using information collection
and messaging.
Automated attendant on page 43
Example application - mutual fund company on page
45
Example application - help desk on page 50
Using Call Prompting to route by collected digits
(SeeAvaya Aura
Call
Center Feature Reference. )
Dial-ahead digit vector examples (SeeAvaya Aura
Call
Center Feature Reference. )
Collect information for use by
an adjunct or by agent display.
Example application - help desk on page 50
Passing digits to an adjunct (See Avaya Aura
Call Center
Feature Reference)
Collect caller-entered or
customer database-provided
CINFO digits from the network.
CINFO vector example on page 167
Call Vectoring overview
20 Programming Call Vectors in Avaya Aura
Call Center
Implementation document.
The number of staffed agents in a split
The number of available agents in a split
The number of calls queued at a given priority to a split
The amount of time that the oldest call has been waiting in a split
Whether or not a call receives special holiday processing
The Average Speed of Answer for a split or a VDN
The Expected Wait Time for a split or for a call that has entered vector processing
A reduction in Expected Wait Time if a call is queued to a backup resource
The number of calls in a queue that are eligible for interflow processing using interflow
q-pos.
The number of active calls that have been routed by a VDN
The caller identity (ANI)
The type of originating line (II-digits)
The digits entered by the caller, sent in a message from the network (CINFO), or received
from an ASAI or VRU adjunct
The time-of-day and day of the week that the call is placed. The syntax for this condition
can be illustrated as follows: mon 8:01 to fri 17:00 means anytime between 8:01 a.m.
Monday through 5:00 p.m. Friday, and all 17:00 to all 8:00 means between 5:00 p.m. and
8:00 a.m. on any day of the week.
Depending on the condition, specific comparison operators and a threshold might be in effect.
Examples of comparison operators are < (less than), > (greater than), = (equal to), <= (less
than or equal to), >= (greater than or equal to), <> (not equal to), and in or not-in. A threshold is a
range of accepted numerical entries.
The sections on the Call Vectoring features illustrate condition checking in more detail.
Programming capabilities
Programming Call Vectors in Avaya Aura
Communication Manager.
The following sections give examples of how the vectors must be set up at each site to use
the public network with NCR (as opposed to IP trunking) to route a call from one site to another.
For information about administering BSR polling over IP, see Avaya Aura
Communication Manager
Feature Description.
The Communication Manager always returns four digits for the tod variable. This includes
leading zeros where appropriate. Any comparison to the tod variable is also formatted as four
digits. If you want to check when the tod variable is after 12:30AM, you should compare to
0030, not 30.
Scope
The scope for the tod variable is only global.
Example
In the following example vector step, if D is the tod type variable, this step verifies the current
time of day.
goto step 32 if D >= 1655
This example verifies that the time of day is 4:55 p.m. If the time of day is 5 minutes before
closing, the call is routed to step 32. Step 32 could be an announcement step indicating that
the call center has closed.
Understanding local and global variables
Programming Call Vectors in Avaya Aura
INFO-2
ANI /II-digits routing and Caller Information Forwarding (CINFO)
Programming Call Vectors in Avaya Aura
Communication Manager Feature Description and Implementation, for more information about
announcements.
Step 3: Repeating delay announcement and feedback
The announcement vector provides feedback to the caller after the call is queued. However,
if the announcement is played and the agent does not answer the call soon after the
announcement is complete, further feedback or treatment becomes necessary. One solution
is provided in the following Call Vector example.
Repeating delay announcement and feedback
Page 1 of 1
CALL VECTOR
Number: 27 Name: base Multimedia? n Lock? n
Multimedia? n Attendant Vectoring? n Meet-me Conf? n Lock? y
Basic? y EAS? n G3V4 Enhanced? n ANI/II-Digits? n ASAI Routing? n
Prompting? n LAI? n G3V4 Adv Route? n CINFO? n BSR? y Holidays? y
01 queue-to split 5 pri l
02 wait-time 10 seconds hearing ringback
03 announcement 2771
04 wait-time 60 seconds hearing music
05 goto step 3 if unconditionally
06 _______________
07 _______________
08 _______________
09 _______________
10 _______________
11 _______________
The wait-time command in step 4 of this vector provides additional feedback (music) to the
caller. If the call is not answered by the time step 4 is complete, the goto step command in
step 5 is processed.
Related topics:
Conditional branching on page 187
Conditional branching
Up to this point, we have discussed and illustrated Call Vectoring commands that cause
sequential flow, that is, the passing of vector processing control from the current vector step
Creating and constructing a vector
Programming Call Vectors in Avaya Aura
Call Center Feature Reference. Therefore, there is no need to include vector steps to insure
that pre-allocated queue slots in a hunt group have not been exhausted. However, the same
approach you used to determine queue slot exhaustion in releases previous to 2.1 can be used
to limit the number of calls that are put into queue. The existing vector steps that checked for
exhaustion also serve as queue-limiting vectors as is, or modified to limit a different number
of calls. The following vector example describes provisions for checking or limiting the number
of calls that queue to a split/skill or hunt group.
Limiting number of queued calls
Page 1 of 1
CALL VECTOR
Number: 27 Name: base Multimedia? n Lock? n
Multimedia? n Attendant Vectoring? n Meet-me Conf? n Lock? y
Basic? y EAS? n G3V4 Enhanced? n ANI/II-Digits? n ASAI Routing? n
Prompting? n LAI? n G3V4 Adv Route? n CINFO? n BSR? y Holidays? y
01 goto step 10 if calls-queued in split 5 pri l > 20
02 queue-to split 5 pri l
03 wait-time 10 seconds hearing ringback
04 announcement 2771
05 wait-time 10 seconds hearing music
06 check split 7 pri m if calls-queued < 5
07 wait-time 60 seconds hearing music
08 announcement 2881
Creating and constructing a vector
Programming Call Vectors in Avaya Aura
Call
Center Features.
Upgrading to a Call Vectoring environment
If you are already equipped with ACD and want to use Call Vectoring, the ACD environment
must be upgraded to a Call Vectoring environment. This involves installing VDNs, vectors and
hunt groups for the desired Call Vectoring feature(s).
The set of guidelines that follows is intended to serve as a general procedure for upgrading
to a Call Vectoring environment.
1. Verify the vector options on the Customer Option screen.
2. Add the VDNs.
3. Evaluate the number of queue slots assigned to each split.
Usually, you want to assign enough queue slots to allow all calls processed by Call
Vectoring to be queued. For more details, see the considerations for Basic Call
Vectoring in Considerations for the vectoring features in the Avaya Aura
Call
Center Feature Reference document.
4. Change hunt-groups to be vector-controlled.
5. Administer the vectors and at least one test hunt group.
Vector management and monitoring
200 Programming Call Vectors in Avaya Aura
Call
Center Feature Reference document.
For a call that is covered to a VDN, the command is treated like a route-to with
coverage=n command. A covered call that is routed by an adjunct routing link
command to a destination that has Call Forwarding activated is not further redirected (since
the call has already been redirected by coverage).
For LAI or Network ISDN features, the adjunct routing link command is considered a
neutral vector command in all cases. However, the command is usually followed by an
announcement or wait-time command, each of which is a call acceptance command. The
G3V4 wait-time hearing i-silent command can be used when a neutral wait-
time command is required to allow the adjunct to accept or reject the call.
If an announcement command follows a failed adjunct routing link command, the
announcement is interrupted. If the adjunct routing link command succeeds (that is,
the server receives a destination from the ASAI adjunct), the announcement terminates
immediately.
If an ASAI adjunct has supplied dial-ahead digits for a collect digits step, and the vector
processes a collect ced digits or collect cdpd digits step, the ASAI supplied
dial-ahead digits are discarded without notification to the adjunct.
If a TTR is connected to a call because an ASAI adjunct has requested digit collection, and
the vector processes a collect ced digits or collect cdpd digits step, the TTR is
disconnected from the call.
adjunct routing link command interactions with Avaya IQ
The ability to report on information associated with use of the adjunct routing link
command is not currently supported. Support for reporting on this command is planned for a
future Avaya IQ release.
adjunct routing link command interactions with CMS
Adjunct routing attempts are stored in the ADJATTEMPTS database item and reported as
Adjunct Routing Attempts in standard reports. If the call is queued to a split/skill when the
adjunct routing link command is encountered, the step is skipped, and no messages
are sent to CMS. Accordingly, Adjunct Routing Attempts is not reported for this call.
adjunct routing link command
Programming Call Vectors in Avaya Aura
Communication
Manager.
Recording announcements using .wav files
Using .wav files for recording provides the best quality and the most flexibility and reliability.
Use a PC recording application such as Microsoft Sound Recorder to create a CCITT m-
Law (for U.S.) or A-Law, 8 KHz, 8-bit mono format .wav file.
Use a file name with up to 27 characters without blanks.
Transfer the file to the VAL announcement source using FTP. Avaya recommends Voice
Announcement Manager.
Administer the .wav file name (less the .wav extension) to an announcement extension
on the announcement/audio sources screen.
Recording announcements using a telephone
You can also record announcements already defined on the announcement/audio sources
screen directly to the VAL source assigned to the announcement extension.
Using a Communication Manager system telephone with a console class of service
(COS), dial the assigned announcement access feature access code (FAC).
For the best quality and functionality, use a DCP or IP phone.
announcement command for Call Vectoring
Programming Call Vectors in Avaya Aura
Communication Manager.
Get the best audio quality by using a DCP phone directly connected to the same gateway
that contains the VAL source or in the same port network multi-connect grouping.
Do not use remote or branch phone connections that route over Inter-Gateway Alternate
Routing (IGAR)-supported facilities because the beginning portion of the announcement
can get clipped and not recorded.
Considerations for DTMF Transfer and Connect applications
Consider the following when recording DTMF for Transfer and Connect applications:
Record the announcement using an analog telephone or a good quality DTMF touch tone
keypad that has a direct electrical connection.
Do not exceed 6.25 digits per second when generating the DTMF digits that are recorded.
For DTMF signaling to the Network, the Call Center/PBX DTMF generation must send
DTMF tones with at least 80ms of digit duration and 80ms of inter-digit silence, and include
a pause of at least 350ms between the *8 and the redirection number. The lower and
upper bounds are 300ms - 11 seconds.
Minimize or prevent the recording of any noise or periods of silence.
It is not possible to record DTMF tones using IP phones or to record H.248 Media Gateway
VVAL announcement sources using any type of telephone. Instead, you can do any of the
following options:
Record DTMF to port network TN2501 VAL boards using an analog telephone connected
to the same port network. You can transfer the created wave files to H.248 Media Gateway
VVAL sources as required.
Record the DTMF tones using a commercially-available PC software tool, such as Vox
Studio. You can transfer the saved wave file to the desired Media Gateways.
Call Vectoring commands
224 Programming Call Vectors in Avaya Aura
Call
Center Feature Reference document.
goto ...if time-of-
day
Uses the time adjustments from the VDN Timezone
Offset and DST fields on the VDN screen.
goto ...if holiday Does not use time adjustments. The system time clock
as defined for the main server is used without
modification.
A time is considered to be in the table from the first second of the start time (for example,
08:00:00). Also, it is still considered to be in the table until the last second of the end time (for
example, 17:00:59).
Comparing none, # and numeric digits
How comparisons worked before vector variables
Prior to the introduction of Communication Manager 3.0, goto comparison tests using the
keywords none or # as a threshold value were supported for only the = or <> comparators. For
example:
goto step 5 if digits = none
goto step 5 if digits <> #
50
For more information about this feature, see ANI /II-digits routing and Caller Information Forwarding (CINFO) on page
155.
Call Vectoring commands
268 Programming Call Vectors in Avaya Aura
Communication Manager.
The <treatment2> parameter refers to the treatment that the caller hears after the source
specified by <extension> finishes playing, or the wait-time period expires. The <treatment2>
parameter is also provided if the caller can not be connected to the source. Failure to connect to
the source can result from conditions such as:
source not available - extension/source not assigned
source disconnected
source busy
queuing not assigned
If the <extension> source is not available when the wait step is reached in the vector one of
the following results will occur:
If <treatment2> is set to continue, the caller returns to what they were hearing before
the wait-time step.
If <treatment2> is set to music, ringback, or silence, vector processing still waits
for the specified wait-time while the caller hears <treatment2>. When the wait-time period
expires, the next step in the vector is executed, regardless of the <treatment2> setting.
The caller continues to hear <treatment2> until a subsequent step changes the treatment.
For example, if <treatment2> is set to continue, and the <extension> source (integ-
rep or continuous analog/DS1 or AUX-Trunk) is still playing, the caller continues to hear
it until a subsequent vector steps changes the treatment.
Note:
If the <extension> source stops playing or is disconnected, the caller hears silence.
If the audio/music source specified by the <extension> stops (disconnects) before the wait-
time period expires or the caller cannot be connected to that source (source not available), the
wait-time command considerations
Programming Call Vectors in Avaya Aura
Call Center
Feature Reference.
Call Vectoring commands
320 Programming Call Vectors in Avaya Aura
Communication Manager.
With the Multiple Audio/Music Sources feature, you can tailor the wait-time feedback to the
interests, tastes, or requirements of the audience. You can provide specific types of music or
music with overlays of advertising that relate to the service provided by the splits or skills that
the vector serves. Or, additional advertising messages can be heard by the callers as they wait
for an available agent.
An example of an announcement that includes an alternative audio or music source in the
wait-time step is shown below.
Call delay with multiple audio/music source feedback
announcement 2556 [All of our agents are busy. Please hold.]
wait-time 20 seconds hearing 55558 then music
When the wait-time step is processed, the caller is connected to extension 55558 for 20
seconds. At the end of 20 seconds, the next vector step is executed. The then option in the
wait-time step specifies one of the following:
What the caller hears if the caller cannot be connected to the specified source.
When the call is waiting in queue, what the caller hears if the call is not answered in 20
seconds.
In the example shown above, if the call is not answered in 20 seconds, the caller hears system
music until a subsequent announcement, busy, collect, converse-on, disconnect or wait-time
step is encountered.
You can specify music (system music), ringback, silence, or continue for the then
option. When continue is specified, the caller continues to hear the alternative audio or music
source until it is replaced by a subsequent vector step regardless of the time specified in the
wait-time step.
Call delay with continuous audible feedback
You can use alternate audio or music sources in vector loops to provide continuous audible
feedback as shown in the following example vector steps.
1. ...
2. ...
3. ...
4. wait-time 30 secs hearing 55558 then continue
Operation
Programming Call Vectors in Avaya Aura
Communication Manager
Feature Description and Implementation.
You should understand the following considerations about how TN works with multiple music
sources on hold:
Without EAS, the COR setting of the station or extension that puts the call on hold
determines whether music-on-hold is applied.
With EAS, the COR setting of the logical agent ID is used to determine whether music-
on-hold is applied.
The TN assigned to the destination extension number is associated with a music source
number on the Tenant screen.
The physical location (port) of the music source is assigned on the Music Sources screen.
The TN is assigned to the active VDN on the Vector Directory Number screen.
During vectoring, a wait hearing music command attaches the vector delay music
source that is defined by the TN for the active VDN.
Alternately, you can also use the Multiple Music Sources for Vector Delay feature to
specify music sources. A wait hearing extension then... command applies the
vector delay source. In this case, the music source is defined by the extension specified on
the Announcements or Audio Sources screen, rather than the TN assigned to the VDN.
The TN administered for extensions on the Announcement or Audio Sources screen
applies only to direct calls to the announcement extension. For these calls, the
announcement or music source assigned to the TN is what the caller hears.
During vector processing, if the converse vector command connects the call to an agent
when the call remains under vector control and the agent puts the call on hold, the active
VDN applies music-on-hold.
Call Vectoring commands
322 Programming Call Vectors in Avaya Aura
Call Center. The Return Destination VDN (the one specified in the new field) will be
referred to as the Return Destination.
Every incoming trunk call that is processed through a VDN with this feature active will be placed
back in vector processing when all parties on the call, except the originator, drop. For this
feature, the originator is the incoming party that originated the call at the time the call entered
the VDN with this feature active.
Note:
Incoming calls on DCS ties do not go to VDN Return Destination.
The VDN that the call will be placed in (when the originator is the only remaining party) is
determined by the return destination. This VDN may be the same or different than the original
VDN.
This feature is used to keep the call active and give the caller the opportunity to signal the need
for sequence dialing (by entering a #). There are two ways this can happen:
Considerations for the vectoring features
332 Programming Call Vectors in Avaya Aura
Call Center
Feature Reference document for details on the call flow for converse-VRI calls.
Table 9: Converse command debugging
Symptom Cause Analysis
Placing a call:
Converse step
skipped.
VRU down (RONA). Vector event.
Split queue full Vector event.
Call stuck in
converse.
VRU port doesnt answer, RONA not
used.
Check split administration.
VRU down, RONA leaves call in
queue.
Check split status.
Data passing:
First set of digits not
collected.
Converse first delay too short. Check administration.
No ANI available. Vector event.
No digits collected. Vector event.
Call not queued (qpos). Vector event.
Expected wait time not available Vector event.
VRU timed out awaiting first digit. VRU error log/trace.
VRU first digit timeout too short. Check VRU script.
Check converse first data
delay.
Faulty hardware. Diagnostics
Second set of digits
not collected.
VRU digit count on first prompt in
VRU script does not include #.
Check VRU script.
Converse second delay too short. Check administration.
No ANI available. Vector event.
Converse command debugging
Programming Call Vectors in Avaya Aura
Call Center
Feature Reference document.
293 No room for reply-best
information
The network or shared trunk setting does not support the
transport of all data for the best resource. This is unlikely
under normal circumstances since only 12 bytes of user
information are required. Also see event 298.
294 No room for in-VDN
time
The network does not support the transport of all user
data. You can prioritize the user data using the Shared
Troubleshooting vectors
362 Programming Call Vectors in Avaya Aura
Call
Center Feature Reference document.
305 A BSR local treatment
vector pulled a
remotely queued call
back to the local switch
to route it elsewhere
If a queue-to best step is followed by steps that use any
commands other than announcement, wait, or go-to, the
trunk to the remote queue is dropped. This functionality
can be exploited to allow the local server to take back
calls that are interflowed to a remote location after a
specified time limit is exceeded. To implement this
strategy, a wait step with a specified time interval is
included in the interflow vector on the local server,
followed by one or more route-to steps that redirect the
call to an alternate call center locations.
310 NCR: Invoke trunk not
ISDN
Check that only ISDN trunks are executing the vector
steps where NCR is being invoked.
Vector events
Programming Call Vectors in Avaya Aura
Call
Center Feature Reference.
The XYZ Company wants to:
Route 25% of calls to the ABC Company in India
Route 25% of calls to the DEF Company in China
Route 50% of calls to the XYZ Companys local call center through XYZ Companys
Communication Manager system.
They can allocate call types into three groups of call handlers: one for India, one for China,
and one for the local call center.
This topic includes the following two examples:
Example 1: Percentage routing using VDN variables on page 399
Example 2: Percentage routing using PRT on page 403
Set command examples
398 Programming Call Vectors in Avaya Aura
)
An Avaya messaging system on page 437. AUDIX
) on page 429.
auto-in work mode A mode in which an agent is ready to process another call as soon as the current
call is completed. Auto-in work mode is one of four agent work modes. Also see,
aux-work mode on page 430, manual-in work mode on page 436, and After Call
Work (ACW) mode on page 428.
Automatic Alternate
Routing (AAR)
A feature that routes calls to a different route than the first-choice route when
facilities are unavailable.
Automatic Call
Distribution (ACD)
A feature that answers calls, and then depending on administered instructions,
delivers messages appropriate for the caller and routes the call to an agent when
one becomes available.
Automatic Call
Distribution (ACD)
split
A method of routing calls of a similar type among agents in a call center. Also, a
group of extensions that are staffed by agents trained to handle a certain type of
incoming call.
Automatic Callback A feature that enables internal callers, upon reaching a busy extension, to have
the system automatically connect and ring both originating and receiving parties
when the receiving party becomes available.
Programming Call Vectors in Avaya Aura