1.1. 根据群Id查询客户群信息
根据群Id查询客户群信息
1.1.1. 请求方法
GET /externalGroup/findGroup/{:chatId}
1.1.2. 请求参数
参数名 |
必填 |
类型 |
说明 |
chatId |
是 |
String |
群id |
1.1.3. 返回数据
属性名 |
类型 |
说明 |
code |
整型 |
执行结果码,200表示成功,其他表示错误 |
message |
字符串 |
执行结果说明 |
data |
对象 |
对象数组,每个元素详见上自定义data数据表 |
data(字段列表)
参数名 |
类型 |
说明 |
chatId |
String |
群聊Id |
name |
String |
群名称 |
number |
int |
群聊人数 |
lastChatTime |
LocalDateTime |
最近沟通时间 格式"yyyy-MM-dd HH:mm:ss" |
groupTag |
对象集合 |
群标签 |
-id |
Long |
标签主键id |
-groupId |
String |
标签所在标签组标识Id |
-tagColor |
String |
标签颜色 |
-tagId |
String |
标签标识Id |
-tagName |
String |
标签名 |
-tagOrder |
Integer |
标签顺序 |
memberList |
对象集合 |
群成员 |
-userid |
String |
成员id |
-type |
String |
成员类型1是员工,2是客户 |
-join_scene |
String |
入群方式 |
-unionid |
String |
微信成员才会有 |
-join_time |
String |
入群时间 |
ownerId |
String |
群主员工Id |
ownerName |
String |
群主名称 |
activeRate |
String |
群活跃度 |
todayIncreased |
Integer |
今日新增群人数 |
todayLeft |
Integer |
今日退群人数 |
todayActive |
Integer |
今日活跃群人数 |
newTime |
String |
创建时间 |
status |
int |
群状态(0 - 正常,1 - 跟进人离职,2 - 离职继承中,3 - 离职继承完成) |
customField |
对象集合 |
群自定义字段 |
-id |
Long |
字段主键id |
fieldName |
String |
字段名字 |
fieldCode |
String |
字段码值 |
contentType |
String |
字段类型:text单行文本,phone电话号码,date日期,datetime时间,droplist下拉列表,number整数,numeric实数,chained_droplist级联,area_text多行文本,checkbox多选 |
content |
String |
自定义字段具体内容 |
unKnow |
Integer |
外部群聊标识 1代表外部群 |
1.1.4. 请求示例
curl --location --request GET 'https://[子域名].wefeng360.com/api/v1/externalGroup/findGroup/wr_3b_EAAAzV5YTQbo5gOmjNZDqQet3w?sign=fbdd2e45e3bd9d1f1e4915863cff62c2d6f901490070741b821ad55d7e231552×tamp=1619143576' --header 'Content-Type: application/json'
返回示例
{
"succeed": true,
"code": 200,
"bizCode": "000000",
"message": "OK",
"visible": false,
"data": {
"id": 15928,
"chatId": "wr_3b_EAAAzV5YTQbo5gOmjNZDqQet3w",
"name": "兰博基尼车主群",
"number": 12,
"externalNumber": 9,
"innerNumber": 3,
"unknownExternalNumber": 0,
"ownerId": "zhoujielun",
"ownerName": "周杰伦",
"newTime": "2021-04-10 14:06:42",
"lastChatTime": "2021-11-02 16:49:55",
"status": 0,
"groupTag": [
{
"id": 642517,
"groupId": "52f626ce45214b16bfd250da50a90a83",
"tagId": "0b6e9e83c5184310a8a132a4d994c4c2",
"tagName": "特别",
"tagOrder": 3,
"tagColor": "#FB5127"
},
{
"id": 642516,
"groupId": "52f626ce45214b16bfd250da50a90a83",
"tagId": "9f7bbb1c134a4a2bb85b23365fb50054",
"tagName": "非常",
"tagOrder": 2,
"tagColor": "#11A848"
}
],
"createTime": "2021-04-10 14:06:47",
"updateTime": "2022-01-25 10:16:01",
"notice": null,
"customField": null,
"managerUserIdList": [
"xufan"
],
"managers": [
{
"id": "xufan",
"name": "徐帆"
}
],
"memberList": [
{
"userid": "dingkang",
"type": "1",
"join_scene": "",
"unionid": "2321ssgaq123xt1a123",
"join_time": "2021-01-21 09:12:21"
}
],
"todayIncreased": 0,
"todayLeft": 0,
"todayActive": 0,
"groupActive": "",
"unKnow": 2,
"stores": null,
"activeRate": null,
"office01Name": null,
"office02Name": null,
"office03Name": null,
"office04Name": null,
"office05Name": null,
"office06Name": null,
"office07Name": null,
"myGroup": false,
"customerServiceTurn": false,
"sales": null,
"orderNum": null,
"avgSales": null
}
}