弹屏对接
弹屏分为两种：
一：来电弹屏
二：外呼弹屏
三：token验证
一.来电弹屏
1.对接简介
七陌系统提供来电弹屏对接。当座席来电响铃时,七陌系统弹出在系统中自定义配置的界面（http get方式调用配置的系统或界面url，如http://www.baidu.com） 。并将七陌系统中部分来电数据送给这个url。
2.对接步骤：
(1)：添加弹屏页面
操作步骤：管理员坐席登陆云客服,点击左下角进入设置页面
第一步：
设置 —> 对接 —> 来电对接 —> 添加
第二步：
设置 —> 渠道设置 —> 渠道技能组 —> 电话客服技能组，选定需要来电弹屏的电话客服技能组点击【修改】按钮，在来电弹屏栏设置对应的弹屏。
3.弹屏方式：
弹屏分为两种方式：
弹出方式：弹出一个独立页面,可以选择是重新打开新页面或者Tab页面。
嵌入方式：将弹屏页面嵌入通话模块的右侧空白处。
注意：弹出方式首次设置有可能被浏览器拦截,如无新页面弹出请检查浏览器右上角是否有红色"X"。
4.对接举例：
比如我们要将百度作为弹屏,当来电时七陌系统将访问如下url：
https://www.baidu.com/?originCallNo=19382036975&originCalledNo=01025270697&queue=10078309&offeringTime=2023-12-28%2010:01&callerProvince=%E5%9B%9B%E5%B7%9D%E7%9C%81&callerCity=%E6%88%90%E9%83%BD%E5%B8%82&callSheetId=097d106e-f795-4206-827a-2c0123193bd1&Agent=8975&RingTime=1703728903.091811&
CallStatus=leak&RealState=Ringing&queueName=testbaixin&ivrkey=&shortTime=10:01&loginName=8975&accountId=N00000022688
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接口。详细接口使用可参考文档token校验