Outbound Call Request Reference | Gateway Tutorial
Voicent Gateway contains an outbound Call Scheduler. The Call Scheduler has an HTTP interface.
Please note that although this interface is relatively stable, it is subject to change in future releases. If this is going to be a problem for you, please use the gateway SDK instead. The gateway SDK API hides most of the details of the Call Scheduler interface, thus it is easier to use and more stable.
Call Request Handler
To make an outbound call, simply send an HTTP call request to the call scheduler of Voicent Gateway.
The call scheduler listens on port 8155. Send your request to the following URL:
http://MACHINE_NAME:8155/ocall/callreqHandler.jsp
Where MACHINE_NAME is the host machine name of the Voicent Gateway.
Parameters in the Call Request
The following are legal call request parameters. Traditionally, these names are used for AutoReminder, but they have generic meanings now.
Action | Name | Details |
---|---|---|
Required | info | Information about the call. |
Optional | attendee | Name of the person to call. |
Required | phoneno | Phone number. |
Required | firstocc | No retry after this time, set as minutes from the current time. Originally represent appointment start time. |
Required | startvxml | The starting VXML file of the outbound call. Specified as the full file path name on the gateway machine. Optional if starturl is set. |
Optional | exitvxml | Call this VXML file when the call finishes. |
Required | starturl | The starting VXML file of the outbound call. Specified as a URL. Optional if startvxml is set. |
Optional | exiturl | The exiting VXML file. |
Optional | schedule | Schedule call for a later time |
Required | calltime | Scheduled call time. Must set if schedule is set. Specified as minutes from the current time. |
Optional | selfdelete | Set selfdelte=1 to automatically remove call record after the call is made. |
Optional | sms | Set sms=1 if you want to schedule sending a SMS/text message. You must have release 8 or later. |