How to use the Command Line Interface
You can invoke BroadcastBySMS from a command window as follows:
scast.exe [-startnow] [-text <message>] [-startfromrow <row number>] [-statusurl
- : starts a broadcast immediately
- : specify the text to be sent
- : broadcast start from row, used with -startnow
- : Launch a program or script after a call is finished.
- : post to this url when a call is finished
- : import a list of phone numbers
- : import a CSV file
- : export to a CSV file
- : automatically reschedule next day broadcast if broadcast was not finished, used with -startnow
- : Confirmation and status columns are cleaned before broadcast.
- : Keep the program up after broadcast.
If you specify export option is usually executed by itself.or the <call list file> can be an existing file or a new file. If the file does not exist it will be created, new numbers added or imported, and then saved. Some options are to be used in separate command. For example, the
This option is mostly used for program integration. If statusurl is defined, the program will post to the defined url whenever a call is finished. The parameters include all the values of the row. Each parameter uses the column header as the parameter name and the cell value as the parameter value. The row index is also included as parameters:
For example, if the following call is finished:
These parameters will be posted to the specified URL:
Like -statusurl, this option is mostly used for program integration. If -statusexe is defined, the program will call the defined program whenever a call is finished. The parameters for the program include all the values of the row. Each parameter uses the column header as the parameter name, and the cell value as the parameter value. The format is . The row index is also included in the parameters. For the above example, the program or script will be launched as follows:
Examples of Command Line Usage
Invoke BroadcastBySMS with call list "C:\mygroup\list.soc" and start broadcasting using a wave file such as:
First import the two phone numbers to the call list. If the SOC file exists, the two new numbers are appended. If the SOC file does not exist, a new file will be created and the two new numbers added. Once the numbers are imported it will save the SOC file automatically. It then starts the broadcast with the specified wave file.
Broadcast Using a Customized Message
The command line interface does not provide an option for specifying Message ID that is created by Message Designer. However, you can still use a customized message by first creating a call list file , selecting the , and saving it to a . Then use the in the command line.