1.场景描述
用户拨打 400 号码/中继服务号或者由 webcall 接口邀请进入 IVR 流程中。
- 场景一:
根据来电号码调用第三方接口获取相对应号码并呼叫该号码,双方开始通话。
- 场景二:
根据来电号码调用第三方接口判断用户等级,根据不同等级分配给对应坐席。
- 场景三:
来电用户输入分机号,根据分机号调用第三方接口获取相对应号码并呼叫该号码,双方开始通话。
- 场景四:
来电用户输入订单号,根据订单号调用第三方接口返回给用户对应的订单信息。
- 场景五:
来电用户输入用户名密码,根据输入信息调用第三方接口返回给用户登陆成功/失败的信息
2.接口说明
操作以上场景,由于对应的数据都存在于用户自己的服务器中,云客服系统需要通过接口进行数据交互,所以需要用户开发一个跟云客服系统进行数据交互的接口。
该接口的形式为get和post两种,这里以get请求为例,post相同。post方式请求体格式为application/x-www-form-urlencoded
(1):get请求-接口返回值为纯字符串。
请求url示例:http://merrige.hyxmt.cn/a/electronic/ajax/qmCallCheck.ashx?callNo=phoneNum
返回值为string字符串如:"success" 或 "1990154XXXX"
(2):get请求-接口返回值为json字符串。
请求url示例:http://merrige.hyxmt.cn/a/electronic/ajax/qmCallCheck.ashx
返回值为json: {"code":"200","level":"1","message":"success"}
例如:
用户提供的接口为 http://www.ykf.com/ykftest,在调用接口的同时云客服会将来电用户的来电号码作为一个参数传给接口,用户以 get 方式获取:
http://www.ykf.com/ykftest?callNo=151********
3.注意事项
1. url请求形式只能是 get 和 post,返回值只能为纯字符串或者json字符串,不能带有任何格式。json为单层json串,不能有嵌套,如json中不能有list数组,json中不能嵌套json等。
字符串,如:返回值为一个手机号 123456,则接口只需要返回这个手机号:123456 即可。 json,如:{"code":"404","message":"GET is not allowed"}
2. 如果是自定义字段需要对外传输,那么在接收自定义字段时,需要加上customer_的前缀,该前缀是为了避免自定义参数与系统参数重复而自动存在的,如自定义了Name参数,那么该参数在向外传递时,key将为 customer_Name