Contents

VoiceGuide Help
1. Introduction
Welcome To VoiceGuide
Which version to use
2. System Configuration
System Requirements
Installing v7.x - Dialogic
Installing v7.x - VoIP / HMP
Installing v6.x - Dialogic
Installing v5.x - Voice Modems
Installing v5.x - CAPI compatible cards
Installing v5.x - Dialogic
Installing v5.x - Dialogic Wave Drivers
Text To Speech
Call Transfers and Conferencing
ODBC Data Sources
End of Call Detection
Distinctive Ring Detection
T1/E1 ISDN Configuration
T1/E1 RobbedBit/CAS/R2 Configuration
VoIP Line Registration
Command Line Options
Registering VoiceGuide
Unique System Identifier
3. Script Design
Introduction
Graphical Design Environment
Module Types
Paths
Result Variables
Call Start
Call Finish
Multilanguage Systems
Protected Scripts
Sound files
Testing Scripts
4. Modules Reference
Play
Record
Get Numbers
Say Numbers
Transfer Call
Send Phone Message
Send Pager Message
Send Email
Database Query
Run Program
Time Switch
Evaluate Expression
Run VB Script
Send DDE Command
Hangup Call
5. Voicemail
Introduction
Voicemail System Manager
Voicemail Menus
Message Lamps
6. Outbound Dialing
Loading Numbers to Call
Detect Call Answer
Predictive Dialers
External OutDialQue Source (v7)
External OutDialQue Source (v6)
7. Speech Recognition
Introduction
Grammars
Install LumenVox
8. Logs
Script Logs
Call Detail Records (CDRs)
9. ActiveX / COM Interface
Admin_TraceLogAdd
Dialer_MakeCall
Dialer_OutDialQueAdd
Bridge_Connect
Bridge_Disconnect
Line_Hangup
Line_Pickup
Play_Start
Play_Stop
Record_Stop
Record_Start
Record_2Lines_Start
Run_ResultReturn
RvGet
RvGet_All
RvGet_AllXml
RvSet
RvSet_RvList
Script_Gosub
Script_Goto
Script_Return
Serial_Tx
Vm_Event
Vm_VmbConfig_Get
Vm_VmbConfig_Set
10. PBX Integration (CTI)
Inband Signaling
Ericsson MD110 Voicemail Interface
Legal Information
Copyright & Disclaimer

 
Home
VoiceGuide Online Help
Prev Page Next Page
 
 

Installing v5.x (TAPI version) on systems using Dialogic cards

Please note that on systems which use Dialogic cards we strongly recommend using versions of VoiceGuide specifically designed to work with Dialogic cards directly, without using the Dialogic's TAPI drivers (ie. VoiceGuide v7 or v6). Dialogic's TAPI drivers have many problems and have been discontinued for a number of years now.

If for some reason you still would like to use v5.x of VoiceGuide with Dialogic's TAPI drivers then please follow the instructions below:

 

The following Dialogic cards can be used with VoiceGuide v5 (TAPI version) :

D/4PCI, D/4PCIU, D/4PCIUF, D/41E, D/41EPCI, D/41JCT, D/41ESC, D/41H, D/42 series, D/120JCT, D/160S, D/21H, ProLine/2V, D/21D, D/41D, Dialog/2, Dialog/4, all digital T1/E1 cards: D/240, D/480, D/300, D/600.

Digital T1/E1 cards can only be used in Robbed-Bit/CAS systems. ISDN is not supported by Dialogic TAPI drivers.

Installing PCI Dialogic Cards

