弹屏对接

弹屏分为两种:

一:来电弹屏

二:外呼弹屏

三:token验证

一.来电弹屏

1.对接简介

七陌系统提供来电弹屏对接。当座席来电响铃时,七陌系统弹出在系统中自定义配置的界面(http get方式调用配置的系统或界面url,如http://www.baidu.com) 。并将七陌系统中部分来电数据送给这个url。

2.对接步骤:

(1):添加弹屏页面

操作步骤:管理员坐席登陆云客服,点击左下角进入设置页面

第一步:

设置 —> 对接 —> 来电对接 —> 添加

第二步: 设置 —> 渠道设置 —> 渠道技能组 —> 电话客服技能组,选定需要来电弹屏的电话客服技能组点击【修改】按钮,在来电弹屏栏设置对应的弹屏。

3.弹屏方式:

弹屏分为两种方式:

弹出方式:弹出一个独立页面,可以选择是重新打开新页面或者Tab页面。

嵌入方式:将弹屏页面嵌入通话模块的右侧空白处。

注意:弹出方式首次设置有可能被浏览器拦截,如无新页面弹出请检查浏览器右上角是否有红色"X"。

4.对接举例:

比如我们要将百度作为弹屏,当来电时七陌系统将访问如下url:

https://www.baidu.com/?
originCallNo=01080455986&originCalledNo=02166608271&queue=
10033539&offeringTime=2018-06-01 11:40&callerProvince=北京
市&callerCity=北京市
&REPEAT_CALL=&callSheetId=2c2729a1-7625-4602-b3d6-
f0137bded1b0&ivrkey=4&Agent=8033&RingTime=1527824441.24788
0&CallStatus=leak&queueName=客服
&unRead=true&shortTime=11:40&&loginName=8033&accountId=N00
000012351   

5.通话数据参数说明:

参数名 描述
originCallNo 主叫号码
originCalledNo 被叫号码
queue 来电进入技能组编号
offeringTime 来电进入系统的时间
callerProvince 主叫号码省份
callerCity 主叫号码城市
callSheetId 通话记录的ID
Agent 接听座席工号
RingTime 座席响铃时间,是时间戳格式
queueName 来电进入技能组名称
ivrkey 来电,在系统流转ivr时,按过的按键,每个按键以-分割
shortTime 来电时间,格式11:40
CallStatus 接听状态
accountId 账户编号
loginName 登录名称

6.效果展示:

嵌入型的弹出效果为: 弹出型即打开一个新的浏览器窗口,弹出第三方页面。

二.外呼弹屏

1.对接简介:

七陌系统提供外呼弹屏对接。当座席外呼时,七陌系统以http get方式调用第三方B/S系统的url 。并将相关来电数据送给第三方系统。

注:如果没有配置外呼弹屏地址:默认弹出外呼号码在我们系统上保存的客户资料。

2.对接步骤:

(1)配置的外呼弹屏地址:以百度为例

(2)设置上来电弹屏地址后需要启用和坐席重新登录。

3.弹屏方式:

弹屏分为两种方式:

弹出方式:弹出一个独立页面,可以选择是重新打开新页面或者Tab页面。

注:弹出方式首次设置有可能被浏览器拦截,如无新页面弹出请检查浏览器右上角是否有红色“X”。

嵌入方式:将弹屏页面以模态框的形式展示出来

4.对接举例:

我们以百度为例,外呼时会给百度地址推送如下数据:

http://www.baidu.com?CallNo=01059567320&CalledNo=18518410600&CallSheetID=be056793-5616-4ed8-a9d6-f892d4ff5d0e&CallType=dialout
&Ring=1474513121.370926&Agent=8000&Province=北京市&District=北京市&CallID=cc-ali-0-1474513112.23562&loginName=8000

5.通话数据参数说明:

参数名 描述
CallNo 主叫号码
CalledNo 被叫号码
CallSheetID 通话记录ID,CallSheetID 是这条通话记录再DB中的唯一id
CallType 通话类型:dialout外呼通话
Ring 通话振铃时间(话务进入呼叫中心系统的时间)
Agent 发起的外呼坐席工号
Province 被叫号码省归属地
District 被叫号码市归属地
CallID 通话ID,通话连接的在系统中的唯一标识。CallID 是在通话进行中channel的id,可以用这个id来挂断通话之类的操作。一个call有一个CallID,但一个CallID可能会出现在多个通话中,比如转接。
loginName 发起外呼的坐席工号

6.效果展示:

嵌入型的弹出效果为: 弹出型即打开一个新的浏览器窗口,弹出第三方页面。

token验证:

新增对接全局配置中开启token验证功能,开启之后会在访问页面的地址后加上两个参数 token tokenid,页面拿到这两个参数之后 可以通过我们提供的一个校验接口页面对接token校验 rest接口,使用此接口需要接口鉴权

请求链接:

https://apis.7moor.com/v20160818/sso/checkTokenLegal/ACCOUNTID?sig=XXX

请求参数:

参数名 参数值
token 访问地址时携带token的值
tokenId 访问地址时携带tokenId的值

校验token值的合法性 然后再进行是否允许登陆的处理

校验接口返回值说明:

返回值样例:{code : 200 , message :"token check success!"}

code值详解:

200:合法请求 校验成功

500:服务器错误

501:未查询到对应token数据

502:很抱歉,token已经超时

503:token不匹配,非法请求