呼叫中心
智能化
营销协同
国信呼叫中心点击呼叫接口
点击呼叫接口
使用场景
点击呼叫接口能够快速实现自研系统与呼叫中心简单快速对接。用于实现鼠标点击客户的姓名或电话号码就可以呼叫。
实现流程
呼叫流程如图1-1所示，先呼叫坐席后呼叫客户电话。
接口描述
点击呼叫接口URL：
http://x.x.x.x:12121/bridge/callctrl?caller=801&callee=135xxxxxxxx&authtype=no&opt=CLICK_TO_DIAL
参数说明
| 字段名 | 字段含义 | 描述 |
|---|---|---|
| caller | 主叫分机号码 | |
| callee | 被叫电话号码 | |
| authtype | 加密模式 | 不加密填写no md5加密填写: md5 算法: md5(caller+callee+pwd) pwd: 为预配置的和CTi一致 |
| pwd | Md5生成的密码 | 参考上面authtype描述 |
| backid | 可选：返回点击呼叫ID | 成功返回一个点击呼叫操作唯一编号，用于查询呼叫记录使用。 参考：HTTP呼叫日志查询接口 |
| clicktoken | 可选:字符串（最多64个字符） | 用于对接系统写入一下业务标记到后台数据库中,对应呼叫中心数据库 calllog.clicktoken 字段 |
| channel | 可选：外呼通道 | 用于选择一个电话线路，手机卡等进行外呼。 请填写通道的号码，暂时不支持填写分组号码。 |
| opt | 标记操作模式 | CLICK_TO_DIAL: 用固定电话线外呼 CLICK_TO_IP_DIAL: 网络电话外呼 |
| x.x.x.x:12121 | 服务器IP通讯地址 | 12121默认端口，如果手动修改过端口号请使用修改后的端口 |
请求响应码解释
- 200: 转话成功
- 400: 参数错误，或opt参数缺失
- 402: 授权限制
- 486: 目标分机忙或网关线路忙
- 403: 黑名单号码，禁止拨打
- 500: 系统错误
- 502: 指定的网关账号类型错误，不是出群网关，网关账号离线
- 503: 呼叫频率过快,超过了最大限制
- 606: opt参数填写错误
Http请求含backid=true参数后响应
字符串响应类似：d0bd6022-6cbb-409d-9443-6f2d1ee830b7
::: tip 返回值对应calllog表中的clickcallid字段 :::
可用于呼叫记录查询，例如：
http://x.x.x.x:12121/bridge/callctrl?callid=d0bd6022-6cbb-409d-9443-6f2d1ee830b7&opt=CALL_LOG_GET_WITH_CALLID
点击挂机接口
使用场景
点击挂机接口用于配合点击呼叫接口时候，用于使用鼠标点击挂断当前呼叫。
实现流程
该流程较为简单，对方方系统向服务器发送一个http挂机命令，系统会挂断对应的呼叫，无论呼叫是在振铃过程中，还是已经接听。
接口描述
外呼接口完成URL：
http://x.x.x.x:12121/bridge/callctrl?caller=801&callee=135xxxxxxxx&opt=CLICK_TO_HUNGUP
参数说明
| 字段名 | 字段含义 | 描述 |
|---|---|---|
| caller | 主叫分机号码 | |
| callee | 被叫电话号码 | |
| opt | 标记操作模式 | CLICK_TO_HUNGUP: 用固定电话线外呼 |
| x.x.x.x:12121 | 服务器IP通讯地址 | 12121默认端口，如果手动修改过端口号请使用修改后的端口 |
双呼回拨接口
使用场景
HTTP双呼回拨接口,用于建立两个外部号码的通话。
实现流程
该流程较为简单，向服务器发送一个http请求，系统会先呼叫主叫号码,主叫号码接听后再呼叫被叫号码。
接口描述
外呼接口完成URL：
http://127.0.0.1:12121/bridge/callctrl?caller=159XXXXXXXX&callee=158XXXXXXXX&opt=CLICK_OUT_OUT
参数说明
| 字段名 | 字段含义 | 描述 |
|---|---|---|
| caller | 主叫分机号码 | |
| callee | 被叫电话号码 | |
| opt | 标记操作模式 | CLICK_OUT_OUT: 双呼回拨 |
| x.x.x.x:12121 | 服务器IP通讯地址 | 12121默认端口，如果手动修改过端口号请使用修改后的端口 |
外呼放音转分机
使用场景
用于向指定的客户电话号码发起呼叫，播放指定的语音和数字验证码。能够识别出空号，关机，过期，忙等号码（支持，E1数字线路，网络电话，手机卡的外呼通道能甄别，普通电话线需开启反极性）。语音播放完毕后既可以转坐席分机通话，也可以直接挂机。
实现流程
接口描述
外呼接口完整URL：
http://x.x.x.x:12121/bridge/callctrl?id=1&precallcount=1&playtimes=1&extnum=801&callee=1322784XXXX&toneid=19&code=112233&pwd=13deae128093437a57dd2caeb0328d40&opt=CLICK_TO_IP_CAPTCHA
参数说明
| 字段名 | 字段含义 | 描述 |
|---|---|---|
| id | 全局唯一字符串 | 调用方需要初始化一个值，作为播放结果查询接口的查询条件，以便获取播放结果 |
| precallcount | 预呼叫个数 | 当所有坐席都忙碌时，可以继续预呼叫指定数量的电话号码。如果将数量设置为0，则不会进行预呼叫。 |
| playtimes | 语音播放次数 | 指定的语音循环播放次数 |
| extnum | 放音完毕转分机或分组号码 | 可选，如果不填写则放音完毕挂机。 |
| callee | 被叫号码 | |
| toneid | 播放的语音编号 | 可先通过呼叫中心后台"语音文件管理"上传语音文件，然后获取对应的"编号" 支持的语音文件格式为，音质:u-Law, 8000Hz, 64kbps, mono。随发的光盘中有语音格式转换工具 |
| voicefile | 播放的服务器语音文件绝对路径 | 文件格式要求，wav 音质:u-Law, 8000Hz, 64kbps, mono Mp3 也支持 |
| code | 注册验证码，需纯数字 | 可选参数，可不填写不影响正常放音。 |
| pwd | 验证密码 | 用pwd+callee+code+当前日期(格式如：2015-03-16)，然后进行MD5 如果不用密码请填写no |
| opt | 操作模式 | CLICK_TO_IP_CAPTCHA：用网络电话外呼放音 CLICK_TO_FIXEDLINE_CAPTCHA:用固定电话外呼放音，固定电话放音时如果线路没有反极性，系统会自动添加一个循环播放的较短的引导语音(可配置)，例如：这一条语音通知，请按任意键接听，对方按键后才会播放正式语音。如果开通了反极性侧不存在上述引导语音。 |
| x.x.x.x:12121 | 服务器IP通讯地址 | 12121默认端口，如果手动修改过端口号请使用修改后的端口 |
Http请求响应码解释
- 200: 成功
- 401: 密码错误
- 421: 需付费开通
- 503: 系统错误
- 420: 参数错误
- 486: 后台忙，稍后再试
呼叫结果查询
呼叫结果查询URL：请在调用呼叫接口后，每隔5秒查询一次，获取对应的结果
http://x.x.x.x/bridge/callctrl?id=xxx&opt=GET_CAPTCHA_RESULT
查询结果说明：
- 0: 正在排队等待呼叫
- 1: 呼叫成功
- 2: 呼叫失败
- 3: 空号
- 4: 正在呼叫中
- 5: 对方忙
- 6: 关机，不在服务区
- 7: 振铃中...
- 8: 放音中...
- 404: id不存在
::: tip 如果需要指定外呼的使用的网络电话账号，则可以进入呼叫中心配置管理后台。把账号填写到"网络电话设置"的"批量外呼通道"中，多账号可用逗号隔开。 :::