For common questions see ---> |
|
For applications/samples see ---> |
|
* How to use Dial Engine Pro from the
command line?
To enable, in Options>Dialing tab select
"Accept command line trailing parameters", as shown on
Figure 3.
Dial Engine Pro uses the same commands as Phone
Dialer Pro.
To see a full list of available commands click
here.
Dial Engine Pro accept dialing requests at the command line:
\application path\dial.exe
/(123)-555 6789
or
\application path\dial.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\Dial Engine
Pro\dial.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\dial.exe /ZZ09
1(876) 123-4567
To fully automate dialing process Dial Engine Pro has the following
available options after making a phone call:
1. automatically dropping phone line (after specified time) in
Options>Dialing tab window.
2. close Dial Engine Pro
or
3. stay minimized (on taskbar or Systray) after manually clicking OK
button confirming connected call.
Commands accepted by Dial Engine Pro |
Command |
Task |
Example |
Remarks |
(555)-2340553 |
Dial Phone No |
"....\dial.exe"
5552340553
"....\dial.exe" /5552340553
"....\dial.exe" (555)-2340553 |
phone number does
not need to be formatted: it will be dialed according to Dialing
Properties rules |
xx |
Ignore Dialing
Properties |
"....\dial.exe"
XX5552340553
"....\dial.exe" xx5552340553
"....\dial.exe" /xx5552340553 |
ignore Dialing Properties and dial phone number
(555)-234 0553 exactly as entered |
cc## |
Select Calling Card |
"....\dial.exe"
CC065552340553 |
select 06-th
Calling Card |
loc# |
Select Current
Location |
"....\dial.exe"
loc25552340553 |
select 2nd Location
in Dialing Properties |
loc#cc## |
using simultaneously |
"....\dial.exe"
loc2cc075552340553 |
2nd Current
Location 07th Calling Card as shown in Dialing Properties |
flash |
flash hook |
"....\dial.exe"
/flash |
resetting a phone
line |
0-9,#,*,A-D |
DTMF tones |
"....\dial.exe"
/{any digits combination} |
after phone call
connection is made sending additional DTMF tones |
default |
set to default GENERAL options
|
"....\dial.exe" /default
|
GENERAL options are set to default values
|
icon_on |
shows icon in systray |
"....\dial.exe" /icon_on |
restores access to options |
icon_off |
removes icon from systray |
"....\dial.exe" /icon_off |
makes dialer invisible |
default_line# |
set to default selected line options
|
"....\dial.exe" /default_line0
|
Line 0 options are set to default values
|
datamodem |
connects to another
modem |
"....\dial.exe" /datamodem |
test for the
presence of modem receiving your call |
hangup |
End phone call |
"....\dial.exe" /hangup |
drop active
connection |
setup |
access to Options |
"....\dial.exe"
/setup |
opens Options
window |
default |
set default options
|
".[...]\dial.exe" /default
|
all options are set to default values
|
min |
minimize dialer's window |
"[...]\dial.exe" /min |
dialer will start in minimize mode |
script_<out><in> |
run script (outgoing or incoming calls) |
"[...]\dial.exe" /script_out
"[...]\dial.exe" /script_in |
will run outgoing call script
will run incoming call script |
script_out <path to script file> |
reads and executes script |
"[...]\dial.exe" /script_out c:\script11.txt |
script file specified on command line will be used |
*
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.
- mouse right click on DEP systray's icon and select 'Run Script' from
pop-up menu
or
- 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>dial.exe /script
(this will use the script file specified in Options)
<path>dial.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 DEP 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.
Ask us, if you need another command or action.
Script commands accepted by Dial Engine Pro |
COMMAND |
TASK |
|
alert:<file> |
this is can be used as
a stand alone command or as one of the
<action>.
It will play the selected file over PC speakers
to alert the operator. |
answer: # |
answers incoming call
after specified number of rings.
Note: This command is necessary to detect
(or send) DTMF tones on incoming call |
callerid: <number> go_line:# |
monitors incoming call
and when CallerID matches <number>
script will jump to the
specified script line.
Note: it must be the first script line
command. |
callerid |
puts incoming call's
CallerID on Windows clipboard |
delete:
script_out
delete: script_in |
delete the script file |
dial:<phone number>
dial: callerid
dial: rx |
makes outgoing phone
call using specified number
makes outgoing call using the last received call's callerID as a
phone number
makes outgoing call using digits received from monitor_dtmf
command |
disable: script_out
disable: script_in |
disable scripting
option in the current session
(dialer must be restarted to enable scripting option again) |
end |
ends script processing |
flash |
it will perform
flashook (off-hook) |
go_line:#
go_line:# loop:#
go_line:# loop:#
go_line:## |
jumps to specified
script line
repeated jumping to
specified line # times (loop #)
after # times (loop #)
jumping to script line #, it will continue script execution from
line ##. |
hangup |
disconnect and drop the phone line |
monitor_dtmf:#
<action> |
wait for the 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_busy: go_line:# |
when busy signal is
detected then go_line:# action is performed
This command (or group) must be followed by wait:# command.
It can be teamed only with monitor_pickup command. |
monitor_pickup: go_line:# |
when the call pickup is
detected then go_line:# action is performed
This command (or group) must be followed by wait:# command.
It can be teamed only with monitor_busy: command. |
monitor_dtmf:#
count_<action> |
waits for the specified
tone#, increments the count and performs action.
Normally, the action should be <go_line:#> and the target
script line should be on_count: # <action>
This command (or group) must be followed by wait:# command. |
monitor_dtmf |
stores received DTMF
tones, which can be used to dial out
using dial:rx command
This command must be followed by a wait:# command |
monitor_multi_dtmf:### |
wait for the specified
series of DTMF tones ###
It can be followed by dial:<number> command.
This command (or group) must be followed by wait:# command. |
on_count: # <action> |
when the count
reaches the specified number (#) then the <action> will be
performed. The count is produced by monitor_dtmf:#
count_<action> |
pause |
pausing the script
execution until call is over |
record_start
record_stop |
starts recording voice
conversation (Skype call only)
stops recording |
run_app: callerid
run_app: <full
path to app> |
will start application,
which title is the same as incoming Caller ID
will start the
specified application |
terminate |
dialer's application
is terminated |
wait:# |
program waits # of secs
before executing next command |
// |
command starting with
// is ignored
(it is useful for making comments or disable script's line) |
|
|
Script sample 1
(incoming calls) |
Note: each command must contain ':'
when more information is specified. |
script line: |
what it will do: |
callerid:jacek go_line: 5 |
when call from jacek go to line
5 (answer: 1) |
callerid:5552340553 go_line: 15 |
when call from 5552340553 go
to line 15 (answer: 5) |
callerid:phonedialerpro go_line: 28 |
when call from phonedialerpro
go to line 28 (hangup) |
endscript |
script ends with the arrival of any
other CallerID |
answer: 1 |
incoming call will be picked up after
1 ring |
wait: 1 |
pause 1 sec |
monitor_dtmf |
dialer will store all keys received
in the next 10 seconds |
wait: 10 |
wait for the keys for 10 seconds |
hangup |
phone call will be dropped |
wait: 1 |
pause 1 sec |
dialdtmf:rx |
dialer will use the stored numbers as
a ph.number to dial out |
wait: 10 |
pause 10 sec |
hangup |
phone call will be dropped |
endscript |
script ends |
answer: 5 |
incoming call will be picked up after
5 rings |
wait:1 |
pause 1 sec |
monitor_dtmf:3 go_line: 22 |
when '3' is pressed go to line
22 |
monitor_dtmf:5 go_line: 25 |
when '5' is pressed go to line
25 |
wait:7 |
wait for the key for 7 seconds |
hangup |
phone call will be dropped |
endscript |
script ends |
runapp: c:\alert.exe |
launches c:\alert.exe program |
hangup |
phone call will be dropped |
endscript |
script ends |
runapp: c:\monitor.exe |
launches c:\monitor.exe
program |
hangup |
phone call will be dropped |
endscript |
script ends |
hangup |
phone call will be dropped |
wait:5 |
pause 5 secs |
dial: 5552340553 |
dial out |
wait:18 |
pause 18 secs |
hangup |
phone call will be dropped |
end |
script ends |
Important:
Script must end with <end> command.
Ask us, if you need another command or action.
back to the top
* Using
Skype
To make a phone call using Skype services:
- choose Skype as the selected line in >Options>Hardware tab >
that constitutes a permanent setting.
or
- press 'S' button line (just above dialer's keypad) > that constitutes a
temporary setting.
NOTE:
For the description of the error messages click
Skype Error Messages
*
How
to
recover from errors?
Resetting DEP options to default values may help.
To do that start DEP with "default" as a trailing
parameter:
[...] \dial.exe /default
back to the top
* Using the test file to diagnose hardware or software
problems
1. Click
here
to download the
test file (371 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 TapiLog.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><dial_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
>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 dial.ini file located in:
Windows XP:
C:\Documents and Settings\<user name>\Application Data\Dial Engine Pro\dial.ini
Windows Vista and Windows 7:
C:\Users\<user name>\AppData\Roaming\Dial Engine Pro\dial.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 dial.ini
on dialer's termination.
back to the top
* How to override options?
Normally options should be set by the user using
DEP's Options window.
There are several ways to access Options window:
- double click on DEP systray icon
- mouse right click on DEP systray icon and from pull-up menu select
Options
- start DEP with /setup suffix: [path]dial.exe /setup
The options preferences are stored in:
Windows XP:
C:\Documents and Settings\<user name>\Application Data\Dial Engine Pro\dial.ini
Windows Vista and Windows 7:
C:\Users\<user name>\AppData\Roaming\Dial Engine Pro\dial.ini
To set all options to default values run application with /default
suffix: <path>dial.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
Dial Engine
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_dep.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
|