国信呼叫中心来电弹屏接口

HTTP来电弹屏推送接口

使用场景

用于对接客户现有CRM和OA系统，使得CRM和OA具有来电弹屏功能。

实现流程

来电弹屏推送流程如图所示。

来电通知开启方法

接口描述

其中一条发给对接系统的来电通知URL请求如下：

http://x.x.x.x/srvlt?id=c635814c-4c50-4340-adcf-bc3824e1ea70%40192.168.1.82&caller=1591982xxxx&callee=802&state=ringing&direction=incoming&businessId=14310454421088926826-0%40192.168.1.102&group=3003

参数说明

字段名字段含义描述
id全局唯一标记同一个电话呼叫过程中的通知消息拥有相同的id
caller主叫号码
callee被叫号码
state当前呼叫状态calling // 主叫到达服务器，处理中..
ringing // 振铃中..自动接听则没有此消息
canceled // 振铃中挂机，取消呼叫
talking // 已经接通
hungup // 挂机
direction保留字段
businessId主从会话标识用于关联转话等业务。maincall: 表示原始主叫侧的呼叫通知，如果开发来电弹屏请忽略该消息。
businessId是其他字符串，表明是话机转话呼叫目的方分机号的通知。弹屏处理该消息即可
group分机归属分组号码可根据自定义的分组职能弹出相关信息。例如：售前组弹屏客户商机，售后组弹出客户工单信息，投诉组弹出客户投诉信息。
vxmlid语音菜单编号如果是通过语音菜单呼入的话，会携带这个参数
logid呼叫日志用于主叫外呼时，使用id无法查询到呼叫记录，则使用该参数进行查询，下载录音等。
x.x.x.x/srvlt对接服务器IP通讯地址

WebSocket来电信息/排队信息/忙闲推送接口

使用场景

该接口进一步简化BS系统的来电弹屏功能的开发，系统提供完整的js例子可参考开发。支持几乎所有主流网页浏览器。

实现流程

接口描述

呼叫中心推送的全部是JSON格式的消息，可参考系统给的例子开发。

  • id: 一个通话中,振铃,接听,挂机,取消等消息,值都一样.可跟进该参数,结合录音下载接口,下载或者在线播放录音.
  • caller: 主叫号码
  • callee: 被叫号码
  • direction: incoming来电, outgoing去电
  • group: 通过哪个分组分配来的电话.
  • ivrTrace: 通过哪个语音菜单节点转接来的电话
  • state: ring振铃,talking通话,hungup挂机,canceled取消,calling尝试呼叫
  • origcallee: 原始被叫信息,可用来区分客户通过哪条热线打入系统
  • businessId: 保留字段,无意义.

示例程序

请关注下面附件中：main.js的写法

运行例子

  1. 进入例子的方法
  2. 示例程序界面

HTTP 弹屏通话备注接口

使用场景

当来电弹屏后，客服人员需要使用对当前通话进行备注。可使用下面接口录入文字，录入的信息会与弹屏的通话记录关联。

实现流程

略

接口描述

通话备注接口URL：

http://x.x.x.x:12121/bridge/jsoncfg?opt=CALL_NOTE_ADD&json=%7B%22callid%22%3A%2202dbd716-9e48-4544-98b2-557513fabe69%40192.168.1.82%22%2C%22servicetype%22%3A%22%E5%94%AE%E5%90%8E%E5%92%A8%E8%AF%A2%22%2C%22manustate%22%3A%22%E7%AD%89%E5%BE%85%E8%B7%9F%E8%B8%AA%22%2C%22cname%22%3A%22%E5%BC%A0%E4%B8%89%22%2C%22question%22%3A%22%E8%AE%BE%E5%A4%87%E7%BB%B4%E4%BF%AE%E9%97%AE%E9%A2%98%22%2C%22record%22%3A%22%E5%92%8C%E5%AE%A2%E6%88%B7%E6%B2%9F%E9%80%9A%E4%BA%86%E8%AE%BE%E5%A4%87%E8%B4%AD%E4%B9%B0%E6%97%B6%E9%97%B4%EF%BC%8C%E9%9C%80%E8%A6%81%E8%BF%94%E5%8E%82%E7%BB%B4%E4%BF%AE%22%7D

参数说明

字段名字段含义描述
json话务员备注的信息Json格式，URLEncode 编码后作为参数传递
格式：
{"callid":"02dbd716-9e48-4544-98b2-557513fabe69@192.168.1.82","servicetype":"售后咨询","manustate":"等待跟踪","cname":"张三","question":"设备维修问题","record":"和客户沟通了设备购买时间，需要返厂维修"}
callid弹屏时传递的参数，呼叫记录唯一标识
servicetype服务类型，例如：售前，售后 (CTI不用)
manustate跟踪状态，例如：记录,跟踪,解决,关闭
cname客户名称
question当前问题，问题描述
record通话备注, 通话备注
opt操作模式CALL_NOTE_ADD：默认不可修改
x.x.x.x呼叫中心地址

通话备注查询接口

通话备注查询接口：

http://x.x.x.x:12121/bridge/jsoncfg?opt=CALL_NOTE_GET&json=02dbd716-9e48-4544-98b2-557513fabe69%40192.168.1.82

返回：json格式数据，参考上表定义

查询不到返回 {}

HTTP分机来电弹屏接收消息的URL地址设置

使用场景

该接口用于您系统B/S的客户端，设置某个分组或分机的来电推送的URL地址。有了该接口，局域网内您系统的客户端启动后，可以自动调用该接口设置自己的弹屏消息接收URL。呼叫中心服务器就会根据设置的URL向各个分机关联的客户端推送弹屏消息了。

实现流程

略

接口描述

设置某个分机或分组的弹屏消息接收地址：

参数说明

字段名字段含义描述
extnum分机/分组号
urltype请求类型http 或 https
domain接收地址或域名
port接收端口默认：80端口
path处理路径例如：
那么path=srvlt/abc
extend扩展参数弹屏的时候会带上这个参数 extend=abc
opt操作模式SET_CALLS_POP_UP_URL：默认不可修改
x.x.x.x服务器IP通讯地址

例如802分机的弹屏消息接收地址：

http://127.0.0.1:12121/bridge/callctrl?opt=SET_CALLS_POP_UP_URL&extnum=802&urltype=http&domain=192.168.1.82&port=12120&path=srvlt/abc&extend=abc

删除802的弹屏消息接收地址：

http://127.0.0.1:12121/bridge/callctrl?opt=SET_CALLS_POP_UP_URL&extnum=802