10.1 来电弹屏

1.1 接口说明

云客服系统提供来电弹屏对接。当座席来电响铃时，云客服系统会请求第三方配置的url，并将部分来电数据送给第三方系统。
请阅读弹屏对接(第10章节)中的弹屏对接说明

1.2 对接步骤

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

第一步：设置 —> 对接 —> 接口对接 —> 添加

第二步：启用添加的来电弹屏数据

1.3 请求参数

非必填参数，调用接口时请传递参数名，参数值可为空
| 序号 | 名称 | 类型 | 是否必填 | 说明 |
| ———— | ———— | ———— | ———— | ———— |
| 1 | tel | String | 是 | 当前呼入或呼出的电话号码 |
| 2 | agent_name | String | 是 | 坐席名称 |
| 3 | agent_num | String | 是 | 坐席工号 |
| 4 | tenant_id | String | 是 | 租户ID |

1.4 请求样例

请求：

样例1：

假设配置的url地址为：http://127.0.0.1:1002/customer/getCustomer
设置来电弹屏后云客服在坐席来电时会请求已经配置且启用的url，并携带参数tel，如：http://127.0.0.1:1002/customer/getCustomer?tel=13111111313&agent_name=张三&agent_num=8226&tenant_id=acf528a2-d0e2-4a7b-8513-74cb399xxxxx

样例2：

弹屏对接参数增加来电客户的按键信息
假设配置的url地址为：https://ceshi.uincall.com:4443/uincall/inComingPopPage
请求方式：post
请求参数：

{
        "agent_name": "8014",
        "agent_num": "8014",
        "bussiness_num": "400xxxx123",
        "dtmf": [{
                "ivrnodeid": "bd4f9550-xxxx-4424-95bb-df9f27774128",
                "press": "1",
                "nodetype": "uinOndtmf"
        }],
        "session_id": "adcaa1e6-xxxx-11ed-ab90-5159eXXX92b86",
        "tel": "156xxxx8360",
        "tenant_id": "acf528a2-xxxx-4a7b-8513-74cXXX95cfab"
}

来电效果：