群组封禁/解禁事件

成功封禁或解禁群组后，环信服务器会按照发送后回调规则向你的 App Server 发送回调请求，App Server 可通过该回调查看群组封禁或解禁相关信息，进行数据同步。

提示

1. 你所使用的环信即时通讯 IM 的版本可能需要单独开通回调服务，详见增值服务说明。
2. 如果需要群组封禁或解禁的回调事件，你需要在环信控制台设置发送后回调规则，详见配置回调规则。
3. 发送后回调的相关介绍，详见回调说明。

回调时机

调用 RESTful API 封禁或解禁群组时触发该事件。

回调请求

请求示例

{
	"callId": "XXXX#XXXX_9536cc9b-XXXX-XXXX-affb-8eaf67741180",
	"security": "2106f88ddbaXXXX57c60430493e74dc3",
	"payload": {
		"disable": true,
		"type": "DISABLE"
	},
	"appkey": "XXXX#XXXX",
	"id": "262246968131585",
	"type": "GROUP",
	"event": "group_op_event",
	"operation": "UPDATE",
	"operator": "@ppAdmin",
	"timestamp": 1729497011797
}

请求字段说明

字段名称	类型	描述
callId	String	callId 为每个回调请求的唯一标识，格式为 App Key_UUID。
security	String	签名，格式如下: MD5（callId+secret+timestamp）。详见配置环信控制台回调规则。
paylod	Object	事件内容。
- disabled	Boolean	- true：封禁 - false：解禁
- type	String	DISABLE：封禁或解禁操作。
appkey	String	你在环信管理后台注册的应用唯一标识。
id	String	群组 ID。
type	String	区分群组或聊天室事件。由于聊天室无封禁或解禁事件，本次事件仅对群组有效，因此值只能为 GROUP。
event	String	对于群组和聊天室，该参数的值固定为 group_op_event。接收方可按此字段区分是否是群组/聊天室操作事件。
operation	String	操作。群组封禁或解禁的操作为 UPDATE。
operator	String	操作人。
timestamp	Long	操作完成的时间戳。