语音插播
该API用于向正在通话的一方插播语音。执行插播命令后,被插播方听语音,其通话方静音,语音播放完毕后自动恢复原有通话。
如果需要双向插播,可同时执行两次命令。
限制条件
版本:Rev 2.1.5.117及以上
适合场景
分机呼分机、来电转分机、分机外呼三种场景。
请求示例
向分机插播语音:
<?xml version="1.0" encoding="udf-8" ?>
<Transfer attribute="Connect">
<ext id="200" />
<voicefile>welcome</voicefile>
</Transfer>
向来电方插播语音:
<?xml version="1.0" encoding="udf-8" ?>
<Transfer attribute="Connect">
<visitor id="15" />
<voicefile>welcome</voicefile>
</Transfer>
向去电方插播语音:
<?xml version="1.0" encoding="udf-8" ?>
<Transfer attribute="Connect">
<outer id="22" />
<voicefile>welcome</voicefile>
</Transfer>
注意:
- 来电转分机,执行双向插播时,须先对分机插播再对来电插播,否则容易出现单通问题;
- 模拟分机通过IP外线外呼时,无法实现双向插播,只能单向插播;
- 插播语音时,若听到的语音内容不全(例如前面的几个字未播放),可以在命令中加一个silence文件名,即<voicefile>silence+welcome</voicefile>。
参数说明
参数名称 | 类型 | 说明 |
---|---|---|
<ext id> | string | 分机号码 |
<visitor id> | int | 来电的编号,范围:1~4096,从通话开始到结束的时间内是唯一的,但会被循环利用,可作为临时唯一标识。可根据INVITE或INCOMING等事件获取。 |
<outer id> | int | 去电的编号,范围:1~4096,从通话开始到结束的时间内是唯一的,但会被循环利用,可作为临时唯一标识。可根据呼叫过程中的事件获取。 |
<voicefile> | string | 语音文件,若需插播远程语音文件,应先将语音下载到本地再播放,点击这里查看实现方法。 |
响应示例
HTTP/1.0 200 OK
Date: Tue, 27 Jun 2017 02:51:12 GMT
Server:
X-Frame-Options:DENY
Cache-Control:no-cache
Pragma:no-cache
Expires:-1
Access-Control-Allow-Headers: accept, Content-Type
Access-Control-Allow-Origin: (null)
Connection: close
Content-Length: 0
<!--包体为空-->