更新群组/聊天室信息事件

大约 3 分钟

更新群组/聊天室信息事件

成功更新群组/聊天室信息后,环信服务器会按照发送后回调规则向你的 App Server 发送回调请求,App Server 可通过该回调查看更新后的群组/聊天室的信息,进行数据同步。

提示

  1. 你所使用的环信即时通讯 IM 的版本可能需要单独开通回调服务,详见增值服务说明
  2. 如果需要群组/聊天室信息更新的回调事件,你需要在环信控制台open in new window设置发送后回调规则,详见配置回调规则
  3. 发送后回调的相关介绍,详见回调说明

回调时机

通过客户端、RESTful API 或在环信控制台open in new window修改群组/聊天室的以下信息时会触发该事件:

  1. 群组
  • 群组名称
  • 群组描述
  • 群组最大成员数
  • 加入群组是否需要群主或者群管理员审批
  • 是否允许群成员邀请别人加入此群
  • 受邀人加入群组前是否需接受入群邀请
  • 群组扩展信息
  • 是否是公开群
  1. 聊天室
  • 聊天室名称
  • 聊天室描述
  • 聊天室最大成员数

回调请求

请求示例

下面的请求示例为更新群组信息的事件:

{
	"callId": "XXXX#XXXX_0679c3e3-XXXX-XXXX-8900-0cca0f24198e",
	"security": "4249dff0f1XXXX084cd9eebe4b4781e7",
	"payload": {
		"type": "INFO",
		"info": {
			"owner": "XXXX#XXXX_tst",
			"created": "1729496598199",
			"custom": "",
			"description": "描述",
			"mute": "false",
			"mute_duration": -1,
			"avatar": "https://XXXX/XXXX/XXXX",
			"title": "测试01",
			"max_users": "200",
			"invite_need_confirm": "true",
			"public": "true",
			"allow_user_invites": "false",
			"disabled": "false",
			"last_modified": "1729496598199"
		}
	},
	"appkey": "XXXX#XXXX",
	"id": "262246968131585",
	"type": "GROUP",
	"event": "group_op_event",
	"operation": "UPDATE",
	"operator": "@ppAdmin",
	"timestamp": 1729497138792
}

请求字段说明

以下以创建群组的事件为例进行字段介绍:

字段名称类型描述
callIdStringcallId 为每个回调请求的唯一标识,格式为 App Key_UUID
securityString签名,格式如下: MD5(callId+secret+timestamp)。详见配置环信控制台回调规则
payloadObject事件内容。
- typeString
- infoJSON修改后的群组信息。
- owner:String 类型,群主。
- created:Long 类型,群组创建时间。
- custom:String 类型,群组自定义信息。
- description:String 类型,群组描述。
- mute:Bool 类型,是否进行全员禁言,true 表示是,false 表示否。
- mute_duration:Long 类型,全员禁言时长,从当前时间开始计算。单位为秒。0 表示取消禁言,-1 表示永久禁言。
- avatar:String,群组头像 URL。
- title:String 类型,群组名称。
- max_users:群组最大成员数(包括群主)。
- invite_need_confirm:Bool 类型,邀请用户入群时是否需要被邀用户同意,true 表示需要被邀用户同意,false 表示不需要。
- public:Bool 类型,是否是公开群, true 表示公开群,false 表示私有群。
- allow_user_invites:Bool 类型,是否允许普通群成员邀请用户加入群组,true 表示允许,false 表示不允许,只有群主和群管理员才能邀请用户入群。
- disabled:Boolean 类型,true 表示群组为禁用状态,false,表示群组为非禁用状态,可正常使用。
- last_modified:Long 类型,群组信息的最新修改时间。
appkeyString你在环信管理后台注册的应用唯一标识。
idString群组 ID。
typeString区分群组或聊天室事件:
- GROUP:群组
- CHATROOM :聊天室
eventString对于群组和聊天室,该参数的值固定为 group_op_event。接收方可按此字段区分是否是群组/聊天室操作事件。
operationString操作。修改群组信息的操作为 UPDATE
operatorString操作人。
timestampLong操作完成的时间戳。

提示

群组操作的事件以及子事件后续会有更多新增。若业务强依赖这些事件或者子事件,业务中需添加对operationpayload.type 的强判断。 ::