Professional Documents
Culture Documents
Ivred en
Ivred en
Release 10.1
Issue 1
May 2017
© 2014-2017, Avaya Inc. IF YOU DO NOT WISH TO ACCEPT THESE TERMS OF USE, YOU
All Rights Reserved. MUST NOT ACCESS OR USE THE HOSTED SERVICE OR
AUTHORIZE ANYONE TO ACCESS OR USE THE HOSTED
Notice SERVICE.
While reasonable efforts have been made to ensure that the Licenses
information in this document is complete and accurate at the time of
printing, Avaya assumes no liability for any errors. Avaya reserves THE SOFTWARE LICENSE TERMS AVAILABLE ON THE AVAYA
the right to make changes and corrections to the information in this WEBSITE, HTTPS://SUPPORT.AVAYA.COM/LICENSEINFO,
document without the obligation to notify any person or organization UNDER THE LINK “AVAYA SOFTWARE LICENSE TERMS (Avaya
of such changes. Products)” OR SUCH SUCCESSOR SITE AS DESIGNATED BY
AVAYA, ARE APPLICABLE TO ANYONE WHO DOWNLOADS,
Documentation disclaimer USES AND/OR INSTALLS AVAYA SOFTWARE, PURCHASED
“Documentation” means information published in varying mediums FROM AVAYA INC., ANY AVAYA AFFILIATE, OR AN AVAYA
which may include product information, operating instructions and CHANNEL PARTNER (AS APPLICABLE) UNDER A COMMERCIAL
performance specifications that are generally made available to users AGREEMENT WITH AVAYA OR AN AVAYA CHANNEL PARTNER.
of products. Documentation does not include marketing materials. UNLESS OTHERWISE AGREED TO BY AVAYA IN WRITING,
Avaya shall not be responsible for any modifications, additions, or AVAYA DOES NOT EXTEND THIS LICENSE IF THE SOFTWARE
deletions to the original published version of Documentation unless WAS OBTAINED FROM ANYONE OTHER THAN AVAYA, AN
such modifications, additions, or deletions were performed by or on AVAYA AFFILIATE OR AN AVAYA CHANNEL PARTNER; AVAYA
the express behalf of Avaya. End User agrees to indemnify and hold RESERVES THE RIGHT TO TAKE LEGAL ACTION AGAINST YOU
harmless Avaya, Avaya's agents, servants and employees against all AND ANYONE ELSE USING OR SELLING THE SOFTWARE
claims, lawsuits, demands and judgments arising out of, or in WITHOUT A LICENSE. BY INSTALLING, DOWNLOADING OR
connection with, subsequent modifications, additions or deletions to USING THE SOFTWARE, OR AUTHORIZING OTHERS TO DO SO,
this documentation, to the extent made by End User. YOU, ON BEHALF OF YOURSELF AND THE ENTITY FOR WHOM
YOU ARE INSTALLING, DOWNLOADING OR USING THE
Link disclaimer SOFTWARE (HEREINAFTER REFERRED TO
Avaya is not responsible for the contents or reliability of any linked INTERCHANGEABLY AS “YOU” AND “END USER”), AGREE TO
websites referenced within this site or Documentation provided by THESE TERMS AND CONDITIONS AND CREATE A BINDING
Avaya. Avaya is not responsible for the accuracy of any information, CONTRACT BETWEEN YOU AND AVAYA INC. OR THE
statement or content provided on these sites and does not APPLICABLE AVAYA AFFILIATE (“AVAYA”).
necessarily endorse the products, services, or information described Avaya grants You a license within the scope of the license types
or offered within them. Avaya does not guarantee that these links will described below, with the exception of Heritage Nortel Software, for
work all the time and has no control over the availability of the linked which the scope of the license is detailed below. Where the order
pages. documentation does not expressly identify a license type, the
Warranty applicable license will be a Designated System License. The
applicable number of licenses and units of capacity for which the
Avaya provides a limited warranty on Avaya hardware and software. license is granted will be one (1), unless a different number of
Refer to your sales agreement to establish the terms of the limited licenses or units of capacity is specified in the documentation or other
warranty. In addition, Avaya’s standard warranty language, as well as materials available to You. “Software” means computer programs in
information regarding support for this product while under warranty is object code, provided by Avaya or an Avaya Channel Partner,
available to Avaya customers and other parties through the Avaya whether as stand-alone products, pre-installed on hardware products,
Support website: https://support.avaya.com/helpcenter/ and any upgrades, updates, patches, bug fixes, or modified versions
getGenericDetails?detailId=C20091120112456651010 under the link thereto. “Designated Processor” means a single stand-alone
“Warranty & Product Lifecycle” or such successor site as designated computing device. “Server” means a Designated Processor that
by Avaya. Please note that if You acquired the product(s) from an hosts a software application to be accessed by multiple users.
authorized Avaya Channel Partner outside of the United States and “Instance” means a single copy of the Software executing at a
Canada, the warranty is provided to You by said Avaya Channel particular time: (i) on one physical machine; or (ii) on one deployed
Partner and not by Avaya. software virtual machine (“VM”) or similar deployment.
“Hosted Service” means an Avaya hosted service subscription that License types
You acquire from either Avaya or an authorized Avaya Channel
Partner (as applicable) and which is described further in Hosted SAS Concurrent User License (CU). End User may install and use the
or other service description documentation regarding the applicable Software on multiple Designated Processors or one or more Servers,
hosted service. If You purchase a Hosted Service subscription, the so long as only the licensed number of Units are accessing and using
foregoing limited warranty may not apply but You may be entitled to the Software at any given time. A “Unit” means the unit on which
support services in connection with the Hosted Service as described Avaya, at its sole discretion, bases the pricing of its licenses and can
further in your service description documents for the applicable be, without limitation, an agent, port or user, an e-mail or voice mail
Hosted Service. Contact Avaya or Avaya Channel Partner (as account in the name of a person or corporate function (e.g.,
applicable) for more information. webmaster or helpdesk), or a directory entry in the administrative
database utilized by the Software that permits one user to interface
Hosted Service with the Software. Units may be linked to a specific, identified Server
THE FOLLOWING APPLIES ONLY IF YOU PURCHASE AN AVAYA or an Instance of the Software.
HOSTED SERVICE SUBSCRIPTION FROM AVAYA OR AN AVAYA Heritage Nortel Software
CHANNEL PARTNER (AS APPLICABLE), THE TERMS OF USE
FOR HOSTED SERVICES ARE AVAILABLE ON THE AVAYA “Heritage Nortel Software” means the software that was acquired by
WEBSITE, HTTPS://SUPPORT.AVAYA.COM/LICENSEINFO Avaya as part of its purchase of the Nortel Enterprise Solutions
UNDER THE LINK “Avaya Terms of Use for Hosted Services” OR Business in December 2009. The Heritage Nortel Software is the
SUCH SUCCESSOR SITE AS DESIGNATED BY AVAYA, AND ARE software contained within the list of Heritage Nortel Products located
APPLICABLE TO ANYONE WHO ACCESSES OR USES THE at https://support.avaya.com/LicenseInfo under the link “Heritage
HOSTED SERVICE. BY ACCESSING OR USING THE HOSTED Nortel Products” or such successor site as designated by Avaya. For
SERVICE, OR AUTHORIZING OTHERS TO DO SO, YOU, ON Heritage Nortel Software, Avaya grants Customer a license to use
BEHALF OF YOURSELF AND THE ENTITY FOR WHOM YOU ARE Heritage Nortel Software provided hereunder solely to the extent of
DOING SO (HEREINAFTER REFERRED TO INTERCHANGEABLY the authorized activation or authorized usage level, solely for the
AS “YOU” AND “END USER”), AGREE TO THE TERMS OF USE. IF purpose specified in the Documentation, and solely as embedded in,
YOU ARE ACCEPTING THE TERMS OF USE ON BEHALF A for execution on, or for communication with Avaya equipment.
COMPANY OR OTHER LEGAL ENTITY, YOU REPRESENT THAT Charges for Heritage Nortel Software may be based on extent of
YOU HAVE THE AUTHORITY TO BIND SUCH ENTITY TO THESE activation or use authorized as specified in an order or invoice.
TERMS OF USE. IF YOU DO NOT HAVE SUCH AUTHORITY, OR
Copyright AVAYA CHANNEL PARTNER ACKNOWLEDGES AND AGREES
THE AVAYA CHANNEL PARTNER IS RESPONSIBLE FOR ANY
Except where expressly stated otherwise, no use should be made of AND ALL RELATED FEES AND/OR ROYALTIES. THE G.729
materials on this site, the Documentation, Software, Hosted Service, CODEC IS LICENSED BY SIPRO LAB TELECOM INC. SEE
or hardware provided by Avaya. All content on this site, the WWW.SIPRO.COM/CONTACT.HTML. THE H.264 (AVC) CODEC IS
documentation, Hosted Service, and the product provided by Avaya LICENSED UNDER THE AVC PATENT PORTFOLIO LICENSE FOR
including the selection, arrangement and design of the content is THE PERSONAL USE OF A CONSUMER OR OTHER USES IN
owned either by Avaya or its licensors and is protected by copyright WHICH IT DOES NOT RECEIVE REMUNERATION TO: (I)
and other intellectual property laws including the sui generis rights
ENCODE VIDEO IN COMPLIANCE WITH THE AVC STANDARD
relating to the protection of databases. You may not modify, copy, (“AVC VIDEO”) AND/OR (II) DECODE AVC VIDEO THAT WAS
reproduce, republish, upload, post, transmit or distribute in any way
ENCODED BY A CONSUMER ENGAGED IN A PERSONAL
any content, in whole or in part, including any code and software ACTIVITY AND/OR WAS OBTAINED FROM A VIDEO PROVIDER
unless expressly authorized by Avaya. Unauthorized reproduction, LICENSED TO PROVIDE AVC VIDEO. NO LICENSE IS GRANTED
transmission, dissemination, storage, and or use without the express OR SHALL BE IMPLIED FOR ANY OTHER USE. ADDITIONAL
written consent of Avaya can be a criminal, as well as a civil offense
INFORMATION FOR H.264 (AVC) AND H.265 (HEVC) CODECS
under the applicable law. MAY BE OBTAINED FROM MPEG LA, L.L.C. SEE HTTP://
Virtualization WWW.MPEGLA.COM.
The following applies if the product is deployed on a virtual machine. Compliance with Laws
Each product has its own ordering code and license types. Note that
You acknowledge and agree that it is Your responsibility for
each Instance of a product must be separately licensed and ordered.
complying with any applicable laws and regulations, including, but not
For example, if the end user customer or Avaya Channel Partner
limited to laws and regulations related to call recording, data privacy,
would like to install two Instances of the same type of products, then
intellectual property, trade secret, fraud, and music performance
two products of that type must be ordered.
rights, in the country or territory where the Avaya product is used.
Third Party Components
Preventing Toll Fraud
“Third Party Components” mean certain software programs or
“Toll Fraud” is the unauthorized use of your telecommunications
portions thereof included in the Software or Hosted Service may
system by an unauthorized party (for example, a person who is not a
contain software (including open source software) distributed under
corporate employee, agent, subcontractor, or is not working on your
third party agreements (“Third Party Components”), which contain
company's behalf). Be aware that there can be a risk of Toll Fraud
terms regarding the rights to use certain portions of the Software
associated with your system and that, if Toll Fraud occurs, it can
(“Third Party Terms”). As required, information regarding distributed
result in substantial additional charges for your telecommunications
Linux OS source code (for those products that have distributed Linux
services.
OS source code) and identifying the copyright holders of the Third
Party Components and the Third Party Terms that apply is available Avaya Toll Fraud intervention
in the products, Documentation or on Avaya’s website at: https://
support.avaya.com/Copyright or such successor site as designated If You suspect that You are being victimized by Toll Fraud and You
by Avaya. The open source software license terms provided as Third need technical assistance or support, call Technical Service Center
Party Terms are consistent with the license rights granted in these Toll Fraud Intervention Hotline at +1-800-643-2353 for the United
Software License Terms, and may contain additional rights benefiting States and Canada. For additional support telephone numbers, see
You, such as modification and distribution of the open source the Avaya Support website: https://support.avaya.com or such
successor site as designated by Avaya.
software. The Third Party Terms shall take precedence over these
Software License Terms, solely with respect to the applicable Third Security Vulnerabilities
Party Components to the extent that these Software License Terms
impose greater restrictions on You than the applicable Third Party Information about Avaya’s security support policies can be found in
Terms. the Security Policies and Support section of https://
support.avaya.com/security.
The following applies only if the H.264 (AVC) codec is distributed with
the product. THIS PRODUCT IS LICENSED UNDER THE AVC Suspected Avaya product security vulnerabilities are handled per the
PATENT PORTFOLIO LICENSE FOR THE PERSONAL USE OF A Avaya Product Security Support Flow (https://
CONSUMER OR OTHER USES IN WHICH IT DOES NOT RECEIVE support.avaya.com/css/P8/documents/100161515).
REMUNERATION TO (i) ENCODE VIDEO IN COMPLIANCE WITH Downloading Documentation
THE AVC STANDARD (“AVC VIDEO”) AND/OR (ii) DECODE AVC
VIDEO THAT WAS ENCODED BY A CONSUMER ENGAGED IN A For the most current versions of Documentation, see the Avaya
PERSONAL ACTIVITY AND/OR WAS OBTAINED FROM A VIDEO Support website: https://support.avaya.com, or such successor site
PROVIDER LICENSED TO PROVIDE AVC VIDEO. NO LICENSE IS as designated by Avaya.
GRANTED OR SHALL BE IMPLIED FOR ANY OTHER USE. Contact Avaya Support
ADDITIONAL INFORMATION MAY BE OBTAINED FROM MPEG
LA, L.L.C. SEE HTTP://WWW.MPEGLA.COM. See the Avaya Support website: https://support.avaya.com for
product or Hosted Service notices and articles, or to report a problem
Service Provider with your Avaya product or Hosted Service. For a list of support
THE FOLLOWING APPLIES TO AVAYA CHANNEL PARTNER’S telephone numbers and contact addresses, go to the Avaya Support
HOSTING OF AVAYA PRODUCTS OR SERVICES. THE PRODUCT website: https://support.avaya.com (or such successor site as
OR HOSTED SERVICE MAY USE THIRD PARTY COMPONENTS designated by Avaya), scroll to the bottom of the page, and select
SUBJECT TO THIRD PARTY TERMS AND REQUIRE A SERVICE Contact Avaya Support.
PROVIDER TO BE INDEPENDENTLY LICENSED DIRECTLY Trademarks
FROM THE THIRD PARTY SUPPLIER. AN AVAYA CHANNEL
PARTNER’S HOSTING OF AVAYA PRODUCTS MUST BE The trademarks, logos and service marks (“Marks”) displayed in this
AUTHORIZED IN WRITING BY AVAYA AND IF THOSE HOSTED site, the Documentation, Hosted Service(s), and product(s) provided
PRODUCTS USE OR EMBED CERTAIN THIRD PARTY by Avaya are the registered or unregistered Marks of Avaya, its
SOFTWARE, INCLUDING BUT NOT LIMITED TO MICROSOFT affiliates, its licensors, its suppliers, or other third parties. Users are
SOFTWARE OR CODECS, THE AVAYA CHANNEL PARTNER IS not permitted to use such Marks without prior written consent from
REQUIRED TO INDEPENDENTLY OBTAIN ANY APPLICABLE Avaya or such third party which may own the Mark. Nothing
LICENSE AGREEMENTS, AT THE AVAYA CHANNEL PARTNER’S contained in this site, the Documentation, Hosted Service(s) and
EXPENSE, DIRECTLY FROM THE APPLICABLE THIRD PARTY product(s) should be construed as granting, by implication, estoppel,
SUPPLIER. or otherwise, any license or right in and to the Marks without the
express written permission of Avaya or the applicable third party.
WITH RESPECT TO CODECS, IF THE AVAYA CHANNEL
PARTNER IS HOSTING ANY PRODUCTS THAT USE OR EMBED Avaya is a registered trademark of Avaya Inc.
THE G.729 CODEC, H.264 CODEC, OR H.265 CODEC, THE
All non-Avaya trademarks are the property of their respective owners.
Linux® is the registered trademark of Linus Torvalds in the U.S. and
other countries.
Contents
Chapter 1: Introduction............................................................................................................ 7
Purpose.................................................................................................................................. 7
Change history........................................................................................................................ 7
Chapter 2: Overview of Interactive Voice Response............................................................. 8
Examples of IVR usage........................................................................................................... 8
Architecture topologies.......................................................................................................... 10
Topology for data storage................................................................................................ 11
Chapter 3: IVR scripts and script elements.......................................................................... 13
Purpose of IVR scripts........................................................................................................... 13
IVR script types..................................................................................................................... 13
IVR script elements............................................................................................................... 14
Basic elements................................................................................................................ 14
Speech elements............................................................................................................ 19
Telephony elements........................................................................................................ 32
Database elements.......................................................................................................... 42
Chapter 4: Working with IVR scripts..................................................................................... 50
Logging in to the IVR Editor.................................................................................................... 50
Creating IVR script folders..................................................................................................... 50
Creating an IVR script............................................................................................................ 51
Opening IVR scripts............................................................................................................... 51
IVR script elements............................................................................................................... 51
Adding elements............................................................................................................. 51
Connecting elements....................................................................................................... 53
Editing element properties................................................................................................ 54
Moving elements............................................................................................................. 54
Deleting elements............................................................................................................ 54
Creating and editing local variables................................................................................... 55
Changing and refreshing IVR script views............................................................................... 56
Assigning IVR scripts............................................................................................................. 57
Properties tab field descriptions........................................................................................ 58
Saving and enabling IVR scripts............................................................................................. 58
Script error messages...................................................................................................... 59
Previewing and printing IVR scripts......................................................................................... 60
Closing all IVR script windows................................................................................................ 60
Moving IVR scripts to a different folder.................................................................................... 60
Renaming IVR scripts or folders............................................................................................. 61
Deleting IVR scripts or folders................................................................................................ 61
IVR script tools...................................................................................................................... 61
Configuring IVRs............................................................................................................. 61
Purpose
This document describes how to use the Interactive Voice Response (IVR) module. This module is
intended for administrators.
For more information about IVR Editor scenarios and IVR script configuration, see Avaya IP Office
Contact Center IVR Scenarios Task Based Guide.
Note:
The online help version of this document in the IP Office Contact Center build might not be the
latest version. Obtain the final version from http://support.avaya.com/. For information about
finding documents, see Finding documents on the Avaya Support website on page 69.
Change history
The following table summarizes major changes in this document.
The Interactive Voice Response (IVR) ( ) module provides customer services, such as automatic
announcements and Text To Speech (TTS). The IVR Editor includes the following:
• DTMF tone recognition for evaluating subscriber entries.
• Announcement creation with .WAV files or TTS. You can write TTS text in a script element, a
text file, or a CallTag.
• Voice mail recording and distribution. You can also forward voice mails to an agent through
email.
• Read and write access to content stored in external databases.
• Script features, such as creating scripts, and adding or editing elements.
• Telephony functions with querying elements, such as call, refer back, and transfer.
The following task flow displays how the system routes a call before transferring the caller to voice
mail:
Second prio:
last agent
Service
Y 1
N Record
voice
message
if waiting
Route recorded Voice Message is too long
Service
1
2
3
4
Architecture topologies
The Interactive Voice Response (IVR) is an integrated component of the IP Office Contact Center
server.
The Common Object Request Broker Architecture (CORBA) standard connects the Voice Control
server, (ivr.exe), to the Common Hardware Abstraction Platform (CHAP). CHAP hides the
configured routes to the PBX. CHAP is connected to the PBX through TCP (SIP extension). The IP
Office Contact Center server components use a CORBA connection to control the Voice Control
processes.
With this configuration, the Voice Control server controls the announcements channels. The system
saves the configuration and the IVR scripts in the IP Office Contact Center database.
Core
(kernel & routing)
IP Office
Task server
CHAP IVR
IP Office
LAN
Ina_srv db_srv
IVR
Script
CC database (XML)
This architecture has two Voice Control systems and two storage areas with .WAV files.
Data storage overview
The system creates the IVR scripts with the IVR Editor tool and stores the scripts in the IP Office
Contact Center database. When the storage process starts, the database loads the scripts and
generates the necessary script elements or classes. When the system requires a script, the contact
center triggers the Voice Control server to process the script.
The system saves the .WAV files and voice mails in the local network drives that the Voice Control
server can access, and not in the database directly. You must configure quick access to the network
storage drives to avoid voice mail interruptions. You must also configure Open Database
Connectivity (ODBC) on every Voice Control server to get access to the customer databases.
• You can use an automatic agent script to make, drop, or transfer calls, and to make
consultation calls.
Basic elements
The basic elements are the essential elements of an IVR script.
Table 1: Description of basic elements
Button Description
Operators Displays the list of configured operators.
Local variables Displays the list of configured local variables.
Tags Displays the list of configured tags.
Button Description
Operators Displays the list of configured operators.
Local variables Displays the list of configured local variables.
Tags Displays the list of configured tags.
Related links
Defining time-off periods on page 65
Name Description
• D_InvokeID: Indicates the invoke ID, which is a unique and invariable
identification number that exists during the entire script flow. The invoke ID
exists even in the invoked subscripts. You cannot change this ID. You can
save this ID in the database to store information about a specific call.
You must create the variables in the correct format before you can use the
variable in this element.
New value Displays the value set for the variable.
Button Description
Operators Displays the list of configured operators.
Local variables Displays the list of configured local variables.
Tags Displays the list of configured tags.
Button Description
Add Adds a new variable or tag.
Delete Deletes existing variables or tags.
Local variables Displays the list of configured local variables.
Tags Displays the list of configured tags.
Tip:
You need not this setting if the new program does not have any
associated output, such as scripts.
Return value var Specifies the variable for the customized completion status for the
program. This variable is optional.
Button Description
Browse Displays the list of folders. You can select a folder from the Select
program list.
Local variables Displays the list of configured local variables.
Tags Displays the list of configured tags.
Speech elements
The Speech elements define the voice options within the IVR system.
Element Name Description
Announcement Specifies the type of announcement.
In an Announcement element, you can add one or more sound files,
such as .wav files, or you can add a variable. If you add more than one
announcement file to an element, you must use a semicolon to separate
Table continues…
Note:
If the system is not connected to the email server, the system
temporarily saves the email message in a folder. The system
distributes the faulty connection to the email server as an error to
the Error-exit connector. The Voice Control system automatically
tries to resend the email at regular intervals.
The Send voice mail as an email element can have multiple input
connectors. These elements use an Error-exit connector if the .wav file
cannot be located. The Error-exit connectors contain a tool tip displaying
the error number and the explanation.
You can use any number of Send voice mail as email elements.
Delete voicemail Deletes the specified .wav file.
The Delete voice mail elements can have multiple input connectors.
These elements use an Error-exit connector if the .wav file cannot be
located. The Error-exit connectors contain a tool tip displaying the error
number and the explanation.
Related links
IVR script elements on page 14
Note:
The UNC path used for the announcement .wav files is in the Windows
registry, under PathMsgsMnnouncements. For example: \\servername
\\path_to_wav_file\file.wav
Continuous Specifies that the system replays the announcement text.
announcement
You can specify a maximum run time for the announcement. When the specified
time is over, the announcement stops after one run. If no maximum run time is
specified, the announcement replays continuously.
Button Description
Browse Selects an announcement file from the File Manager. You cannot select a file
that the Voice Control server cannot detect.
Local variables Displays the list of configured variables. You can select a variable from the list.
Note:
This option is only available on some terminals.
• Characters: The pound sign (#) and the star (*)
Text to speech Specifies whether you must use the text converted to speech for the
announcement. You can use any character and any number of
characters for the text. You can:
• Type the text directly.
Table continues…
Name Description
• Specify a variable.
You can select a standard variable or a tag for the text by selecting
the Var check box.
• Select a file with text.
You can specify a variable folder, or you can use the default folder in
the Windows registry.
Language Selects a language for the announcement text. The options are:
• System: Uses the operating system language.
• Var.: Defines the language with a variable.
Speed of speech Specifies how fast you must speak the text to provide the
announcement text. You can select a value between 1, for slowest,
and 9, for fastest. The default setting is 6.
Announcement Text Enables you to select an announcement text with a sound file or a
variable.
The options to specify the announcement text are:
• Enter a file name. For example, xyz.wav. You can also specify a
custom folder location, or you can select the Default folder.
• Enter a variable as the file name. You can also specify a custom
folder location, or you can select the Default folder.
• Enter the file name and the folder name as variables. You must
enter the folder name in the Folder var: field.
Note:
The UNC path used for the announcement .wav files is in the
Windows registry, under PathMsgsMnnouncements. For
example: \\servername\\path_to_wav_file\file.wav
Max. input time (mm:ss) Specifies the time available for the caller to enter a DTMF digit. The
time period begins after the system plays the announcement. You
must configure this setting.
Input possible during Specifies whether callers can enter DTMF digits while the system
announcement plays the announcement.
Button Description
Browse Selects an announcement file from the File Manager. You cannot
select a file that the Voice Control server cannot detect.
Local variables Displays the list of configured variables. You can select a variable from
the list.
Tags Displays the list of configured tags. You can select a tag from the list.
Add Adds a digit.
Table continues…
Button Description
Important:
You can only add a digit if an exit connector is not assigned or
linked to an element.
Delete Deletes the selected digit.
Important:
You can only delete a digit if an exit connector is not assigned or
linked to an element.
Related links
Speech variables for language on page 31
Name Description
Invalid digits Specifies the invalid digits. The system distributes the invalid digits, which
you dial during a call, to the Error-exit connector.
Max. input time (mm:ss) Specifies the time available for the caller to enter a DTMF digit. The time
period begins after the system plays the announcement. You must
configure this setting.
Button Description
Browse Selects an announcement file from the File Manager. You cannot select a
file that the Voice Control server cannot detect.
Local variables Displays the list of configured variables. You can select a variable from the
list.
Tags Displays the list of configured tags. You can select a tag from the list.
Related links
Speech variables for language on page 31
Name Description
Tip:
If you add the term DTMF as a key word, the system recognizes the
telephony strokes as allowed terms.
Result Variable Specifies the result variable for the recognized terms. If the system does
not recognize any terms, the result variable becomes empty.
Max. speech time (mm:ss) Specifies the maximum speech time for a caller. The maximum setting is
5 minutes. The maximum speech time begins after the system plays the
announcement.
Button Description
Browse Selects an announcement file from the File Manager. You cannot select
a file that the Voice Control server cannot detect.
Local variables Displays the list of configured variables. You can select a variable from
the list.
Tags Displays the list of configured tags. You can select a tag from the list.
Add Adds an allowed term.
Delete Deletes a term.
Related links
Speech variables for language on page 31
Button Description
Browse Selects an announcement file from the File Manager. You cannot select
a file that the Voice Control server cannot detect.
Local variables Displays the list of configured variables. You can select a variable from
the list.
Tags Displays the list of configured tags. You can select a tag from the list.
Related links
Speech variables for language on page 31
Button Description
Browse Selects an announcement file from the File Manager. You cannot select
a file that the Voice Control server cannot detect.
Local variables Displays the list of configured variables. You can select a variable from
the list.
Table continues…
Button Description
The options are:
• _VMDuration: Specifies the length of the voice mail recording in
seconds.
• _NoRecBeep: Specifies whether the system plays a tone indicating
the starting of voice mail recording. The values 1 or true indicates
that the system does not play a tone.
• _MinRecDuration: Specifies the minimum length of a recording in
seconds. The system deletes a recording that is less than the
_MinRecDuration time.
You must create the variables in the correct format before you can use
the variables in an element.
Name Description
record any voice mail, and the script stops the element through the
Error-exit connector.
Not interruptible Specifies whether the voice mail can be interrupted.
Button Description
Browse Selects an announcement file from the File Manager. You cannot select
a file that the Voice Control server cannot detect.
Local variables Displays the list of configured variables. You can select a variable from
the list.
The options are:
• _VMDuration: Specifies the length of the voice mail recording in
seconds.
• _NoRecBeep: Specifies whether the system plays a tone indicating
the starting of voice mail recording. The values 1 or true indicates
that the system does not play a tone.
• _MinRecDuration: Specifies the minimum length of a recording in
seconds. The system deletes a recording that is less than the
_MinRecDuration time.
You must create the variables in the correct format before you can use
the variables in an element.
Note:
The end of the recording can contain silence to suppress possible DTMF tones. You can set the
length of the silence in the HideDTMFTone field in the Windows Registry. The recommended
setting is between 5 and 8. If you set 0, the system does not add silence.
Button Description
Local variables Displays the list of configured variables. You can select a variable from
the list, or you can use the following variables to specify information in
the email:
• _From: Specifies the sender.
• _ReturnPath: Specifies the email address to which the system sends
the replies.
• _Subject: Specifies the subject of the email.
• _Body: Specifies the text in the email.
• _AuthAccount: Displays the SMTP user name.
• _AuthPassword: Displays the SMTP password.
You must create the variables in the correct format to use the variables
in an element.
Browse Selects an announcement file from the File Manager. You cannot select
a file that the Voice Control server cannot detect.
Related links
IVR script elements on page 14
Button Description
Browse Selects an announcement file from the File Manager. You cannot select a file
that the Voice Control server cannot detect.
Local variables Displays the list of configured variables. You can select a variable from the list.
Related links
IVR script elements on page 14
Variable Language
0 Operating system language
1 German
2 English
3 French
4 Spanish
5 Dutch
6 Flemish
7 Italian
8 Basque
9 Danish
10 Finnish
11 Swedish
12 Norwegian
13 Greek
14 Polish
15 Portuguese
16 Russian
17 Czech
18 Slovakian
19 Slovanian
20 Turkish
21 Hungarian
22 Hebrew
23 Chinese (Cantonese)
24 Chinese (Mandarin)
25 Japanese
26 Korean
40 to 44 User-defined language
Telephony elements
Telephony elements define telephony tasks within an IVR script. The scripts with telephony
elements that affect the connection status must use the automatic agent property.
Exit connectors for telephony elements
Telephony elements only require success and error-exit connectors. If you use only success and
error-exit connectors, all other exit connectors are automatically assigned internally to the error-exit
connector.
The common exit connectors for the telephony elements are:
Connector Description
Indicates that a successful connection is established.
B Indicates that the subscriber is busy. In an Integral Enterprise I55 PBX, this connector
is also used when the subscriber disconnects the call while the call is still ringing.
The error messages for the B connector are:
• 3491 (busy terminal)
• 34a2 (no B-channel)
• 3495 (call rejected)
T Indicates a time out, and the system uses this connector if the maximum ring time is
exceeded. The Voice Control system terminates the connection.
W Indicates a wrong number. This connector is used if the caller dials a wrong number.
wrong number and nonexistent number are not the same
The error messages associated with this connector are:
• 3481: Internal number is wrong
• 349c: Invalid number format
I Indicates that the dialed number is incomplete. This connector is used if the caller
does not finish dialing the number within the maximum ring time. For specific
extension dialing, the element timer for the maximum ring time must be at least 8
seconds. For dialing a full number without an extension, the element timer must be at
least 15 seconds.
The error messages associated with this connector are:
• 3481: Internal number is wrong
A Indicates that an active call connection does not exist. This element is only used in
certain telephony elements. For example, this connector is used if the active
subscriber hangs up.
The error messages associated with this connector are:
• 3490: Connection terminated or dialing cancelled with error number 6104
• 34a2: No B-channel
Table continues…
Connector Description
• 3495: Call rejected
P Indicates that a passive connection does not exist, and the subscriber on hold hung
up. This connector is only used in certain elements.
E Specifies that the Error-exit connector used in all other cases in which a connection
cannot be established.
The error messages associated with this connector are:
• 349f: Connection terminated with error number 6104
• 3490: Connection terminated or dialing cancelled with error number 6104
• 34e6: IISDN ring time monitoring with error number 6109
• 3492: Terminal unplugged with error number 6118
• 349b: Destination cannot be reached with error number 6118
• A
• P
Table continues…
• A
• P
• E
You must connect the Success and Error exit connectors with
another element. In the Error exit connector, a tool tip displays
the error number and explanation.
Disconnect Disconnects the currently active call and retrieves the call that
was previously on hold.
This element stops if the caller manually retrieves the held call
or if an error occurs.
Disconnect elements can have multiple input connectors. In the
Error exit connector, a tool tip displays the error number and
explanation.
Release Disconnects all established calls, active and held.
Release elements can have multiple input connectors, but only
one exit connector. This element does not have any Error exit
connectors.
You can use any number of Release elements.
Information on connection Determines additional information for the active call or
connection. This element requests the following types of
information:
• Telephone number of the caller. This information is not
requested if the Call element dials the number.
• Telephone number of the called party. The information
includes the CHAP port used by the IVR for incoming topic
calls or the dialled extension for transferred calls.
Note:
Information provided varies depending on the PBX system
and the type of IVR script, Announcement, or Greeting.
Table continues…
Note:
This option is available only on some terminals.
• Characters: The pound sign (#) and the asterisk (*)
The system recognizes only DTMF digits.
Max. ring time Specifies the maximum time after which the system disconnects a call. You
must configure this setting as maximum 5 minutes.
Button Description
Local variables Displays the list of configured variables. You can select a variable from the
list.
You can also use the following variable:
_MaxRingTime: Specifies the maximum ring time in seconds. For example,
300 seconds for 5 minutes. If you set this variable, the system ignores the
time specification set in the Max ring time field.
You must create the variables in the correct format before you can use the
variables in an element.
Related links
IVR script elements on page 14
IVR script elements on page 14
Basic elements on page 14
Trace field descriptions on page 16
Logic field descriptions on page 17
Check Time Periods field descriptions on page 17
Define Variable field descriptions on page 17
Branch field descriptions on page 18
Wait field descriptions on page 18
Note:
This option is available only on some terminals.
• Characters: The pound sign (#) and the asterisk (*)
Button Description
Local variables Displays the list of configured variables. You can select a variable from
the list.
Related links
IVR script elements on page 14
IVR script elements on page 14
Basic elements on page 14
Trace field descriptions on page 16
Logic field descriptions on page 17
Check Time Periods field descriptions on page 17
Define Variable field descriptions on page 17
Branch field descriptions on page 18
Wait field descriptions on page 18
Start Script field descriptions on page 18
Start Program field descriptions on page 19
Speech elements on page 19
Announcement field descriptions on page 22
Announcement plus DTMF field descriptions on page 22
Announcement plus DTMF sequence field descriptions on page 24
Announcement plus voice recognition field descriptions on page 25
Text to Speech field descriptions on page 26
Record Voice Mail field descriptions on page 27
Record Voice Mail Plus DTMF field descriptions on page 28
Send Voice Mail as E-mail field descriptions on page 29
Delete Voice Mail field descriptions on page 30
Speech variables for language on page 31
Telephony elements on page 32
Call field descriptions on page 36
Send DTMF Tones field descriptions on page 37
Consultation field descriptions on page 39
Information on Connection field descriptions on page 40
Database elements on page 42
Open Database field descriptions on page 44
Close Database field descriptions on page 44
Add Record field descriptions on page 45
Modify Records field descriptions on page 45
Delete Records field descriptions on page 46
SQL query field descriptions on page 46
First Record field descriptions on page 47
Next record field descriptions on page 47
Note:
This option is available only on some terminals.
• Characters: The pound sign (#) and the asterisk (*)
The system recognizes only DTMF digits.
Waiting for consultation call to be Specifies whether you can transfer the active consult call to the call
accepted on hold.
Max. ring time (mm:ss) Specifies the maximum time after which the system disconnects a
call. You must set a value up to 5 minutes.
Name Description
Local variables Displays the list of configured variables. You can select a variable
from the list.
You can also use the following variables:
• _MaxRingTime: Specifies the maximum ring time in seconds. For
example, 300 seconds for 5 minutes. If you set this variable, the
system ignores the maximum ring time setting.
• _WaitIfBusy: Specifies whether the consultation call can be
established. You must set this variable to true if the consultation
call cannot be established. Even if the subscriber is busy, the
system does not exit the element until the specified maximum call
time is over.
You must create the variables in the correct format before you can
use the variables in an element.
Related links
IVR script elements on page 14
IVR script elements on page 14
Basic elements on page 14
Trace field descriptions on page 16
Logic field descriptions on page 17
Name Description
• Routing number
Result variable Specifies the variable. The system saves information in this
variable.
Button Description
Local variables Displays the list of configured variables. You can select a variable
from the list.
Related links
IVR script elements on page 14
IVR script elements on page 14
Basic elements on page 14
Trace field descriptions on page 16
Logic field descriptions on page 17
Check Time Periods field descriptions on page 17
Define Variable field descriptions on page 17
Branch field descriptions on page 18
Wait field descriptions on page 18
Start Script field descriptions on page 18
Start Program field descriptions on page 19
Speech elements on page 19
Announcement field descriptions on page 22
Announcement plus DTMF field descriptions on page 22
Announcement plus DTMF sequence field descriptions on page 24
Announcement plus voice recognition field descriptions on page 25
Text to Speech field descriptions on page 26
Record Voice Mail field descriptions on page 27
Record Voice Mail Plus DTMF field descriptions on page 28
Send Voice Mail as E-mail field descriptions on page 29
Delete Voice Mail field descriptions on page 30
Speech variables for language on page 31
Telephony elements on page 32
Call field descriptions on page 36
Send DTMF Tones field descriptions on page 37
Consultation field descriptions on page 39
Information on Connection field descriptions on page 40
Database elements on page 42
Open Database field descriptions on page 44
Close Database field descriptions on page 44
Add Record field descriptions on page 45
Database elements
Understanding database elements
Database elements change external database records in an IVR script. IVR Editor and Voice
Control support the following databases:
• Microsoft Access
• Microsoft SQL-Server
• PostgreSQL 9.3
The Voice Control server accesses these databases with ODBC.
Important:
You must understand the supported databases and the requirements of these databases before
working with database elements.
Description of database elements
Element Type and properties Description
Open database Opens a database and provides access to data for
the database.
You must have the name of the data source
configured in the Voice Control server to open the
database.
These elements have Error exit connectors with a
tool tip displaying the error number and explanation.
Close database Closes a database that was opened with the Open
database element.
The Close database elements have no Error exit
connectors.
Insert record Adds a data record to a table.
These elements have Error exit connectors with a
tool tip displaying the error number and explanation.
Modify records Changes the records that meet a defined condition in
a table.
Table continues…
Button Description
Local variables Displays the list of configured variables. You can select a variable from the
list.
Related links
IVR script elements on page 14
Button Description
Local variables Displays the list of configured variables. You can select a variable from the
list.
Related links
IVR script elements on page 14
Button Description
Create Creates a field assignment.
Delete Deletes a field assignment.
Local variables Displays the list of configured variables. You can select a variable from the
list.
Tags Displays the list of configured tags. You can select a tag from the list.
Related links
IVR script elements on page 14
Button Description
Create Creates a field assignment.
Delete Deletes a field assignment.
Local variables Displays the list of configured variables. You can select a variable from the
list.
Tags Displays the list of configured tags. You can select a tag from the list.
Related links
IVR script elements on page 14
Button Description
Local variables Displays the list of configured variables. You can select a variable from the list.
Related links
IVR script elements on page 14
Button Description
Local variables Displays the list of configured variables. You can select a variable from the list.
Related links
IVR script elements on page 14
Button Description
Create Creates a field assignment.
Delete Deletes a field assignment.
Local variables Displays the list of configured variables. You can select a variable from
the list.
Related links
IVR script elements on page 14
Button Description
Create Creates a field assignment.
Table continues…
Button Description
Delete Deletes a field assignment.
Local variables Displays the list of configured variables. You can select a variable from
the list.
Related links
IVR script elements on page 14
Database requirements
To use the database in the IVR Editor module, you must:
• Get the user name and the password to get access to the database.
• Understand how to define tables and fields within the database.
Note:
The fields and the syntax types can vary among databases.
• Define data source names in the IP Office Contact Center server.
You can also configure the data source in a computer in which IVR Editor runs. If IVR Editor
can access the database, you can add a table and the field elements from the database in your
IVR scripts.
• Ensure that you use the required version of the ODBC Data Source Administrator when you set
up data source names.
On 64–bit operating systems, you must use the 32–bit version of the ODBC Data Source
Administrator. You must not use the version from the system control.
• Know the stored procedure calls that you can use in an IVR script.
Note:
Stored procedure calls can only be used if the database supports the call through the
Select command.
For example, the PostgreSQL database allows you to select * from sp_procedure
(parameters). Therefore, these database stored procedures can be called in an IVR
script.
Variable markings for supported databases
Database Description of variable markings
Microsoft Access 2003 and 2007 You must enter the strings within quotation marks in the following
format:
“<:stringvar:>”.
You can enter numerical values without quotation marks in the
following format:
<:numvar:>.
Table continues…
Adding elements
About this task
IVR scripts consist of script elements.
Procedure
1. On the Elements tab, drag and drop the Announcement element to the script.
2. In the Announcement dialog box, do the following:
a. In the Label field, type a label that explains the announcement function for the new
element.
b. To select a .WAV file, click Browse.
The system displays the Select announcement text file dialog box.
c. Select a file, and click Open.
d. Select the Not interruptible check box.
e. In the Comment field, type a comment.
3. Click OK.
The system adds the Announcement element to the script.
Related links
Adding elements on page 51
Connecting elements
About this task
A connection is the link between an input connector and an exit connector. A line graphically
represents a connection within a script. You can only connect a vacant input and the exit
connectors. You cannot assign more than one connection to one connector. You can add and move
corner points to connections for a clearer layout. You can also highlight connections.
Procedure
1. To connect two elements, do the following:
a. Click and drag a corner of the exit connector to an element.
b. To create a corner point, click the corner.
c. Drag the connection to the input connector of another element.
2. To move a corner point, do the following:
a. Point the mouse pointer to a corner point.
The system changes the pointer icon.
b. Click the corner, and click and drag the corner to a new position.
3. To highlight a connection, do the following:
a. Click a connection port, or right-click a connection port.
b. On the pop-up menu, click Highlight connection.
4. Right-click a connection port.
Moving elements
Procedure
1. To move an element, click on an element and drag the element to a new location.
2. To move multiple elements:
a. Click Ctrl and select the elements.
b. Press Ctrl and Shift, and drag the drop elements to a new location.
Deleting elements
Procedure
1. To delete an element:
a. Select an element, and then click Edit > Delete.
The system displays a confirmation message.
b. Click Yes.
Related links
Properties tab field descriptions on page 58
Button Description
Delete Deletes the selected IVR or start parameter.
Related links
Assigning IVR scripts on page 57
• The script contains a Start element, and the element does not start any other types of scripts.
For example, an automatic agent script can only start another automatic agent scrip. An
announcement or greeting script can only start another announcement or greeting script.
• The script contains an End element.
• The script is saved to the database in the XML format.
• Voice Control is informed that a new script is available.
If an error occurs, the script remains unavailable to Voice Control. You can fix the error and save the
script, and enable the script again.
Procedure
1. To save an IVR script, do one of the following:
• Click IVR > Save.
• On the toolbar menu, click the Save icon ( ).
2. To enable the IVR script, do one of the following:
• Click IVR > Enable.
• On the toolbar menu, click the Enable icon ( ).
Next steps
If an error occurs, troubleshoot the script using TTrace.
Related links
Script error messages on page 59
Related links
Saving and enabling IVR scripts on page 58
2. Select a script.
3. Drag and drop the script to the folder to which you want to move the script.
The system moves the script to the selected folder.
Configuring IVRs
About this task
You can view, add, copy, edit, or delete IVRs. The IVR list displays the name of the IVR and the
PBX for which the IVR is configured.
Procedure
1. Click Tools > IVR configuration.
The system displays the list of IVRs.
2. Select and double-click an IVR.
The system displays the IVR configuration-Edit dialog box.
3. Enter the required settings.
4. To configure the IVR scripts, click Scripts.
The system displays the IVR - IVR Scripts dialog box.
5. To configure voice mails, click Voice mails.
The system displays the Voice mails dialog box.
6. Select a voice mail.
7. Click OK.
The system configures a new voice unit.
8. Click OK.
The system configures a new IVR with the selected script and voice mail.
Related links
Properties tab field descriptions on page 62
Editing voice mails on page 63
Assigning numbers in CHAP on page 63
Supported WAV file formats on page 64
Related links
Configuring IVRs on page 61
c. In the Number of channels field, enter the number of channels configured on the PBX.
d. Click Create.
e. In the Start number field, enter the start number.
f. In the End number field, enter the end number.
g. Click Properties.
h. In the PBXIPAddress field, enter the IP address of the PBX.
i. In the LocalIPAddress field, enter the local IP address of the Voice Control server.
j. Click OK.
k. In the CHAP adapter-Edit dialog box, click the CHAP application resource tab.
l. In the Application name field, enter IVR.
The system displays the details of the IVR.
m. Click Create.
The system adds a new IVR.
n. Enter the required settings.
You can also assign numbers and channels to VEA to use for use with queue
announcements.
o. Click OK.
7. Click OK.
The system assigns the numbers in CHAP.
Related links
Configuring IVRs on page 61
Also supported You can also use the following .WAV formats, but the quality of the voice unit
might be compromised:
• PCM 11025 Hz, 16 bit, mono
• PCM 16000 Hz, 16 bit, mono
• PCM 22050 Hz, 16 bit, mono
• PCM 44100 Hz, 16 bit, mono
Related links
Configuring IVRs on page 61
d. Click OK.
2. To export a script in the XML format:
a. Click IVR > Export as XML .
The system displays the Export as XML dialog box.
b. In the Create IVR Script dialog box, type a name for the export file.
c. Click the IVR script to export.
d. Click Export.
The system creates an export file.
e. Click OK.
Documentation
See the following related documents on the Avaya Support website at http://support.avaya.com.
IP Office Contact Center User Interface for Windows documents
Document title Use this document for Audience
Administering Avaya IP Office Administer address books in the Administrators
Contact Center Address Book IP Office Contact Center interface.
The address book feature
simplifies agent tasks such as
making calls and sending emails.
Using the Avaya IP Office Contact Perform administration tasks with Administrators
Center Configuration and User the Configuration and UI
Interface Configuration Modules Configuration modules.
Note:
This document is also
available as a help system
through the product interface.
Administering Avaya IP Office Work with the Dialer module in the Administrators
Contact Center Dialer IP Office Contact Center interface.
Note:
This document is also
available as a help system
through the product interface.
Administering Avaya IP Office Create and edit IVR editor scripts. Administrators
Contact Center IVR Editor
Note:
This document is also
available as a help system
through the product interface.
Administering Avaya IP Office Create and edit task flow editor Administrators
Contact Center Task Flow Editor scripts. As of Release 10.0, this
document also contains the task
tag information that was previously
in a separate IP Office Contact
Table continues…
Note:
This document is also
available as a help system
through the product interface.
Administering Avaya IP Office Create, edit, and administer text Administrators
Contact Center Text Blocks blocks for the IP Office Contact
Center email feature.
Using Avaya IP Office Contact Use the IP Office Contact Center All interface users, including
Center for Windows User Interface for Windows. agents, supervisors, and
administrators.
Note:
This document is also
available as a help system
through the product interface.
Training
You can access training courses and credentials at http://www.avaya-learning.com. To search for a
course, after logging in to the website, enter the course code or the course title in the Search field
and press Enter or click >.
- Scroll down Playlists, and click the name of a topic to see the available list of videos posted
on the website.
Note:
Videos are not available for all products.
Support
Go to the Avaya Support website at http://support.avaya.com for the most up-to-date
documentation, product notices, and knowledge articles. You can also search for release notes,
downloads, and resolutions to issues. Use the online service request system to create a service
request. Chat with live agents to get answers to questions, or request an agent to connect you to a
support team if an issue requires additional expertise.
UNC UNC stands for Uniform Naming Convention. UNC is a widely accepted
standard for addressing shared resources, such as folders, drives, on a PC
network. UNC eliminates the need to assign a drive letter to connect. For
example: \\servername\sharename\path (Windows).
L rename ......................................................................... 61
speech elements
local variables ...................................................................... 55 IVR ................................................................................19
Logic elements .....................................................................55 storage
IVR ................................................................................11
support .................................................................................71
M
move T
script elements ............................................................. 54
scripts ........................................................................... 60 telephony elements
IVR ................................................................................32
time-off periods .................................................................... 65
O topology
opening IVR ................................................................................10
scripts ........................................................................... 51 IVR data ........................................................................11
Overview training ................................................................................. 69
IVR ..................................................................................8
U
P usage
Properties IVR ..................................................................................8
Assign ...........................................................................58
IVR .................................................................................... V
VU ......................................................................... 58
purpose ..................................................................................7 variables for language
IVR script ...................................................................... 13 speech elements .......................................................... 31
videos .................................................................................. 70
voice mails
R edit ................................................................................63
rename voice units
folders ...........................................................................61 configuring .................................................................... 61
scripts ........................................................................... 61
W
S WAV file formats .................................................................. 64
script elements WAV files ............................................................................. 55
adding ...........................................................................51
deleting ......................................................................... 54
editing ........................................................................... 54
examples ...................................................................... 52
move .............................................................................54
script errors ..........................................................................59
script folders
creating .........................................................................50
scripts
changing size ................................................................56
closing windows ............................................................60
connectors .................................................................... 53
creating .........................................................................51
deleting ......................................................................... 61
displaying windows .......................................................56
hiding windows ............................................................. 56
local variables ...............................................................55
move .............................................................................60
opening .........................................................................51
refreshing ......................................................................56