呼叫系统事件对接

呼叫系统调用企业接口的 eventtype、请求字段、响应字段和示例。

参数值	参数说明
1	获取访客信息
2	IVR校验
3	自定义IVR接口
4	播放内容接口
5	挂断时同步通话记录
6	同步电话服务记录字段
7	接起时同步通话记录
8	外呼时同步通话信息
9	外呼任务同步自定义字段
10	回铃音检测结果
11	IVR数据请求
12	实时asr实时转译结果
13	外呼时获取用户真实号码

参数	是否必须	参数说明
code	是	返回码,200表示成功。如eventtype=2时,200就表示校验通过;eventtype=3时,200表示动作执行成功等。
result	否	code为200时，该返回值有效。eventtype=1时返回访客信息，为JSON格式数据；eventtype=4时返回播放的文本内容，为String格式数据；eventtype= 11时返回IVR数据请求节点需要的信息，字段与ivr数据请求节点设置字段名称保持一致，为JSON格式，其他值可以为空。
message	否	请求错误时，填错误提示信息。

参数	是否必须	数据类型	参数说明
uid	否	String	访客唯一标识ID
name	否	String	访客姓名
level	否	Int	访客VIP级别，值为0到10
groupId	否	Int	分流客服组ID(呼入)
staffId	否	Int	分流客服ID(呼入)
ivrId	否	Int	分流到指定IVR(呼入)

groupId和staffId值对应七鱼系统中的客服组ID和客服ID，从七鱼管理后台「在线系统」->「设置」->「会话流程」->「访客分配」->「分配规则」->「ID查询」中查找获取。ivrId对应七鱼系统中的ivrId，从七鱼管理系统「呼叫系统」->「设置」->「路由策略」->「IVR语音导航」中查找获取。三种ID的优先级为：staffId->groupId->ivrId。

如果只设置了 staffId，七鱼会查找staffId对应的呼叫客服，如果该客服正好空闲的话，电话将优先分配给他。

如果设置了staffId和groupId，七鱼会优先查找staffId对应的呼叫客服，如果该客服正好空闲，电话将优先分配给他，否则系统判断是否有返回groupId值。如果有groupId值，系统再优先查找groupId对应的呼叫客服组进行分配。

如果只设置了groupId，七鱼会优先查找groupId对应的呼叫客服组，如果该客服组内正好有空闲客服，电话将随机分配给空闲的客服。如果该客服组内没有空闲客服，若有溢出规则，则按溢出规则走。

如果只设置了ivrId,七鱼会优先按照ivrId来进行分配,会忽略ivr会员等级分配策略。

如果没有返回staffId、groupId和ivrId三种中的任意一种，或者返回的值不存在，则七鱼将执行一般IVR分流。

返回的完整参数格式如下：

{
    "code": 200,
    "message": "",
    "result": {
        "level": 0,
        "groupId": 415451,
        "staffId": 2164623,
        ...
    }
}

当eventtype=13时，响应体数据格式如下:

{
    "code": 200,
    "message": "",
    "result": {
        "outNumber": "02323232323"
    }
}

第三方接口样例

以SpringMVC框架为例，第三方系统提供的接口如下：

@RequestMapping(value = "/crminfo", method = RequestMethod.POST)
@ResponseBody
public String getClientCrmInfoByPhone(
        @RequestParam(value = "checksum", required = true) String checksum,
        @RequestParam(value = "time", required = true) String time,
        @RequestBody(required = true) String jsonStr
) {
    // 此处省略业务代码
}

呼叫系统事件对接

呼叫事件对接

参数eventtype类型说明：

数据校验

调用说明

接口请求地址

通话记录数据项补充说明:

第三方接口需返回的数据的说明

第三方接口样例

目录