User`s guide

Dialogic
®
System Release 6.0 PCI for Windows
®
Release Update, Rev 62 — January 30, 2008 55
Dialogic Corporation
1.8 Enhanced Special Information Tones on Dialogic
®
DM3 Boards Using Voice and Global Call APIs
With the Service Update, the user has the ability to detect new custom special information
tones (SITs) on Dialogic
®
DM3 Boards using the Dialogic
®
Voice API and Dialogic
®
Global Call API. The new custom SITs are detected via the regular API events for
detecting call progress analysis outcome, and in particular, SIT tone detection. In addition,
create, query, and modify support of these new SIT tones and three existing default tones
via the Voice API is now available.
1.8.1 Feature Description
Predictive dialing applications, which are widely used in call centers, need to detect a
variety of SITs being used by Service Providers around the world. For this feature, the
Voice and Global Call APIs each provide an additional 15 SITs with customizable SIT
templates, which allow the user to detect a variety of nonstandard SITs used by Service
Providers. When the board firmware detects an incoming SIT tone during call progress
analysis, it tries to match it to one of the existing (default) templates. Tones that do not
match the default templates will be matched against the custom SIT templates created by
the user, and reported as such. If the SIT still does not fall into any of those two
categories, custom or standard, it may still be collected and reported as undetected
(SIT_ANY), and also reported back.
Voice API
For the Voice API, the 15 new custom tone templates (plus the existing default tone
templates) are supported for detection and reporting by the ATDX_CRTNID( ) function.
(For a description of the ATDX_CRTNID( ) function support on DM3 Boards, see
Section 1.59, “Enhanced Special Information Tone Frequency Detection on Dialogic
®
DM3 Boards”, on page 229.)
For this feature, full create, query, and modify support has been added for the new custom
SITs and for three of the existing default SITs, via the dx_createtone( ), dx_querytone( ),
and dx_deletetone( ) functions, as follows:
#define TID_CUSTOM_SIT1
#define TID_CUSTOM_SIT2
#define TID_CUSTOM_SIT3
#define TID_CUSTOM_SIT4
#define TID_CUSTOM_SIT5
#define TID_CUSTOM_SIT6
#define TID_CUSTOM_SIT7
#define TID_CUSTOM_SIT8
#define TID_CUSTOM_SIT9
#define TID_CUSTOM_SIT10
#define TID_CUSTOM_SIT11
#define TID_CUSTOM_SIT12
#define TID_CUSTOM_SIT13
#define TID_CUSTOM_SIT14
#define TID_CUSTOM_SIT15