How to use Command Line Interface

• [-startnow]
• [-confirmcode <code>]
• [-wavfile <wave file name>]
• [-startfromrow <row index>]
• [-statusurl <url>]
• [-statusexe <prog>]
• [-numbers <call list>]
• [-import <import csv file>]
• [-export <export csv file>]
• [-autonextday]
• [-cleanstatus]
• [-noexit]
• <call list file>

The call list file parameter is required, and must be the last argument in the list.

  -startnow: starts a broadcast immediately
  -wavfile : specify the wave file path name
  -confirmcode: call-till-confirm code
  -startfromrow: broadcast start from row, used with -startnow
  -statusurl: post to this url when a call is finished
  -numbers: import a list of phone numbers
  -import: import a CSV file
  -export: export to a CSV file
  -autonextday: automatically reschudle next day broadcast if not finished, used with -startnow
  -cleanstatus: clean confirm/status column before broadcast
  -noexit: keep program up after broadcast

If you specify -numbers or -import, 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 saved.

Some options are to be used in separate command. For example, export option is usually executed by itself.

To use the command line options, you need to have the Enterprise Edition.

Use statusurl

This option is mostly used for program integration. If statusurl is defined, the program will post to this 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 in the parameters. For example, if the following call is finished:

The following parameters will be posted to the specified URL:

index=50&Name=John Doo&Phone=8001234567&Age=30&Confirmation=confirmed&Status=Call Made

Use statusexe

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 -Dname=value. The row index is also included in the parameters. For the above example, the following parameters will be used:

<prog> -Dindex=50 -DName="John Doo" -DPhone="8001234567" -DAge="30" -DConfirmation="confirmed" -DStatus="Call Made"

Examples:

vcast.exe -startnow -wavfile "C:\mygroup\hello.wav" "C:\mygroup\list.voc"

Invoke BroadcastByPhone with call list “C:\mygroup\list.voc” and start broadcasting using wave file “C”\mygroup\hello.wav”

vcast.exe -startnow confirmcode 1234 "C:\mygroup\list2.voc"

Invoke BroadcastByPhone with call list “C:\mygroup\list2.voc” and start broadcasting. Since –confirmcode is specified, the broadcasting will stop whenever anyone confirmed with confirmation code “1234”.

vcast.exe -startnow -wavfile "C:\mygroup\hello.wav" -numbers "1234567 2223333" "C:\mygroup\list.voc"

First import the two phone numbers to the call list. If the VOC file exists, the two new numbers are appended. If the VOC file does not exist, a new file will be created and the two new numbers added. Once the numbers are imported, it will first save the VOC file automatically. It then starts the broadcast with the specified wave file.

Broadcast Using 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 customized message by first creating a call list file (.voc), selecting the message ID, and saving it to a .voc file. Then use the .voc file in the command line.

The following is an example of using the command line interface.