Play Prompt to External Number

Through this interface, developers could play music to an external number.

The work flow is as follows:
  1. The PBX system dials an external number.
  2. The external phone rings and the call gets picked up.
  3. The music will be played automatically.
Note: This API interface does not take effect on PSTN line.

Endpoint

POST /api/v1.1.0/outbound/playprompt?token={token}

Request Parameters

Name Importance Type Description
outto Required String The external number.
prompt Required String Audio file name.
Note:
  • The file name must contain at least a letter, and cannot contain character +.
  • The audio file must be uploaded to the PBX's Custom Prompt page beforehand.

For multiple audio files, separate the file names with + .

Example: "prompt:music1+music2"
fromext Optional Int Which extension's call permission will be applied.

Response Parameters

Name Type Description
callid String An unique identifier for the call.

Examples

Request Example
POST /api/v1.1.0/outbound/playprompt?token=1e3b3ebb6a974cb42ed31de5413df52d HTTP/1.1
Content-Type:application/json; charset=utf-8
Host: 192.168.5.150
{
    "outto": "41000",
    "prompt": "hello111",
    "fromext": "1000"
}
Response Example
HTTP/1.1 200 OK
Access-control-allow-origin: *
Access-control-allow-methods: GET, POST, OPTIONS, PUT, DELETE
{
    "status": "Success",
    "callid": "1495697869.171"
}