群变更事件
更新于 2024-01-11开发者监听群回调事件可以更及时地响应群的变化,与业务集成。
配置事件回调
企业内部应用配置事件回调流程,参见配置事件订阅。
第三方企业应用配置事件订阅流程,请参见第三方企业应用事件与回调流程。
群的事件类型(call_back_tag)
call_back_tag | 说明 |
chat_add_member | 群会话添加人员。 |
chat_remove_member | 群会话删除人员。 |
chat_quit | 群会话用户主动退群。 |
chat_update_owner | 群会话更换群主。 |
chat_update_title | 群会话更换群名称。 |
chat_disband | 群会话解散群。 |
chat_template_change | 群模板被启用或停用(基于模板建群也会有启用的回调)。 |
im_cool_app_install | 群内安装酷应用。 |
im_cool_app_uninstall | 群内卸载酷应用。 |
群事件回调的数据结构
群会话添加人员
示例:
参数描述:
参数 | 说明 |
EventType | 事件类型。 |
TimeStamp | 时间戳。 |
CorpId | 发生群会话变更的企业。 |
ChatId | 会话的ID。 |
UserId | 用户发生变更的userid列表。 |
Operator | 操作人员的userid。 |
OpenConversationId | 群ID。 |
群会话删除人员
示例:
参数说明:
参数 | 说明 |
EventType | 事件类型。 |
TimeStamp | 时间戳。 |
CorpId | 发生群会话变更的企业。 |
ChatId | 会话的ID。 |
UserId | 用户发生变更的userid列表。 |
Operator | 操作人员的userid。 |
OpenConversationId | 群ID。 |
群会话用户主动退群
示例:
参数说明:
参数 | 说明 |
EventType | 事件类型。 |
TimeStamp | 时间戳。 |
CorpId | 发生群会话变更的企业。 |
ChatId | 会话的ID。 |
Operator | 操作人员的userid。 |
OpenConversationId | 群ID。 |
群会话更换群主
示例:
参数说明:
参数 | 说明 |
EventType | 事件类型。 |
TimeStamp | 时间戳。 |
CorpId | 发生群会话变更的企业。 |
ChatId | 会话的ID。 |
Owner | 已经更新的新的群主的userid。 |
OpenConversationId | 群ID。 |
群会话更换群名称
示例:
参数说明:
参数 | 说明 |
EventType | 事件类型。 |
TimeStamp | 时间戳。 |
CorpId | 发生群会话变更的企业。 |
ChatId | 会话的ID。 |
Title | 已经更新的新的群标题。 |
Operator | 操作人员的userid。 |
OpenConversationId | 群ID。 |
群会话解散群
示例:
参数说明:
参数 | 说明 |
EventType | 事件类型。 |
TimeStamp | 时间戳。 |
CorpId | 发生群会话变更的企业。 |
ChatId | 会话的ID。 |
Operator | 操作人员的userid。 |
OpenConversationId | 群ID。 |
群模板被启用或停用
示例:
参数说明:
参数 | 说明 |
EventType | 事件类型。 |
TimeStamp | 时间戳。 |
CorpId | 发生群会话变更的企业。 |
Status | 群模板状态。
|
TemplateId | 群模板ID。 |
ChangedTimeStamp | 变更时间戳。 |
Operator | 操作人员的userid。 |
OpenConversationId | 群ID。 |
群内安装酷应用
示例:
参数说明:
参数 | 说明 |
EventType | 事件类型。 |
EventTime | 事件发生的时间。 |
CorpId | 企业corpId |
BizId | 无业务意义,幂等id |
Operator | 操作人userId。 |
OpenConversationCorpId | 群会话所属企业corpId |
OperateTime | 操作时间。 |
OpenConversationId | 群ID。 |
CoolAppCode | 酷应用编码。 |
RobotCode | 机器人编码。 |
群内卸载酷应用
示例:
参数说明:
参数 | 说明 |
EventType | 事件类型。 |
EventTime | 事件发生的时间。 |
CorpId | 企业corpId |
BizId | 无业务意义,幂等id |
Operator | 操作人userId。 |
OpenConversationCorpId | 群会话所属企业corpId |
OperateTime | 操作时间。 |
OpenConversationId | 群ID。 |
CoolAppCode | 酷应用编码。 |
RobotCode | 机器人编码。 |