How to Send Messages Using TouchTone Transcript for Video:
Welcome to the video tutorial on how to configure PageGate’s Get Touch Tone receiver. In this tutorial, we’ll be going over how to use a dial-up modem to receive touch-tones with our GetTouchTone receiver.
Before we begin, the GetTouchTone module requires PageGate’s GetASCII interface to function. For licensing information, please contact our Sales Department at firstname.lastname@example.org or by phone at 781-829-0500 x 1.
The first step is to find the location of the PageGate program and data directories. To do so, open the PageGate Admin, then go to Program – Settings. Here on the right, make a note of the program directory as well as the root of your general data folders.
Now that we have those paths, we’ll need to create a directory for the GetTouchTone receiver’s files. Typically speaking, we recommend that you create this directory on the PageGate server itself but this isn’t a requirement. You can host this process on another system and share the GetTouchTone receiver’s folder on the network to grant the PageGate server access to it.
In this tutorial, we’ll be doing the local configuration, so open a file browser and browse in to the PageGateData directory. Next, create a folder. This folder can be named anything you like but I recommend using the name ‘Tones’ just to keep things simple.
Now we want to browse in to the PageGate program directory. Once there, find pgttreceiver.exe and pggttone.txt, select them and copy them. Then browse back in to the Tones folder you created and paste the files here.
Next, open pggttone.ini in your preferred text editor.
The pggttone.ini file is the basic configuration file for the GetTouchTone receiver.
Change RunStyle=Application to RunStyle=Service
Change SwitchStyle=False to SwitchStyle=True
SilenceTimeout determines the number of seconds the touch-tone receiver will wait for tones before hanging up. If it has not received any tones within that time period, it will disconnect the call.
DataFolder determines where the GetTouchTone receiver will output received messages. This can be any folder local to the GetTouchTone receiver but I recommend using the GetTouchTone receiver directory as the output folder. In this instance, we would use c:\PageGateData\Tones\ as the output folder.
FileExtension determines what extension the touch tone receiver will add to files generated from received tones. By default, this extension is .ttm
The Modem section controls how the TouchTone receiver will interact with the dial-up modem.
ComPort will need to be set to the COM port of your modem.
Next we have four possible strings that can be used and each of them do something a bit different.
InitString determines the basic initialization string that should be used to answer calls. If you’re using a modem with a Conexant based chipset, use this init string AT&FQ0V1X4S0=1+FCLASS=8
For older US Robotics modems, use this init string: AT&F0Q0V1X4S0=0#CLS=8
And for newer US Robotics modems, use this init string: AT&FQ0V1X4S0=0
Effectively, these initialization strings tell the modem “Answer after 1 ring”.
ConnectString, ConnectString1 and ConnectString2 are all used after the initial call is made. So, a call comes in and the InitString tells the modem how to answer it. The Connect strings tell the TouchTone receiver what to do after a call has been made.
If it shouldn’t do anything other than wait for the tones, leave all three fields blank. If the system dialing in to the touchtone receiver needs an acknowledgement, configure that in the ConnectString section.
If the negotiation is multi-staged, use the ConnectedString1 and ConnectedString2 fields to specify additional AT commands to pass to the modem.
Once you’ve finished setting the GetTouchTone receiver’s configuration values, save and close the INI file.
Now we’ll need to determine if we want to run the GetTouchTone receiver as an application or Windows service. To run it as an application, simply double click on pgttreceiver.exe to run the program. However, we definitely recommend running the GetTouchTone receiver as a Windows service. Applications are logon dependent, which means a user must be logged in to the desktop of Windows before an application can run. Windows services, on the other hand, are not logon dependent, which means that you could reboot the system and not log in to the desktop and the GetTouchTone receiver will still run and accept messages in the background.
To run the GetTouchTone receiver as a service, run a command prompt with elevated permissions in Windows. To do so, go to your start menu, then search for the word ‘command’. When ‘Command Prompt’ comes up, right click on it and select ‘Run as Administrator’.
Change directory in to the GetTouchTone receiver program directory.
Once here, type pgttreceiver /install and hit enter.
Now open the Windows Services list.
Find the PageGate GetTouchTone receiver service, then right click on it and select ‘Start’.
The final step is to configure PageGate’s GetASCII interface to watch for output from the GetTouchTone receiver. To do that, open the PageGate Admin.
Now go to Interfaces – GetAscii – Settings. If you do not currently have a polling directory specified, set this to the GetTouchTone receiver’s output folder. By default, c:\PageGateData\Tones\. Check Enabled, click Apply and tell it yes, you do want this to be enabled.
If you do already have a polling directory specified, you’ll want to go to Interfaces – GetAscii – Settings – Advanced Polling – Files.
Click Add to add a new entry to the files table.
Set Recipient to: *
Set From to: Tones
Set File(s) to: *.ttm
Set the Path to the GetTouchTone receiver’s output folder. By default, c:\PageGateData\Tones\
Set File Type to: Standard
Then click Apply and click Apply again.
This concludes the video tutorial on how to configure PageGate’s GetTouchTone receiver.