变更客户群事件 - 尘锋SCRM开放平台

当客户群发生入群、退群、群主变更、群名变更、群公告变更时，会推送本事件。

版本号说明

客户群变更较为频繁，开发者希望直接通过回调事件来更新群成员，因此事件新增变更成员列表信息。而变更事件的回调过程并不可靠（接收方可能丢失或乱序），为了让开发者能准确判断本次接收到的客户群变更事件是否可信任，变更事件中新增两个版本号：变更前的群成员版本号、变更后的群成员版本号。开发者可以存储每个群的最新版本号，当接收到客户群变更事件后，如果是成员入群或成员退群事件，则对比事件中的变更前版本号与自己存储的最新版本号是否一致，如果一致则说明本次事件可信任，并更新最新版本号。

请求参数（未加密）

请求参数名	类型	说明
data	`Object`	消息体
data.id	`String`	事件id
data.event	`String`	事件主类型（固定：MID_QW_CALLBACK）
data.action	`String`	事件子类型（固定：UpdateQwExternalChat）
data.body	`Object`	数据内容
data.body.account	`String`	租户id
data.body.chatID	`String`	群聊id
data.body.createTime	`Int`	企微客户群事件产生时间戳
data.body.QuitScene	`Int`	当是成员退群时有值。表示成员的退群方式 0 - 自己退群 1 - 群主/群管理员移出
data.body.joinScene	`Int`	当是成员入群时有值。表示成员的入群方式 0 - 由成员邀请入群（包括直接邀请入群和通过邀请链接入群） 3 - 通过扫描群二维码入群
data.body.curMemVer	`String`	当是成员入群或退群时有值。变更后的群成员版本号
data.body.lastMemVer	`String`	当是成员入群或退群时有值。变更前的群成员版本号
data.body.memChangeCnt	`Int`	当是成员入群或退群时有值。表示成员变更数量
data.body.memChangeList	`String`	当是成员入群或退群时有值。变更的成员列表
data.body.updateDetail	`String`	变更详情。目前有以下几种： add_member : 成员入群 del_member : 成员退群 change_owner : 群主变更 change_name : 群名变更 change_notice : 群公告变更
data.body.version	`String`	事件版本号
data.body.triggerTs	`Int`	触发时间戳

请求参数示例
json - Request-Example-加密:

//明文信息推送
{
	"id": "4c6421ea-f503-4a89-ba5b-7c9524cf596f",
	"event": "MID_QW_CALLBACK",
	"action": "UpdateQwExternalChat",
	"body": {
		"QuitScene": 0,
		"account": "W00000000516",
		"chatID": "wr6mJICgAAGwT55drBN9Qc8MC1hZBB_A",
		"createTime": 1703154761,
		"curMemVer": "a0aad82c2c6cf074de7a94e786f44b41",
		"joinScene": 0,
		"lastMemVer": "be7d9973d236a5ebb66099cf7e4420e0",
		"memChangeCnt": 1,
		"memChangeList": ["wmnBvEDAAAcI5lVREUeZMIFO6h-gqk3g"],
		"updateDetail": "add_member",
		"version": "v1"
	}
}

//信息加密推送
{
	"id": "4c6421ea-f503-4a89-ba5b-7c9524cf596f",
	"event": "MID_QW_CALLBACK",
	"action": "UpdateQwExternalChat",
	"body": {
		"encrypt": "XOKphmyMEcuW94gYtL/5Nj4ueFcfjaEFecC507QGzXbnDmavLp7I+s7K5BI4Qjt+Ayy/mNbw9bUE2x0HkSWm9h57VKJc9VLBghTjALWJcJduBDC7L6doORsZdaNlfVJU6DJ0VLyd1NojW9PfrzS01eQ7GW/dgaO3tkXQP2AOrGTn3Ca8haZQiwEJDYN/NUjW1/9T+gIcBu8LbmZGyokwrOD+ZGy7uky37yq8w8SGpis1WR2pIlZUOo+QdmWnMY1kJ9bHelH9h3ERemmNRIh/oMZp7QvFaNl/iCgUVAkh14tOV0nniE9Ld29GxyIEFz0nxD5+s4AG4cvq+xl+FXhu0A==",
		"msgSignature": "d64cc4a02b22b725a6b50a9843ebf9c0fd7ca70f",
		"timeStamp": "1661233174",
		"nonce": "9ZvYhI4aFmR7wUNl"
	}
}

成功响应

响应参数名	类型	说明
code	`Int`	响应码:状态码 0 失败，1 成功
msg	`String`	响应提示

成功响应示例

 {
    "code": 1,
    "msg": "成功"
}

错误响应示例

 {
    "code": 0,
    "msg": "处理失败"
}