语音插播

该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,从通话开始到结束的时间内是唯一的,但会被循环利用,可作为临时唯一标识。可根据INVITEINCOMING等事件获取。
<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

<!--包体为空-->

results matching ""

    No results matching ""