来电转外部电话
该API用于让来电向外部电话发起呼叫,从而实现两个外部电话能够以OM为中转站建立通话。
执行权限
- 执行外呼之前,需开启外线的外转外权限。【点击查看外转外权限开启方法】
提示音说明
- 转外线在默认情况下没有转接提示音;
- 如果用户需要转外线也和转分机一样有转接提示音,则可在该API中指定语音文件(只对本次呼叫有效)。
请求示例
<?xml version="1.0" encoding="utf-8" ?>
<Transfer attribute="Connect">
<visitor id="3" />
<outer to="13012345678"/>
</Transfer>
透传主叫号码:
<?xml version="1.0" encoding="utf-8" ?>
<Transfer attribute="Connect">
<visitor id="3" />
<outer to="13012345678" display="18201008888" />
</Transfer>
注:指定中继外呼和加前缀外呼命令,可参考分机呼外部电话;临时播放语音文件命令,可参考来电转分机。
参数说明
参数名称 | 类型 | 说明 |
---|---|---|
<visitor id> | int | 来电的编号,范围:1~4096,从通话开始到结束的时间内是唯一的,但会被循环利用,可作为临时唯一标识。可根据INVITE或INCOMING事件获取。 |
<outer to> | string | 要呼叫的外部电话号码 |
[display] | string | 来电号码,用来透传主叫号码,使去电方的来电显示号码为实际来电号码。 |
注:
- 采用display字段透传主叫号码时,须通过web URL配置参数API_DISPLAY(id624)的值为yes;
- 当有来电打入中继时,可根据INCOMING事件获取来电号码,再将获取到的号码实时添加到display字段中。
响应示例
<?xml version="1.0" encoding="utf-8" ?>
<Event attribute="TRANSIENT">
<visitor id="46" from="13012345678" to="02161204000" callid="41006"/>
<outer to="02167103750"/>
</Event>
参数说明
略,可参考查询来电的API响应消息中的参数说明。
(友情提示:超链接返回的快捷键为Alt + ←)