| For common questions see ---> |
|
| For applications/samples see ---> |
|
* How can I use
multiple calling cards within the same
"Location"?
Each
Speed Dial can be programmed to use a different Calling card available from pull down list
in Speed Dial Edit window, however customizing, changing or adding a new Calling
card should be done prior to it inside Dialing Properties window.
Selected Calling card in Speed Dial Edit window has priority over Calling card selected in
Dialing Properties but if "None (Direct Call)" is chosen in Speed dial Edit and
there is a selected Calling Card in Dialing Properties the latter one takes over. For the
dialer not to use the Calling Card at all, both places should have be selected "None
(Direct Call)". back
to the top
* How to use Phone Dialer
Pro from the command line?
Phone Dialer Pro accepts dialing requests at the command
line:
\application path\phonepro.exe /(123)-555 6789
or
\application path\phonepro.exe
123555 6789
the "/" is not necessary and the dialing sequence does not need to follow any
specific format.
Depending on usage Windows may require the command to be
enclosed in quotation marks:
"C:\Program Files\Phone Dialer
Pro\phonepro.exe" /4162340553
Preceding a phone number with the double characters "XX" will force dialer not
to use Dialing Properties (the number will be dialed exactly as entered).
Preceding a phone number with the characters "ZZ##" will force dialer to use
specific Calling Card for that number (ignoring selected Calling Card in Dialing
Properties), where ## is Calling Card ID number.
For example to dial 1(876) 123-4567 using Calling Card: "US Sprint Direct Dial via
10103331" :
\application path\phonepro.exe /ZZ09 1(876)
123-4567
It is also possible to invoke a selected Speed Dial from the command line. This feature is
very useful for the users wanted to automate dialing process by selecting different
Dialing Properties per call (different Calling Cards for example).
To dial a selected Speed Dial from the command line:
the trailing parameter format is:
/SD+S for Subject
(I for Index) mode + Tab number (including leading 0) + Speed Dial button number
example 1: \application path\phonepro.exe /SDS13657 --->
SpeedDial -> Subject mode:Tab=13, button=657
example 2: \application path\phonepro.exe /SDI0144 --->
SpeedDial -> Index mode: Tab=01, button=44
Note: there are not spaces allowed in this format.
To fully automate dialing process Phone Dialer Pro has the following available options
after making a phone call:
1. automatically dropping phone line (after specified time)
2. close Phone Dialer Pro or
3. stay minimized (on taskbar or Systray) after manually clicking OK button confirming
connected call.
Those options are available from the Tools>Options>Dialing tab.
|
Commands accepted by Phone
Dialer Pro |
|
Command |
Task
|
Example
|
Remarks
|
|
(555)-2340553 |
Dial Phone No
|
"....\phonepro.exe" 5552340553
"....\phonepro.exe" /5552340553
"....\phonepro.exe" (555)-2340553
|
phone number does not need to be formatted: it will be dialed
according to Dialing Properties rules
|
|
xx |
Ignore Dialing Properties
|
"....\phonepro.exe" XX5552340553
"
....\phonepro.exe" xx5552340553
"
....\phonepro.exe" /xx5552340553
|
ignore Dialing Properties and dial phone number
(555)-234 0553 exactly as entered
|
|
zz## |
Select Calling Card
|
"....\phonepro.exe" /ZZ065552340553
|
select 06-th Calling Card
|
|
loc# |
Select Current Location
|
"....\phonepro.exe" /loc25552340553
|
select 2nd Location in Dialing Properties
|
|
sds##### |
Select Speed Dial (subject mode)
|
"....\phonepro.exe" /sds13657
|
select Speed Dial:
Subject mode
Tab=13, Button=657
|
|
sdi##### |
Select Speed Dial (index mode) |
"....\phonepro.exe" /sdi0144
|
select Speed Dial:
Index mode
Tab=01, Button=44
|
|
loc#sds##### |
using simultaneously |
"....\phonepro.exe" loc2sds13657
|
2nd Current Location
Speed Dial: subject mode
Tab=13, Button=657
|
|
loc#sdi##### |
using simultaneously |
"....\phonepro.exe" loc1sdi0144
|
1st Current Location
Speed Dial: index mode
Tab=01, Button=44
|
| 0-9,#,*,A-D |
DTMF tones |
"....\phonepro.exe"
/{any digits combination} |
after phone call
connection is made sending additional DTMF tones |
|
flash |
flash hook
|
"....\phonepro.exe" /flash
|
resetting a phone line
|
| hangup |
End phone call |
"....\phonepro.exe"
/hangup |
drop active
connection |
| setup |
access to Options |
"....\phonepro.exe"
/setup |
opens Options
window |
|
default |
set default options
|
"....\phonepro.exe" /default
|
all setup options are set to default values
|
|
min |
minimize dialer's window |
"[...]\phonepro.exe" /min |
dialer will start in minimize mode |
commands
which work only when there is a dialer running
WARNING: new, open and
import commands will overwrite existing data without prompting |
| save <file> |
saves current
profile |
".\phonepro.exe"
/save <name of file > |
saves current
profile |
| new |
creates new profile |
"....\phonepro.exe"
/new |
creates new profile
(setup options are inherited) |
| open <file> |
opens new
profile |
".\phonepro.exe"
/open <name of file> |
opens new profile |
|
import < file > |
imports csv file into Address Book
|
".\phonepro.exe" /import <path to csv file > |
It automatically creates new profile and imports data from csv
file.
(setup options are inherited) |
back to the top
*
Using script
A script is a plain text file where each line
contains an individual command.
To see the list of available commands and a sample script, click on
the Help button beside that option.
Note:
Script can be
invoked by 2 methods:
1.
- select this option and specify the script file.
- save Options by clicking on OK button.
- make outgoing call:
-when the script begins with dial:
command ---> close dialer and start it from the command prompt
-in all other cases input the phone number in the
field provided above the keypad and click DIAL button.
When the call changes to 'Connected' state, script
execution will begin.
2.
- start dialer from the command line using one of the following commands:
<path>phonepro.exe /script
(this will use the script file specified in Options)
<path>phonepro.exe /script:<full path to
the script file> (this will use the script
file specified on this line)
Important:
When using scripts it is very important to synchronize
timing between commands by using the <wait: # > command.
<monitor_dtmf: #>
or <monitor_dtmf> commands must be always followed by the
<wait: #> command. See samples by using Help button
beside the 'Use Script' option.
Using Script Simulator:
Click TEST button to start Script Simulator. A new
window will pop open showing the real time script execution.
When the script waits for the keypad input, click on the desired
key on the PDP keypad.
This is the best way to test your script, fine tune it
and make sure that it does what the script was intended to do.
Note:
<dial> command starts a simulated action; it will not use the
modem and phone line.
Remarks:
Because Script Simulator does not use a modem at all, it is
possible to test scripts even if the modem is not a voice modem or the
modem is not able to generate (or receive) DTMF tones.
|
Script commands accepted by Phone Dialer Pro |
| COMMAND |
TASK |
|
err_key:# |
when a specified key is pressed, the
<monitor_dtmf: #> or
<monitor_dtmf> action will stop and the err_mess will be
played. |
| err_message: <file> |
message to be played
when err_key (above) is invoked. |
| err_wrong_key_message:
# |
when not expected key
is pressed, the last played message will play again if the
value # is 0 <default> |
| err_wait: # |
time delay in seconds: must be long
enough to play error message
(65 secs max) |
| err_line: # |
when err_key is
invoked, the script will continue from the specified line after
err_wait time delay (above). |
| err_timeout: # |
when no response is
received, monitoring DTMF tones will stop after # seconds (default
is 65 seconds) and the next line command after <wait:# > command will be
executed. |
| dial:<phone number> |
make outgoing phone call.
When a call already exists this command will be ignored. |
| monitor_dtmf:#
<action> |
wait for specified tone# and
perform action.
<action> can be any valid script command except <play:>.
Often, it will be <go_line:#> or <hangup>
This command (or group) must be followed by <wait:# > command. |
| monitor_multi_dtmf:#
<action> |
wait for specified
series of tones# and
perform action.
<action> can be any valid script command except <play:>.
Often, it will be <goto_line:#> or <hangup>
This command (or group) must be followed by <wait:# > command. |
| monitor_dtmf |
store all keystrokes in
file tones.txt, until # (pound) key is pressed.
This command must be followed by a <wait:# > command |
| dialdtmf:<0...9,#,*> |
send DTMF tones |
| wait:# |
program waits # of secs
before executing next command |
| go_line:# |
jumps to specified
script line |
| go_line:# loop:# |
repeated jumping to
specified line # times (loop #) |
| go_line:# loop:#
go_line:## |
after # times (loop #)
jumping to script line #, it will continue script execution from
line ##. |
| alert:<file> |
this is one of the
<action>. It will play the selected file over PC speakers
to alert the operator. |
| callerid:<CallerID>
<go_line:#> |
when the Caller ID
matches expected value, then
the script execution will jump to the specified script line |
| callerid |
this command will put
Caller ID on clipboard |
| answer:<#> |
incoming call will be
answered after # of rings |
| runapp:<path to
executable> |
it will launch the
specified file |
| runapp:<path to
executable>/callerid |
it will launch the
specified file with the Caller ID as a trailing parameter |
| flash |
it will perform
flashook or off-hook |
| hangup |
disconnect and drop the phone line |
| end |
disconnect, drop the phone line and
end script processing |
| delete |
delete the script file |
| // |
this line is ignored
(it is used for making comments) |
| |
|
Important:
err_... commands when used, should precede all other
commands.
but it is not necessary to use them at all.
Script must end with <end> command.
Ask me, if you need another command or action.
Script will be invoked automatically the next
time Phone Dialer Pro is called or manually by using systray
PDP icon's pop-up menu.
back to the top
* Importing Address
Book from csv file
Imported
entries are inserted into Phone Dialer Pro Index Mode and sorted alphabetically.
NOTE: To import Windows Address Book (WAB):
- Open WAB and export data to text file (csv file)
- Import that file into Phone Dialer Pro
For csv acceptable formats see this
Warning:
Importing Address Book will erase all existing programmed Speed Dial
buttons. To preserve existing buttons save the current profile, create the
new profile and then import Address Book into it.
* Importing Address
Book from Excel spreadsheet
Imported
entries are inserted into Phone Dialer Pro Index Mode and sorted alphabetically.
NOTE: Excel spreadsheet must be opened during this operation.
Warning:
Importing Address Book will erase all existing programmed Speed Dial
buttons. To preserve existing buttons save the current profile, create the
new profile and then import Address Book into it.
* Importing data into
selected, single tab
Data can be imported in any tab of your choice in Index Mode or
Subject mode and it will be sorted alphabetically and added to
existing entries.
Note: No existing Speed Dials will be erased.
*
How to
sort Speed Dials alphabetically?
To be able to
sort Speed Dials alphabetically the Dialer should have at least one Sub-Title button,
always the first speed dial button on any page, which has had an asterisk (*) typed in as
the first character - with or without any other name or instead of a name.
Note: Sorting happens between one asterisk button and the next, If you prefer to have any
first page (either in alphabetical or Subject Heading modes) unsorted to display speed
dial buttons you do not wish to be sorted and to remain at the start of that page as you
entered them by choice, do not place an asterisk in the first speed button of that page.
Upon clicking on the Asterisk button the dialer should ask for permission to sort all the
underlying Speed Dials. Underlying means all buttons belonging to that subtitle. If there
is only one Sub-Title Button all the Speed Dials buttons under that single Tab will be put
in alphabetical order (starting from button #2 to the last button #996).
If you have marked another Sub-Title - under the next Subject Heading tab for example,
then only those Speed Dials belonging to that Sub-Title and Heading will be sorted. Thus,
between the speed dial button you have clicked to trigger the sort and the next valid
Asterisk button.
A Sub-Title can only be the first Speed Dial button on any page which will not be
used to dial but to trigger sorting of your Speed Dials within a Tab/Heading.
Again, to create a Sub-Title simply place an asterisk (*) in front of the first Speed Dial
button's title, in the same way you would enter a name. Clicking on the Sub-Title button
will reveal a new window asking for confirmation to sort, see the picture below:
Figure 4.

back to the top
* How to use the dialing pad to
dial on the existing phone call?
User can send
additional digits using the dialing pad when:
1. modem supports sending DTMF tones
2. Phone call was made in 'Voice' mode (Tools>Options>Voice
tab).
This can be useful in situations when the user does not want to send additional digits
together with the phone number.
back to the top
* How to
transfer a phone
call?
In Tools > Options > Dialing tab, the option:
"Enable Call Transfer" must be selected.
When that option is selected, the PDP second phone book
(II) becomes Call Transfer Phone Book.
To transfer the call PDP has to make an outgoing
call or receive an incoming call. When the oval Progress Call Window displays that
call, clicking on the Speed Dial button in the Call Transfer Phone Book should transfer the
call.
Note: That option may not be supported by some hardware (modems)
or by the phone co. back to the top
*
How to
recover from errors?
Resetting PDP options to default values may help.
To do that start PDP with "default"
as a trailing parameter:
[...] \phonepro.exe
/default
back to the top
*
How to check that modem has ability to send / receive
DTMF tones?
Most of the
voice modems have that functionality.
If you want to make sure that your modem is capable of sending and
receiving DTMF tones:
1.
Use the test file and
and send TapiLog.txt log file to
author.
or
2.
Using this dialer make a phone call to the voice mail (for example
your bank) and using dialer's dialpad try to navigate the voice
mail.
If you can, your modem is capable.
back to the top
*
Using
the test file to diagnose hardware or
software problems
1. Click
here
to download the test
file (430 kB)
2. Run it and use it the same way you were using the original file,
until the problem (error) appears.
3. Close program.
4. Find Tapi.txt log file in the same folder the test file
was run from.
5. Send that file to
author.
Please make sure to add
comments saying what you are doing externally and where you think the
problem is.
Note:
When the error is a 'run-time' type error it causes the premature program
termination and TapiLog.txt log file will not be generated.
In that case run the test file with /tapilog suffix (<path><phonepro_test.exe
/tapilog) and the second diagnostic window will open. Just save it's content and
send it to
author.
back to the top
*
How to get rid of 'Run Busy Detect' startup message?
A properly detected busy signal is very
important for the determination of the Connected phone line state.
It is recommended to use the Detect Busy utility. See it in the Tools>Options>Hardware
tab.
If for some reason your device cannot detect busy (for example, your phone
company may provide voice mail instead of a busy signal), there are 3
other methods you can use:
1.
Disconnect phone line from your modem and click on Start
button beside this option. Enter any number when asked.
Click OK and wait until no dialtone detection will end.
Real time
call progress is displayed in small box beside the Start button.
2.
Make a phone call and measure the time it takes to the first audible ring. Manually insert that
number into the Busy Detect option in the Tools>Options>Hardware tab and
click OK to save the options. The value should be between 8-13 seconds for
most modems.
3.
Find the phonepro.ini file located in:
Windows XP:
C:\Documents and Settings\<user name>\Application Data\Phone Dialer
Pro\phonepro.ini
Windows Vista and Windows 7:
C:\Users\<user name>\AppData\Roaming\Phone Dialer
Pro\phonepro.ini
Open it in a word editor (Notepad, MsWord) and do the following:
- find Busy Detect=0 and change it to Busy Detect=1
- find Busy Delay Timer and change it to Busy Delay
Timer=13
Note:
The busy detect value is stored into
phonepro.ini on dialer's termination.
back to the top
*
How to override options?
Find the phonepro.ini file located
in:
Windows XP:
C:\Documents and Settings\<user name>\Application Data\Phone Dialer
Pro\phonepro.ini
Windows Vista and Windows 7:
C:\Users\<user name>\AppData\Roaming\Phone Dialer
Pro\phonepro.ini
Open it in a word editor
(Notepad, MsWord) and edit the entries you are interested in.
To set all options to default values run application with /default
suffix: <path>phonepro.exe /default
back to the top
*
Developers corner
Dialer can be controlled by using the following 3 methods:
* from the command line prompt: see
How to use
Phone Dialer
Pro from the command line?
*
Simple
VB code sample how to invoke dialer and make a phone call.
* Windows text messaging by using
SendMessage() API
Note:
1.
For the list of available commands see:
http://www.phonedialerpro.com/faq_pdp.htm#command_line
2.
When using SendMessage() API:
LRESULT SendMessage(
HWND hWnd,
UINT Msg,
WPARAM wParam,
LPARAM lParam
);
hWnd
retrieve and use the
value stored in Windows registry:
HKEY_CURRENT_USER\Software\Jacek Kozlowski\Excel Dialer Pro\hkey
Msg
use WM_COPYDATA
wParam
0
lParam
structure
containing information to be send
.lpData
should contain command
.dwData = 1 use
only with commands: "", "min" and "setup"
.dwData = 2 use
only with "script...." command
.dwData = 3 use
with all other commands
back to the top
|