Dialogic PCI voice cards have a small rotary switch (on the circuit card), which sets the board number. If this is the first Dialogic voice card in the PC, set the board number to 1. Plug the Dialogic voice card into any available PCI slot on the PC mother board.

  1. After fitting the Dialogic PCI voice card, re-start the PC. The "Found New Hardware Wizard" will be displayed. Press Next.
  2. Select the "Search for a suitable driver" option.
  3. Select only the "Specify a location" option.
  4. Browse to the Dialogic installation directory's \DRVR\ subdirectory.
  5. Press Next.
  6. The correct Dialogic card name should be displayed. Press Finish.
  7. Start the Dialogic Configuration Manager: From the Start menu, select Programs, then Dialogic System Software, then Dialogic Configuration Manager.
  8. Connect to the local computer, auto card detection will begin.
  9. Check if the voice card has been auto-detected.
  10. Double click on the voice card icon and set the country parameter to the correct value.
  11. Select Start-Service from the Service menu. The service will take up to 30 seconds to start.
  12. From the Service menu, select Startup-Mode, then Automatic.

If the card is not detected, or the model is displayed as ????, do the following:

  1. Reboot the PC
  2. Enter the system BIOS
  3. Disable "Plug & Play" and/or disable ACPI
  4. Repeat steps 7 to 9 above

 

Installing ISA Dialogic Cards

Dialogic ISA voice cards have jumper switches for setting the hardware interrupt level (IRQ) and base memory address segment. When fitting these Dialogic voice cards, it is essential to choose a hardware interrupt level and base memory address segment that do not conflict with existing equipment installed in your PC.

How to check for un-allocated IRQ and memory on Windows NT:
From the Start menu, select Programs, then Administrative Tools, then Windows NT Diagnostics.
Press the Resources tab.
Press the IRQ button to view currently allocated IRQs.
Press the Memory button to view currently allocated segments.

How to check for un-allocated IRQ and memory on Windows 2000/XP:
From the Start menu, select Programs, then Accessories, then System Tools, then System Information.
Expand the Hardware Resources folder.
Press the IRQs folder to view currently allocated IRQs.
Press the Memory folder to view currently allocated segments.

Having identified suitable free IRQ and memory address, configure the card by setting the jumpers and switches located on the card. IRQ 5 is usually a good choice, the base memory address can usually be left at the default D000.

  1. After fitting the Dialogic ISA voice card, re-start the PC.
  2. Start the Dialogic Configuration Manager: From the Start menu, select Programs, then Dialogic System Software, then Dialogic Configuration Manager.
  3. Connect to the local computer.
  4. Auto card detection will begin.
  5. The ISA card will not be auto detected. Select Add-Device from the Action Menu.
  6. Select the voice card model.
  7. Give the voice card a name or number.
  8. Setup the correct IRQ and memory values. (May need to double-click on the displayed voice card icon first)
  9. Set the country parameter to the correct value.
  10. Select Start-Service from the Service menu. The service will take up to 30 seconds to start.
  11. From the Service menu, select Startup-Mode, then Automatic.

 

Next please carry out the installation of Dialogic’s TAPI and Wave drivers as per the instructions below and then test your system using Dialogic’s TALKER32 application as outlined in the last part of this chapter.

After installing the Dialogic TAPI and Wave drivers you can test the system using the Dialogic demonstration application TALKER32. TALKER32 uses the TAPI/Wave interface to control the Dialogic card, which is the same control interface used by VoiceGuide.

Boards D/21D, D/41D, Dialog/2, Dialog/4 and VFX/40 can only support Mu-Law WAV files under TAPI/Wave. You will need to download this set of VoiceGuide system sound files if you intend to use VoiceGuide with those boards.

 

Installing Dialogic System Release Drivers

Dialogic's System Release 5.1.1 SP1 software should be used. Later versions of Dialogic drivers do not support TAPI.

Please always refer to the Dialogic’s Release Notes and/or Installation Notes to determine what Operating System may be used.

Please read the Dialogic card's release notes and help files to ensure correct installation and configuration of your Dialogic card - these will cover how to set up your card to correctly detect busy and engaged tones, and perform call transfers correctly. Sometimes you will need to specify a particular “Parameter File” in the Dialogic’s Configuration Manager to ensure the card is set up to work correctly with phone lines in your country. Please consult your local Dialogic representative regarding any questions relating to configuration of your Dialogic card.

D/4PCIU & D/4PCIUF cards require either the SR5.1.1 Feature Pack 1 drivers, or the SR5.1.1 + SR5.1.1 SP1 + D4PCIU support patch.

