# 客户管理
# 客户导入
该接口是针对呼叫中心的用户数据设计的,所以phone参数为必须且真实有效的数据。调用该接口需要使用appkey和appsecret,该参数在“管理后台->系统->扩展与集成->开发者ID”中获取。首次进入信息对接页面时,开发者ID中只有appkey,appsecret项只有一个“重置”按钮,点击之后会第一次生产appsecret,之后再次点击就是刷新appsecret。 *开发者ID信息一般用于消息接口,只有专业版及以上才有此模块。
调用说明
- 本接口只支持POST请求;
- 本接口请求Content-Type类型为:application/json;charset=utf-8;
- 本接口返回类型为JSON,同时进行UTF-8编码。
数据校验
参考通用说明-数据校验 (opens new window)
接口参数说明 注意:foreignid与phone参数两者必须传入其中一个 使用该接口可以批量更新客户中心中的客户资料,支持批量新增、修改、删除客户资料。
服务器收到的POST请求如下:
POST https://qiyukf.com/openapi/crm/syncCrmInfo?appKey=1064deea1c3624c9ee26d1de5ce8481f&time=1463217187&checksum=2f13932c4b7c6888b12360a85261a11b8b543f64
Content-Type:application/json;charset=utf-8
请求内容示例如下:
{
"update":
[{
"name":"周明月",
"foreignId":"userId",
"phone":"13725698555",
"email":"mingyue@163.com",
"address":"河南省开封市祥符区范庄村",
"leader":-1,
"firstContactTime":1483009843582,
"lastContactTime":1483957441234,
"plateNumber":"豫BWD001"
},{
"name":"鲁城",
"foreignId":"userId",
"phone":"13725698666",
"email":"lucheng@163.com",
"address":"河南省开封市祥符区范庄村",
"leader":124548,
"firstContactTime":1483009963521,
"lastContactTime":1483957965821,
"plateNumber":"豫BWD002"
}],
"delete":
[{
"phone":"13725698001",
"foreignId":"userId1"
}, {
"phone":"13725698002",
"foreignId":"userId2"
}]
}
请求参数说明如下:
参数 | 是否必须 | 参数说明 |
---|---|---|
update | 否 | 需要更新的客户信息 |
delete | 否 | 需要删除的客户信息 |
name | 是 | 访客姓名,更新时必须传 |
foreignId | 否 | 用户的uid,如果传了,则作为客户资料的唯一标识,否则使用 phone 作为唯一标识,foreignid与phone参数两者必须传入其中一个 |
phone | 否 | 电话号码,没有传 foreignId 时作为客户资料的唯一标识,foreignid与phone参数两者必须传入其中一个 |
否 | 访客邮箱 | |
address | 否 | 地址 |
leader | 否 | 负责人客服ID,可在在线系统->设置->会话流程->访客分配->分配规则->ID查询 处查询。如果要清除负责人,设置值为-1 |
firstContactTime | 否 | 首次联系时间,必须为毫秒数 |
lastContactTime | 否 | 末次联系时间,必须为毫秒数 |
plateNumber | 否 | 作为自定义扩展字段 |
更新JSON参数中必须包含update或delete子元素其一。
如果有foreignId,则以foreignId为客户资料的唯一标识,系统中不存在foreignId对应的客户,则执行新增操作,否则执行更新操作,此时update中不允许存在两条foreignId一样的客户资料。
如果没有foreignId,则phone作为客户资料的唯一标识,如果系统中不存在phone对应的客户,则执行新增操作,否则执行更新操作。此时update中不允许存在两条phone一样的客户资料。
在「客户信息字段」中配置了的,并且启用、显示的字段可以作为扩展字段,以「字段名称」作为属性名,如plateNumber
参数。若未提前配置并启用,在导入数据后将查看不到对应的扩展字段(因为在调用接口导入过程中,服务端会直接忽略这些数据)。如果扩展字段在「客户信息字段」中配置的字段类型是时间控件,则值必须为毫秒数,如firstContactTime,如果字段类型是数字,则值必须为数字。
响应参数中各个 key 意义与分配客服的响应参数相同,另外两个不同的key值意义如下:
参数 | 参数说明 |
---|---|
code | 错误码。200表示设置成功。 |
message | 错误提示信息 |
# 客户查询
该接口是用以根据foreignId查询客户资料信息。调用该接口需要使用appkey和appsecret,该参数在“管理后台->系统->扩展与集成->开发者ID”中获取。首次进入信息对接页面时,开发者ID中只有appkey,appsecret项只有一个“重置”按钮,点击之后会第一次生产appsecret,之后再次点击就是刷新appsecret。 *开发者ID信息一般用于消息接口,只有专业版及以上才有此模块。
调用说明
- 本接口只支持POST请求;
- 本接口请求Content-Type类型为:application/json;charset=utf-8;
- 本接口返回类型为JSON,同时进行UTF-8编码。
数据校验
参考通用说明-数据校验 (opens new window)
接口参数说明
使用该接口可以根据foreignId查询客户中心的客户资料,包括phone,unionId,email等字段。
服务器收到的POST请求如下:
POST https://qiyukf.com/openapi/crm/queryCrmInfo?appKey=1064deea1c3624c9ee26d1de5ce8481f&time=1463217187&checksum=2f13932c4b7c6888b12360a85261a11b8b543f64
Content-Type:application/json;charset=utf-8
请求内容示例如下:
{
"foreignId": "WXWORK_SINGLE_CHAT_MULTIPLE_USER_aa7ae5b7143c4d19a862b956b75df834"
}
请求参数说明如下:
参数 | 是否必须 | 参数说明 |
---|---|---|
foreignId | 是 | 客户资料的foreignId |
响应信息为:
参数 | 数据类型 | 参数说明 |
---|---|---|
code | Integer | 错误码。200表示设置成功。 |
message | String | 错误提示信息。 |
result | JSONObject | 客户资料信息。 |
返回数据示例如下:
{
"address": "浙江省杭州市网易大厦",
"corp_id": 96535,
"create_time": 1646120135431,
"customField": {},
"email": "caicaicai@163.com",
"first_session_time": 0,
"foreign_id": "WXWORK_SINGLE_CHAT_MULTIPLE_USER_aa7ae5b7143c4d19a862b956b75df834",
"id": "621dccc7d60e000020cc8255",
"mid_guid": "bf59befc2bd542dab8a7792871a41038",
"name": "Circle",
"phone": "15850661815",
"remarks": "VIP客户",
"status": 1,
"tags": [
118195,
118196,
117357,
117356
],
"tagsString": "[\"_118195_\",\"_118196_\",\"_117357_\",\"_117356_\"]",
"union_id": "oXwpS5rj83t6eYrn7hb4pHB6VNlQ",
"update_time": 1646120135431,
"user_id": 0,
"wx_corp_name": "",
"wxworkExtId": "企业微信id"
}
# 客户群查询
该接口是用以根据chatId查询群资料信息。(企微官方接口获取群chatid:获取客户群列表 (opens new window) 、 获取客户群详情 (opens new window)) 调用该接口需要使用appkey和appsecret,该参数在“管理后台->系统->扩展与集成->开发者ID”中获取。首次进入信息对接页面时,开发者ID中只有appkey,appsecret项只有一个“重置”按钮,点击之后会第一次生产appsecret,之后再次点击就是刷新appsecret。 *开发者ID信息一般用于消息接口,只有专业版及以上才有此模块。
调用说明
- 本接口只支持POST请求;
- 本接口请求Content-Type类型为:application/json;charset=utf-8;
- 本接口返回类型为JSON,同时进行UTF-8编码。
数据校验
参考通用说明-数据校验 (opens new window)
接口参数说明
使用该接口可以根据chatId查询企微群资料,包括群chatId、群名称、群人数、群主、群创建时间、会话存档同意情况、群公告、标签、负责人、企微主体、自定义字段、群成员信息等字段。
服务器收到的POST请求如下:
POST https://qiyukf.com/openapi/crm/group/queryGroupInfo?appKey=1064deea1c3624c9ee26d1de5ce8481f&time=1463217187&checksum=2f13932c4b7c6888b12360a85261a11b8b543f64
Content-Type:application/json;charset=utf-8
请求内容示例如下:
{
"chatId": "wrWxx_EQAAs2IlU8oYjaSh48ve7iJi9A"
}
请求参数说明如下:
参数 | 是否必须 | 参数说明 |
---|---|---|
chatId | 是 | 群的唯一id,企微的chatId |
响应信息为:
参数 | 数据类型 | 参数说明 |
---|---|---|
code | Integer | 错误码。200表示设置成功。 |
message | String | 错误提示信息。 |
result | JSONObject | 客户资料信息。 |
返回数据示例如下:
{
"code": 200,
"message": "success",
"data": {
"chatId": "wrXrfAcwAAcs1UPdg-B1Wmpk3JSuWgmw",
"customFieldValues": [
{
"assignType": 6,
"id": 7422054,
"name": "自定义时间控件",
"required": 0,
"show": 1,
"status": 0,
"type": 3,
"value": ""
},
{
"assignType": 6,
"description": "0",
"id": 7416295,
"name": "gotest客户信息字段",
"required": 0,
"show": 1,
"status": 0,
"type": 0,
"value": ""
}
],
"customerMemberSize": 1,
"groupIcon": "",
"groupName": "我的群",
"groupNotice": "",
"leader": "超级管理员",
"leaderId": 238904,
"memberSize": 2,
"members": [
{
"escrow": 0,
"friendFlag": true,
"userGroupIcon": "",
"userGroupName": "成员1",
"userGroupRole": 0,
"userId": 292288219072
},
{
"escrow": 1,
"userGroupIcon": "",
"userGroupName": "成员2",
"userGroupRole": 1,
"userId": 292288218144
}
],
"ownerName": "群主",
"platformType": 13,
"staffMemberSize": 1,
"tags": [
{
"color": "#00AD9D",
"name": "标签1",
"tagCustomId": 7956339
}
],
"vipLevel": 1,
"wxCorpId": "wpUKa0DAAAkYq1AU6L45_APs4-VKYLaQ",
"wxCorpName": "企业名称",
"archiveInfo": {
"members": [
{
"escrow": 0,
"friendFlag": true,
"userGroupIcon": "",
"userGroupName": "成员1",
"userGroupRole": 0,
"userId": 292288219072
}
],
"wxworkAgreeFlag": 1
}
}
}
# 客户信息变更事件
当七鱼系统使用者主动修改访客名片,或者系统访客访问行为触发系统自动修改访客名片时,七鱼会通过此接口主动向七鱼的用户企业服务器推送数据
接口使用说明
首先需要填写推送消息接收接口地址,请在 管理后台->系统->扩展与集成->访客名片接口URL 处填写
编写接口
- 接口鉴权 参考通用说明-数据校验 (opens new window)
- 接口类型 POST
- 接口参数 主要用于鉴权
参数 参数说明 checksum SHA1(appSecret + md5 + time), 三个参数拼接的字符串,进行SHA1哈希计算,转化成16进制字符(String,小写) time 当前 UTC 时间戳,从 1970 年 1 月 1 日 0 点 0 分 0 秒开始到现在的秒数 4.接口数据 接口返回数据在请求体内,主要是以JSON格式返回一个访客名片对象
数据键名 数据类型 数据说明 name String 名字 phone String 电话 address Integer 地址 vipLevel String VIP等级 foreign_id String 外部id remarks String 备注 first_contact_time Long 首次联系时间 last_contact_time Long 最后联系时间 first_session_time Long 首次会话时间 last_session_time Long 上次会话时间 customField Map<Long, Object> 自定义属性值id tagsDetail Map<Long, String> TagID和名称
# 客户标签
通过访客标签信息对接,可以实现第三方系统与七鱼系统访客标签信息的同步。客服在七鱼系统修改访客标签时,七鱼会回调第三方接口地址,将标签修改信息通知第三方系统。同时第三方系统在修改访客标签的时候,可以调用七鱼的开放接口,将标签修改同步到七鱼系统。
客户标签信息对接包括三个接口。七鱼提供两个开放接口给第三方查询所有标签信息和接收标签信息修改事件,第三方提供一个标签事件回调接口。
# 获取客户标签信息
该接口由七鱼提供。通过该接口可以获取所有访客标签信息。第三方在获取到访客标签信息后,需要将标签信息存储到本地库中,以便后续标签信息同步时可以快速根据标签id找到对应标签名字。标签同步事件中传递的信息,只有标签id,没有标签名字。
接口调用及数据校验规则参考上面营销接口调用及校验
服务器收到的POST请求样例如下:
POST https://qiyukf.com/openapi/tag/all?appKey=1064deea1c3624c9ee26d1de5ce8481f&time=1463217187&checksum=2f13932c4b7c6888b12360a85261a11b8b543f64
Content-Type:application/json;charset=utf-8
请求body内容固定为all,示例如下:
all
响应信息为:
参数 | 数据类型 | 参数说明 |
---|---|---|
code | Integer | 错误码。200表示设置成功。 |
message | String | 错误提示信息 |
result | JsonArray | 认证结果 |
当code=200时,result内容为JsonArray数据,格式如下:
[
{
"id":156656,
"name":"重点客户",
"color":"#eeeeee"
},{
"id":2455485,
"name":"新客户",
"color":"#dddddd"
}
]
# 修改客户标签
该接口由七鱼提供。第三方通过该接口可以修改七鱼系统中访客的标签信息。
发送给七鱼的POST请求样例如下:
POST https://qiyukf.com/openapi/tag/update?appKey=1064deea1c3624c9ee26d1de5ce8481f&time=1463217187&checksum=2f13932c4b7c6888b12360a85261a11b8b543f64
Content-Type:application/json;charset=utf-8
请求body内容如下:
{
"foreignid": "onlyone",
"mobile": "onlyone",
"tag_ids": [156656,2455485],
"type": "save"
}
参数字段说明:
参数 | 数据类型 | 参数说明 |
---|---|---|
foreignid | String | 访客的foreignid。 |
mobile | String | 访客的手机号。 |
tag_ids | Json | 标签id数组,标签id通过/openapi/tag/all接口查询,如果传入的列表中包含不存在的 tag,会返回 14004 错误。 |
type | String | save表示为用户增加对应标签,delete表示从用户标签中删除对应标签, replace表示直接替换原用户的标签数据。 |
foreignid 和 mobile 两者必传其中之一,如果两个都传,则以 foreignid 为准。
响应信息为:
参数 | 数据类型 | 参数说明 |
---|---|---|
code | Integer | 错误码。200表示设置成功。 |
message | String | 错误提示信息。 |
result | JsonArray | 修改后的用户最终全部标签id数组。 |
当code=200时,result内容为JsonArray数据,格式如下:
[156656,2455485]
# 批量修改客户标签
该接口由七鱼提供。当有大量的用户标签需要同步到七鱼系统的访客数据时,可以调用该接口,提高更新效率。
请注意:由于该接口依旧是一个同步调用的接口,为了保证接口响应速度,一批修改的客户数据须小于 200 个。同时,该接口调用频次限制为每分钟 60 次。
发送给七鱼的POST请求样例如下:
POST https://qiyukf.com/openapi/tag/batchUpdate?appKey=1064deea1c3624c9ee26d1de5ce8481f&time=1463217187&checksum=2f13932c4b7c6888b12360a85261a11b8b543f64
Content-Type:application/json;charset=utf-8
请求body内容如下:
[
{
"foreignid": "foreignid1",
"mobile": "mobile1",
"tag_ids": [156656,2455485],
"type": "save"
},
{
"foreignid": "foreignid2",
"mobile": "mobile2",
"tag_ids": [156656,2455485],
"type": "delete"
},
{
"foreignid": "foreignid3",
"mobile": "mobile3",
"tag_ids": [156656,2455485],
"type": "replace"
}
]
参数字段说明:
参数 | 数据类型 | 参数说明 |
---|---|---|
foreignid | String | 访客的foreignid |
mobile | String | 访客的手机号。 |
tag_ids | Json | 标签id数组,标签id通过/openapi/tag/all接口查询。 |
type | String | save表示为用户增加对应标签,delete表示从用户标签中删除对应标签, replace表示直接替换原用户的标签数据。 |
foreignid 和 mobile 两者必传其中之一,如果两个都传,则以 foreignid 为准。
传入的 JSONArray 允许各种 type 混传,但如果有用户数据重复,例如同时给 mobile1 做了增加,删除和替换的操作,则仅会处理 替换 请求。增加和删除不互斥,可以同时包含。
所有的更新都是并发执行,不保证执行顺序,如果您的系统中对同一个用户标签数据有多次操作记录,务必做了合并之后,再调用该接口,不能直接将改动记录转换为列表请求。
响应信息为:
参数 | 数据类型 | 参数说明 |
---|---|---|
code | Integer | 错误码。200表示设置成功。 其他错误码详见通用错误码列表 (opens new window) |
message | String | 错误提示信息 |
result | JSONObject | 传入数据中的非法数据,详见下文。 |
当 code=200 时,result 内容为 JsonArray 数据,包含了传入数据里的非法参数,包括不存在用户的 foreignid 列表,不存在用户的 mobile 列表,和不存在的标签 id 列表。非法的数据会被忽略,其他存在的数据则会被正常更新。
返回数据示例如下:
{
"foreignIdsNotExist":["foreignid0"],
"mobilesNotExist":["mobile0"],
"tagIdsNotExist":[1,2]
}
其中,详细的数据说明为:
参数 | 数据类型 | 参数说明 |
---|---|---|
foreignIdsNotExist | JSONArray,item 为 String | 该数组中的 foreignid 在七鱼系统中没有对应的客户信息。 |
mobilesNotExist | JSONArray,item 为 String | 该数组中的 mobile 在七鱼系统中没有对应的客户信息。 |
tagIdsNotExist | JSONArray,item 为 Long | 该数组中的 tagId 在七鱼系统中不存在。 |
# 客户标签变更事件
该接口由第三方提供。第三方企业需在页面:管理后台->系统->扩展与集成->CRM信息对接->客户标签接口URL 处填写提供的接口地址。七鱼会在访客标签信息修改时回调该接口,将修改信息同步给第三方。
接口调用及数据校验规则参考上面【通用说明->数据校验】
第三方服务器收到的POST请求样例如下:
POST https://xxx.com/xxx/xxx?appKey=1064deea1c3624c9ee26d1de5ce8481f&time=1463217187&checksum=2f13932c4b7c6888b12360a85261a11b8b543f64
Content-Type:application/json;charset=utf-8
请求body内容如下:
{
"userid": 12451558,
"foreignid": "onlyone",
"tag_ids": [156656,2455485],
"type": "save"
}
参数字段说明:
参数 | 数据类型 | 参数说明 |
---|---|---|
foreignid | String | 访客的foreignid |
userid | Long | 访客在七鱼的id |
tag_ids | Json | 标签id数组,标签id通过/openapi/tag/all接口查询 |
type | String | save表示为用户增加对应标签,delete表示从用户标签中删除对应标签。 |
响应信息为:
参数 | 数据类型 | 参数说明 |
---|---|---|
code | Integer | 错误码。200表示设置成功。 |
message | String | 错误提示信息 |
# 客户导出
# 概述
- 此文档描述第三方(以下简称企业)通过七鱼提供的开放接口获取客户中心相关信息的步骤及细节。
- 由于客户中心是跟企业息息相关的数据,为保证数据的安全,七鱼要求企业在调用每个接口时提供相关信息以保证数据的安全。
- 同一企业在24小时内, 批量下载任务相同任务最大并发请求访问为一次(所有参数都一样即是同一个任务),单次下载任务为每秒少于 5 次。
- 接口访问时间必须在每天的凌晨2点至6点之间。
# 接口鉴权
- 企业需单独申请该接口权限(仅限专业版及以上客户)。
- 数据鉴权:需要使用 appkey 和 appsecret 参与鉴权,参数可在七鱼后台获取,专业版以上支持该功能(首次进入是可以看到appsecret为空,点击"重置"后会第一次生成,之后点击就是刷新)
# 接口示例
实际完整请求地址如下例(POST): https://qiyukf.com/openapi/export/usercenter?appKey=APPKEY&time=TIME&checksum=CHECKSUM (opens new window)
body内容如下(json格式):
{"start":"1504972800000","end":"1505016000000"} //客户创建时间范围
checksum计算方法如下:
package test;
import java.security.MessageDigest;
import java.security.NoSuchAlgorithmException;
import java.security.SecureRandom;
import java.util.Calendar;
import javax.crypto.Cipher;
import javax.crypto.KeyGenerator;
import javax.crypto.spec.SecretKeySpec;
public class checksum {
private static final char[] HEX_DIGITS = {'0', '1', '2', '3', '4', '5', '6', '7', '8', '9', 'a', 'b', 'c', 'd', 'e', 'f'};
public static String encode(String appSecret, String nonce, String time) {
String content = appSecret + nonce + time;
try {
MessageDigest messageDigest = MessageDigest.getInstance("sha1");
messageDigest.update(content.getBytes());
return getFormattedText(messageDigest.digest());
} catch (Exception e) {
throw new RuntimeException(e);
}
}
private static String getFormattedText(byte[] bytes) {
int len = bytes.length;
StringBuilder buf = new StringBuilder(len * 2);
for (int j = 0; j < len; j++) {
buf.append(HEX_DIGITS[(bytes[j] >> 4) & 0x0f]);
buf.append(HEX_DIGITS[bytes[j] & 0x0f]);
}
return buf.toString();
}
public static String MD5encryption(String plain) {
String re_md5 = new String();
try {
MessageDigest md = MessageDigest.getInstance("MD5");
md.update(plain.getBytes());
byte b[] = md.digest();
int i;
StringBuffer buf = new StringBuffer("");
for (int offset = 0; offset < b.length; offset++) {
i = b[offset];
if (i < 0)
i += 256;
if (i < 16)
buf.append("0");
buf.append(Integer.toHexString(i));
}
re_md5 = buf.toString();
} catch (NoSuchAlgorithmException e) {
e.printStackTrace();
}
return re_md5;
}
public static void main(String[] args) {
String content = "{\"start\":\"1504972800000\",\"end\":\"1505016000000\"}";
String encryptKey = "APPSECRET";
String nonce = MD5encryption(content);
String time = Long.toString(Calendar.getInstance().getTimeInMillis() / 1000);
String b = encode(encryptKey, nonce, time);
System.out.println("time:" + time);
System.out.println("ck:" + b);
}
}
# 接口访问步骤
分为两步:添加任务,校验任务是否完成(如果已完成则提供数据下载链接)。
# 1.添加任务
地址:https://qiyukf.com/openapi/export/usercenter 描述:该接口用于告诉七鱼,企业将开始一个导出数据的任务。 参数: start和end一同决定了要导出的数据的时间范围,其最大时间间隔不能超过2天。
- start: 时间戳毫秒单位
- end: 时间戳毫秒单位
如果一切检查通过,那么该接口会立即返回,其中"message"值是一个有关本次请求的一个专有key用于 1.2 接口请求时的参数值。
{"code":200,"message":"key"}
# 2.校验任务是否完成
地址:https://qiyukf.com/openapi/export/usercenter/check 描述,该接口用于检测任务是否已做完 参数,key,即 1.1 接口返回的 message值
{"key":"message值"}
如果一切检查合法并且任务执行完毕将返回
{"code":200,"message":"httpUrl"}
该message值即为一个请求下载数据文件的链接,企业可以利用该链接去下载到一个数据文件,该下载链接有效时间为1小时。 如果不合法则返回
{"code": 非200,"message":"相关描述"}
由于 1.1 接口在创建任务后不一定会马上完成,所以最好是在创建任务成功后等待一定时间后再去使用key调用 1.2 接口。而且根据任务量的不同,任务执行时间长短不定;若 1.2 接口返回
{"code":14403,"message":"Wait..."}
需要等待一定时间后再次去请求(等待时间由开发者自己设定),直到成功为止。
# 获取用户服务记录
# 概述
- 此文档描述第三方(以下简称企业)通过七鱼提供的开放接口获取用户在七鱼内的服务记录。
- 服务记录包括:在线会话记录、呼叫服务记录、工单记录
# 接口鉴权
- 企业需单独申请该接口权限(仅限专业版及以上客户)。
- 数据鉴权:需要使用 appkey 和 appsecret 参与鉴权,参数可在七鱼后台获取,专业版以上支持该功能(首次进入是可以看到appsecret为空,点击"重置"后会第一次生成,之后点击就是刷新)
# 接口示例
实际完整请求地址如下例(POST): https://qiyukf.com/openapi/user/service/record?appKey=APPKEY&time=TIME&checksum=CHECKSUM (opens new window)
body内容如下(json格式):
{"uid":"xxxxxxx"}
uid为用户对接ID,checksum计算同客户标签接口。
响应信息为:
参数 | 数据类型 | 参数说明 |
---|---|---|
code | Integer | 错误码。200表示返回成功。 |
message | String | 错误提示信息 |
result | JsonArray | 服务记录结果 |
total | Integer | 服务记录总数量 |
当code=200时,result内容为JsonArray数据,字段说明如下:
- 在线会话记录
参数 | 数据类型 | 参数说明 |
---|---|---|
id | Long | 会话的ID |
sessionType | Integer | 在线会话记录=0 |
status | Integer | 客服解决状态:0:未解决,1:已解决,2:解决中 |
startTime | Long | 会话开始时间 |
closeTime | Long | 会话结束时间 |
categoryPath | String | 五级分类路径 |
mobile | String | 用户号码 |
userName | String | 用户昵称 |
uid | String | 用户对接ID |
staffName | String | 客服名称 |
satisfactionName | String | 服务评价 |
platform | String | 会话来源 |
- 呼叫服务记录
参数 | 数据类型 | 参数说明 |
---|---|---|
id | Long | 呼叫记录ID |
sessionType | Integer | 呼叫服务记录=1 |
status | Integer | 客服解决状态:0:未解决,1:已解决,2:解决中 |
startTime | Long | 服务开始时间 |
closeTime | Long | 服务结束时间 |
categoryPath | String | 五级分类路径 |
mobile | String | 被叫号码 |
userName | String | 用户昵称 |
uid | String | 用户对接ID |
staffName | String | 客服名称 |
satisfactionName | String | 服务评价 |
platform | String | 会话来源,默认为ipcc |
callNum | String | 呼叫主叫号码 |
recordSrc | String | 呼叫录音记录 |
- 工单服务记录
参数 | 数据类型 | 参数说明 |
---|---|---|
id | Long | 工单ID |
sessionType | Integer | 工单记录=6 |
status | Integer | 工单状态 |
userName | String | 用户昵称 |
worksheetCreateTime | Long | 工单创建时间 |
workSheetTitle | String | 工单标题 |
workSheetDealer | String | 工单受理人 |
workSheetDealGroup | String | 工单受理组 |
工单状态
WorkSheetStatus {
int UNDEFINED = 0;
int COMMITTED = 1; //已提交
int WAITING_FOR_BEING_APPLIED = 5; //已分配待申领(考虑待分配状态) 未受理
int APPLIED = 10; //已领取/已受理/处理中,当前版本已领取就意味着在处理 受理中
int FINISHED = 20; //完结
int REJECTED = 25; //已驳回
}