发起广播

通过该接口呼叫广播组号码，可以向广播组成员播放实时通知，也可以向广播组成员播放音乐。

实时广播 & 音乐广播

  • 实时广播

    通过分机向广播组成员播放实时通知。

  • 音乐广播

    系统直接向广播组成员播放音乐文件。

    注： 只有广播组类型为 paging 或 intercom 时，才能使用音乐广播。

Endpoint

POST /api/v1.1.0/extension/dial_number?token={token}

请求参数

名称 是否必需 类型 描述
实时广播
caller 是 String 使用哪个分机播放通知。
callee 是 String 广播组号码。
volume 否 String 音量调节。

取值范围：0 ~ 20
音乐广播
callee 是 String 广播组号码。
volume 否 String 音量调节。

取值范围：0 ~ 20
prompt 是 String 语音文件名称。
注：
  • 文件名无需加文件后缀。
  • 文件名必须包含字母，且不能带 +。
  • 必须将语音文件上传到 PBX 的 自定义提示音 页面。

多个语音文件之间用+ 连接。例如："prompt:music1+music2"
count 否 String 播放次数。

响应参数

名称 类型 描述
callid String 该通通话的 id。

实际示例

请求示例

使用分机1001播放通知：

POST /api/v1.1.0/extension/dial_number?token=277ac400357b509b4a587ff2157f7ad5 HTTP/1.1
Content-Type:application/json; charset=utf-8
Host: 192.168.5.150
{
    "caller": "1001",
    "callee": "6300"
}

向广播组成员播放语音文件：

POST /api/v1.1.0/extension/dial_number?token=277ac400357b509b4a587ff2157f7ad5 HTTP/1.1
Content-Type:application/json; charset=utf-8
Host: 192.168.5.150
{
    "callee": "6300",
    "volume": "",
    "prompt": "music1",
    "count": "3"
}

响应示例

HTTP/1.1 200 OK
Access-control-allow-origin: *
Access-control-allow-methods: GET, POST, OPTIONS, PUT, DELETE
{
    "status": "Success",
    "callid": "1550626703.189"
}