CRM接口对接后,客服可查看到的用户信息展示区域是右侧的“更多详情”,例如下图:

七鱼侧提供与企业内部CRM系统接口对接能力,但前提是需要前端在访客发起会话的时候将访客唯一ID(客户CRM系统内用户唯一标识)上报给七鱼。之后,七鱼客服前端才能在适当时机(例如客服查看访客详细信息等时机)通过企业配置在七鱼侧的API接口,使用访客唯一ID去请求该ID对应的更详细用户信息并展示在客服前端页面。详细开发指南:点击查看
七鱼后台填写接口的区域如下图。其中AppId和AppSecret是必填项,token接口也是后续其他业务查询接口调用的前提必须要提供(如果token接口调用超时或者异常无响应,七鱼默认使用AppSecret作为token,直到企业修复获取token接口)。即,七鱼侧要求企业提供的以下业务接口在调用是必须要有安全校验,校验方式是token验证。

接口地址完全由开发者自己定义,七鱼对于url和路径命名无任何要求。客服侧信息展示区域为会话详情右侧“更多信息”tab。
由于CRM接口是客服前端直接调用的,所以接口返回的数据不会经过七鱼服务端,就不存在七鱼存储的情况。因此,若企业有严格的用户信息管控机制,那就可以使用CRM接口方式(访客前端只传一个访客唯一ID和姓名,其他信息靠CRM接口实时返回)。
开发者调试方法:CRM接口请求有客服前端直接发起,不经过七鱼服务端。开发者可以使用chrome登录七鱼后使用chrome自带开发者调试工具查看详细请求信息以及报错等自行调试接口。操作步骤:
1、使用chrome登录七鱼后台并找到在线系统的“会话记录”模块。
2、调出浏览器开发者工具(快捷键F12),选择”Network”模块,并在搜索框内填写需要查看的CRM接口关键字以便过滤请求。
3、在会话记录列表中找到一个有用户身份识别的会话(即这个会话确认在访客发起咨询的时候前端有传唯一ID。若前端没有传ID的会话,七鱼不会请求CRM接口)。然后点击查看会话详情。再点击详情页右侧“更多信息”tab。
4、查看开发者工具中请求信息。(到此处,开发者可以自行调试了)一般遇到较多的是CRM接口跨域问题、OPTION请求没处理好、http接口调用被浏览器拦截需要换成https等。

注意点:
1、CRM接口为前端直接请求方式,必须要考虑前端发起的请求有两个:第一次的请求类型是OPTION,第二次的请求类型是POST。
2、接口必须支持跨域且两个请求方式都需要支持。跨域访问相关配置说明:点击查看
3、同为CRM接口,但是区分在线模块和呼叫模块。在线模块中七鱼请求是携带的“userid”参数值是前端发起会话是上报给七鱼的访客唯一ID。呼叫模块中七鱼请求是携带的“userid”参数值为当前通话的访客号码(由七鱼自动获取,开发者无法介入)。
补充说明:在线和呼叫用户信息打通(七鱼侧在线和呼叫咨询记录打通)。该需求的实现其实依赖于CRM接口。上一步说到在线和呼叫的CRM接口请求是对于相同参数“userid”的赋值是不一样的。打通的需求其实就是要将这两个参数值关联起来。实现方式是在呼叫的CRM接口返回信息中增加“uid”字段,该字段的值是当前七鱼请求使用的号码值对应访客的在线唯一ID。
举例:
在线CMR接口请求:
{
"appid": "qiyukf",
"token": "qiyukf_security_token",
"userid": "zhangsan"
}
返回:
{
"rlt": 0,
"uid": "zhangsan",
"data": [
{"index": 0, "key": "account", "label": "账号", "value": "zhangsan", "href": "url"},
{"index": 1, "key": "name", "label": "姓名", "value": "土豪", "edit": true, "map": "real_name", "href": "url"},
{"index": 2, "key": "phone", "label": "手机", "value": "13800000000", "edit": true, "map": "mobile_phone", "href": "url"},
{"index": 3, "key": "email", "label": "EMail", "value": "13800000000@163.com", "edit": true, "map": "email", "href": "url"},
{"index": 4, "key": "vip", "label": "会员", "value": [{"id": 0,"name": "类型一"},{"id": 1,"name": "类型三", "check": true},{"id": 2,"name": "类型二"}], "select": true}
],
"modify_cb": "url" //客服在前端修改访客CRM信息后,七鱼通过此处返回的url进行数据回传,将更改数据给到企业
}
呼叫CRM接口请求:
{
"appid": "qiyukf",
"token": "qiyukf_security_token",
"userid": "zhangsan",
"staffphone": "057189850000"
}
返回:
{
"rlt": 0,
"uid": "zhangsan",
"data": [
{"index": 0, "key": "account", "label": "账号", "value": "zhangsan", "href": "url"},
{"index": 1, "key": "name", "label": "姓名", "value": "土豪", "edit": true, "map": "real_name", "href": "url"},
{"index": 2, "key": "phone", "label": "手机", "value": "13800000000", "edit": true, "map": "mobile_phone", "href": "url"},
{"index": 3, "key": "email", "label": "EMail", "value": "13800000000@163.com", "edit": true, "map": "email", "href": "url"},
{"index": 4, "key": "vip", "label": "会员", "value": [{"id": 0,"name": "类型一"},{"id": 1,"name": "类型三", "check": true},{"id": 2,"name": "类型二"}], "select": true}
],
"modify_cb": "url"
}