When installing the Dialogic software select 'Custom Installation' option and ensure that the TAPI Drivers and the Global Call option is selected. Global Call needs to be installed in order for the TAPI Driver to be loaded.

Full instructions on installing the TAPI and Wave drivers can be found in the Dialogic help file “d41mt.hlp” located in Windows’ System32 directory.

After installing the Dialogic software you will need to configure the TAPI Driver and the Wave Driver.

 

 

Installing Dialogic TAPI driver

1. Run the Telephony applet in the Control Panel:

  • Click Start.
  • Point to Settings.
  • Click Control Panel.
  • Double-click Phone and Modem icon (or Telephony icon).

2. Click the Advanced tab (or Telephony Drivers tab).

3. If the Dialogic Service Provider for NT does not appear in the Telephony Drivers tab, do the following to add it:

  • Click Add to display the Add Driver dialog.
  • Click the Dialogic Generation 2 Service Provider for NT to select it (if it is not shown, restart your PC and try again).
  • Click Add. The Dialogic TAPI driver (TSP) Configuration dialog is displayed.

4. Click Detect Boards to update the list of Dialogic board channels (dxxxB1C1 is board 1 channel 1). The list is updated to match the configuration that was most recently started. You can click Help to access on-line help for the TSP configuration.

5. Click OK to close the Dialogic TSP Configuration dialog. The Dialogic TSP should now appear in the Telephony Drivers tab. Note that the Configure button can be used to redisplay the Dialogic TSP Configuration dialog.

6. Click OK (or Close) button to exit the Telephony applet.

After installation use the Dialogic Configuration Manager to configure and start the board. 

 

Installing Dialogic Wave driver

  1. Go to the Start Menu->Settings->Control Panel->Add/Remove Hardware to start the Add/Remove Hardware Wizard
  2. Click Next.
  3. Select Add/Troubleshoot a Device and click Next.
  4. Windows will attempt to find any new plug and play devices. It should find none. Select "Add a new device" and click Next.
  5. Select “No, I want to select the hardware from a list” and click Next
  6. Select “Sound, video and game controllers” and click Next
  7. Click “Have Disk” and browse to the "Program Files\Dialogic\LIB" directory.
  8. Select the “oemsetup” file and click open. Then click OK on the next screen.
  9. Select the “Dialogic WAVE driver 1.X” and click Next.
  10. Click Next. You will receive a warning that a digital signature is not found. Click Yes to continue the installation.
  11. If asked for path to "dlgwave.dll" it should be found in Windows' "System32" directory, else it is also available in the "Program Files\Dialogic\LIB" directory.
  12. Restart the computer for the changes to take affect

See here for step-by-step guide with screenshots.

The “Dialogic WAVE driver 1.X” should now be seen in the Device Manager (Control Panel -> System -> Hardware Tab -> Device Manager).

 

The “No drivers are installed for this device” message in the “Device Status” box is normal. Once “Dialogic WAVE Driver” is listed in Device Managers “Sound, video and game controllers” section then this indicates that the Wave drivers are working.

If the “Dialogic WAVE Driver” entry has an exclamation mark next to it then this indicates that the Wave drivers are not correctly installed and that they should be uninstalled and re-installed again.

The remainder of the recommended configuration for the Wave drivers is shown below:

 

 

Installing Dialogic Wave driver - Windows NT :

To check if the Dialogic driver has been installed open the Control Panel and run the Multimedia applet. Click on the Devices tab. You should see something like this:

In the example above the Dialogic wave driver has already been installed. If the driver is missing, click on 'Add...'. You should now see the Add window.

Select the 'Unlisted or Updated Driver' option and click OK. you should now see the 'Install Driver' window.

The wave driver is located in the 'Lib' directory of your Dialogic installation. Specify the path to the 'Lib' directory and click OK. You will need to restart the computer before the changes take effect.

 

Wave driver problem solving (reinstallation)

Sometimes installing 3rd party Sound Recording software or other changes to wave driver configuration results in the Dialogic (or voice modem) wave drivers being re-mapped incorrectly, resulting in the sound files from the running script being played through the computer's speakers, or "WAVERR_BADFORMAT" errors returned when trying to play sound files (even when the preferred format sound files are used: for Dialogic: PCM 11025Hz, 8bit, Mono and for Voice modem: PCM 8000Hz, 16bit, Mono).

In these situations the Dialogic (or voice modem) wave drivers should be uninstalled and the re-installed again in order to have them play the sound files correctly. The computer must be rebooted after the driver uninstall and then again rebooted after driver re-install. It is a good idea to uninstall all wave drivers and install just the Dialogic/Modem wave driver first. If that works then other Wave drivers (sound card etc) may be added.

To uninstall the wave driver:

1. Run the Control Panel Sounds and Multimedia applet.
2. Click the Hardware tab.
3. Select Audio for Dialogic WAVE Driver (or the "Unimodem Half-Duplex Audio Device" if using voice modem).
4. Click Properties.
5. Select "Driver" tab.
6. Click Uninstall.
7. Reboot computer before re-installing driver.


 

Test using Dialogic’s TALKER32

Once the TAPI and Wave drivers have been installed and the Dialogic service is running you can test the Dialogic card using Dialogic’s TALKER32 TAPI Demo/Testing Application.

TALKER32 can be found by following:

Start -> Programs -> Dialogic System Software -> Dialogic Sample Programs -> TAPI

When you start TALKER32 it will find all TAPI devices on the system – amongst them the Dialogic lines should be listed. You can find out which are the Dialogic lines by pressing the “Info” button and looking at the description on the Line Information dialog – for Dialogic lines it will say “Line type: Dialogic Gen 2”

Find all the Dialogic lines and select the “Auto Answer” and “Auto Play” check boxes, and also for each Dialogic line click the “Select file to play” and indicate the sound file “play.wav” from the TALKER32’s directory (\Program Files\Dialogic\Samples\Talker32\play.wav) should be used.

When you now call into the system TALKER32 will answer the call and play “Welcome to Dialogic…”

If the caller has heard that sound file being played then the system is now ready to be used with VoiceGuide.

 

Configure Dialogic TSP

Dialogic TSP (Telephony Service Provider) can be accessed using:

Win98/NT: Open Control Panel’s Telephony applet, select the Telephony Drivers tab, select the Dialogic Service Provider and the press Configure.

Win2000/XP: Open Control Panel’s “Phone and Modem Options” applet, select the Advanced tab, select the Dialogic Service Provider and then click Configure:


Dialogic TSP Configuration allows setting of the the number of rings after which the call should be reported, definition of disconnect/busy tones which are used by your telephone network, and the commands used by the PBX to transfer calls correctly. For more information please see also: Dialogic Call Transfers and Disconnection Detection

 

Running the Setup Wizard

The Setup Wizard will discover all the TAPI capable telephony devices and will allow you to select which devices you would like to use with VoiceGuide:


Next you need to select the Scripts which will be used by VoiceGuide when an incoming call arrives on the selected devices. To begin with we'd recommend you select the demonstration script in VoiceGuide's "/Scripts/Credit Card Payment" directory:


When Setup Wizard configuration has completed you should now be able to start VoiceGuide and call into the system to hear it answer the call and lead you through the selected VoiceGuide script.

You can open the "/Scripts/Credit Card Payment" in the Graphical Design Environment to see how the script has been put together.

 

Wav file format

When using Dialogic TAPI drivers all sound files should be in format: PCM 11kHZ, 8 bit, Mono. That is the only format which the Dialogic TAPI drivers accept.

 

Found New Hardware Wizard on Win2000

If the Found New Hardware Wizard keeps popping up every time you start Windows, and you are unable to stop it by pressing Cancel please read:

http://resource.intel.com/telecom/support/tnotes/tnbyos/winnt/tn383.htm
or:
http://voiceguide.com/forums/index.php?showtopic=1147

 

Converted from CHM to HTML with chm2web Pro 2.7 (unicode)