事件列表
| 事件名称 | 说明 | 自建应用 | 商店应用 |
|---|---|---|---|
| 通讯录 | |||
|---|---|---|---|
| 通讯录权限范围变更V2.0contact.scope.updated_v3 | 当应用通讯录范围权限发生变更时，订阅这个事件的应用会收到事件。 | ||
| 员工入职V2.0contact.user.created_v3 | 通过该事件订阅员工入职。 | ||
| 员工离职V2.0contact.user.deleted_v3 | 通过该事件订阅员工离职。应用身份访问通讯录的权限为历史版本，不推荐申请。 | ||
| 员工信息被修改V2.0contact.user.updated_v3 | 通过该事件订阅员工变更。old_object中只展示更新的字段的原始值。 | ||
| 成员字段变更V2.0contact.custom_attr_event.updated_v3 | 通过该事件订阅成员字段变更。old_object 展示更新字段的原始值。 | ||
| 新建人员类型V2.0contact.employee_type_enum.created_v3 | 新建人员类型会发出对应事件。 | ||
| 启用人员类型V2.0contact.employee_type_enum.actived_v3 | 启用人员类型会发出对应事件。 | ||
| 停用人员类型V2.0contact.employee_type_enum.deactivated_v3 | 停用人员类型会发出对应事件。 | ||
| 删除人员类型V2.0contact.employee_type_enum.deleted_v3 | 删除人员类型会发出对应事件。 | ||
| 修改人员类型名称V2.0contact.employee_type_enum.updated_v3 | 修改人员 类型名称会发出对应事件。 | ||
| 创建部门V2.0contact.department.created_v3 | 创建通讯录部门时发送该事件给订阅应用。 | ||
| 删除部门V2.0contact.department.deleted_v3 | 订阅这一事件可以获得被删除部门的信息。 | ||
| 修改部门信息V2.0contact.department.updated_v3 | 通过该事件订阅部门更新。old_object只展示被更新字段的原始值。应用身份访问通讯录的权限为历史版本，不推荐申请。 |
| 消息与群组 | |||
|---|---|---|---|
| 接收消息V2.0im.message.receive_v1 | 机器人接收到用户发送的消息后触发此事件。 | ||
| 消息已读V2.0im.message.message_read_v1 | 用户阅读机器人发送的单聊消息后触发此事件。 | ||
| 撤回消息V2.0im.message.recalled_v1 | 消息被撤回后触发此事件。 | ||
| 新增消息表情回复V2.0im.message.reaction.created_v1 | 消息被添加某一个表情回复后触发此事件。 | ||
| 删除消息表情回复V2.0im.message.reaction.deleted_v1 | 消息被删除某一个表情回复后触发此事件。 | ||
| 群解散V2.0im.chat.disbanded_v1 | 群组被解散后触发此事件。 | ||
| 群配置修改V2.0im.chat.updated_v1 | 群组配置被修改后触发此事件，包含：群主转移群基本信息修改(群头像/群名称/群描述/群国际化名称)群权限修改(加人入群权限/群编辑权限/at所有人权限/群分享权限)。 | ||
| 用户进群V2.0im.chat.member.user.added_v1 | 新用户进群（包含话题群）触发此事件。 | ||
| 用户出群V2.0im.chat.member.user.deleted_v1 | 用户主动退群或被移出群聊时推送事件。 | ||
| 撤销拉用户进群V2.0im.chat.member.user.withdrawn_v1 | 撤销拉用户进群后触发此事件。 | ||
| 机器人进群V2.0im.chat.member.bot.added_v1 | 机器人被用户添加至群聊时触发此事件。 | ||
| 机器人被移出群V2.0im.chat.member.bot.deleted_v1 | 机器人被移出群聊后触发此事件。 | ||
| 用户和机器人的会话首次被创建V1.0p2p_chat_create | 首次会话是用户了解应用的重要机会，你可以发送操作说明、配置地址来指导用户开始使用你的应用。 |
| 云文档 | |||
|---|---|---|---|
| 多维表格字段变更V2.0drive.file.bitable_field_changed_v1 | 多维表格字段变更 | ||
| 文件标题变更V2.0drive.file.title_updated_v1 | 文件标题变更时将触发此事件。 | ||
| 文件已读V2.0drive.file.read_v1 | 文件被打开将触发此事件。 | ||
| 文件编辑V2.0drive.file.edit_v1 | 文件编辑将触发此事件。 | ||
| 文件协作者添加V2.0drive.file.permission_member_added_v1 | 文件协作者添加用户/群时将触发此事件。 | ||
| 文件协作者移除V2.0drive.file.permission_member_removed_v1 | 文件协作者移除用户/群时将触发此事件。 | ||
| 文件删除到回收站V2.0drive.file.trashed_v1 | 文件被删除到回收站将触发此事件。 | ||
| 文件彻底删除V2.0drive.file.deleted_v1 | 文件被彻底删除将触发此事件。 |
| 日历 | |||
|---|---|---|---|
| 日历变更V2.0calendar.calendar.changed_v4 | 当订阅用户的日历列表有日历变动时触发此事件。 | ||
| 创建 ACLV2.0calendar.calendar.acl.created_v4 | 当被订阅的日历上有ACL被创建时触发此事件。 | ||
| 删除 ACLV2.0calendar.calendar.acl.deleted_v4 | 当被订阅的日历上有ACL被删除时触发此事件。 | ||
| 日程变更V2.0calendar.calendar.event.changed_v4 | 当被订阅的用户日历下有日程变更时触发此事件。 |
| 视频会议 | |||
|---|---|---|---|
| 企业会议开始V2.0vc.meeting.all_meeting_started_v1 | 发生在会议开始时，包含企业内所有会议开始事件。 | ||
| 企业会议结束V2.0vc.meeting.all_meeting_ended_v1 | 发生在会议结束时，包含企业内所有会议结束事件。 | ||
| 会议开始V2.0vc.meeting.meeting_started_v1 | 发生在会议开始时，目前仅提供预约会议的相关事件。 | ||
| 会议结束V2.0vc.meeting.meeting_ended_v1 | 发生在会议结束时，目前仅提供预约会议相关事件。 | ||
| 加入会议V2.0vc.meeting.join_meeting_v1 | 发生在有人加入会议时。 | ||
| 离开会议V2.0vc.meeting.leave_meeting_v1 | 发生在有人离开会议时。 | ||
| 录制开始V2.0vc.meeting.recording_started_v1 | 发生在开始录制时。 | ||
| 录制停止V2.0vc.meeting.recording_ended_v1 | 发生在录制结束时。 | ||
| 录制完成V2.0vc.meeting.recording_ready_v1 | 发生在录制文件上传完毕时。 | ||
| 屏幕共享开始V2.0vc.meeting.share_started_v1 | 发生在屏幕共享开始时。 | ||
| 屏幕共享结束V2.0vc.meeting.share_ended_v1 | 发生在屏幕共享结束时。 | ||
| 创建会议室V2.0vc.room.created_v1 | 当创建会议室时，会触发该事件。 | ||
| 删除会议室V2.0vc.room.deleted_v1 | 当删除会议室时，会触发该事件。 | ||
| 更新会议室V2.0vc.room.updated_v1 | 当更新会议室时，会触发该事件。 |
| 会议室 | |||
|---|---|---|---|
| 会议室状态信息变更V2.0meeting_room.meeting_room.status_changed_v1 | 会议室状态信息变更将触发此事件。 | ||
| 第三方会议室日程变动V1.0third_party_meeting_room_event_created | 当添加了第三方会议室的日程发生变动时（创建/更新/删除）触发此事件。 | ||
| 会议室创建V2.0meeting_room.meeting_room.created_v1 | 会议室被创建将触发此事件。 | ||
| 会议室属性变更V2.0meeting_room.meeting_room.updated_v1 | 会议室属性更新将触发此事件。 | ||
| 会议室删除V2.0meeting_room.meeting_room.deleted_v1 | 会议室被删除将触发此事件。 |
| 审批 | |||
|---|---|---|---|
| 审批定义更新V2.0approval.approval.updated_v4 | 「审批」定义更新时触发此事件。 | ||
| 请假审批V1.0leave_approvalV2 | 「审批」应用的表单里如果包含 请假控件组，则在此表单审批通过后触发此事件。 | ||
| 加班审批V1.0work_approval | 「审批」应用的表单里如果包含 加班控件组，则在此表单审批通过后触发此事件。 | ||
| 换班审批V1.0shift_approval | 换班申请审批通过后触发此事件。 你可以在「打卡」应用里提交换班申请。 | ||
| 补卡审批V1.0remedy_approval | 补卡申请审批通过后触发此事件。 你可以在「打卡」应用里提交补卡申请。 | ||
| 出差审批V1.0trip_approval | 「审批」应用的表单里如果包含 出差控件组，则在此表单审批通过后触发此事件。 | ||
| 外出审批V1.0out_approval | 「审批」应用的表单里如果包含 外出控件组，则在此表单审批通过后触发此事件。 |
| 服务台 | |||
|---|---|---|---|
| 创建工单V2.0helpdesk.ticket.created_v1 | 可监听服务台的工单创建事件。需使用订阅接口订阅：事件订阅 | ||
| 工单状态变更V2.0helpdesk.ticket.updated_v1 | 可监听工单状态和阶段变更事件。需使用订阅接口订阅：事件订阅 | ||
| 工单消息事件V2.0helpdesk.ticket_message.created_v1 | 该消息事件属于工单消息事件。需使用订阅接口订阅：事件订阅。 | ||
| 推送审核通知V2.0helpdesk.notification.approve_v1 | 推送审核状态通知事件。 |
| 任务 | |||
|---|---|---|---|
| 任务信息变更（租户维度）V2.0task.task.update_tenant_v1 | APP 订阅此事件后可 接收到该 APP 所在租户的所有来源接口创建的任务的变更事件。事件体为发生变更任务的相关用户的 open_id，可用此 open_id ，通过 获取任务列表接口获取与该用户相关的所有任务。 | ||
| 任务信息变更（应用维度）V2.0task.task.updated_v1 | 当 APP 订阅此事件后可以接收到由该 APP 创建的任务发生的变更，包括任务标题、描述、截止时间、协作者、关注者、提醒时间、状态（完成或取消完成）。 | ||
| 任务评论信息变更V2.0task.task.comment.updated_v1 | 当 APP 创建的任务评论信息发生变更时触发此事件，包括任务评论的创建、回复、更新、删除。 |
| 应用信息 | |||
|---|---|---|---|
| 新增应用反馈V2.0application.application.feedback.created_v6 | 当应用收到新反馈时，触发该事件 | ||
| 反馈更新V2.0application.application.feedback.updated_v6 | 当反馈的处理状态被更新时，触发该事件 | ||
| 应用创建V2.0application.application.created_v6 | 当企业内有新的应用被创建时推送此事件 | ||
| 首次启用应用V1.0app_open | 当租户第一次安装并启用此应用时触发此事件。 | ||
| 应用停启用V1.0app_status_change | 当企业管理员在管理员后台启用、停用应用，或应用被平台停用时，开放平台推送 app_status_change 事件到请求网址。 | ||
| 应用商店应用购买V1.0order_paid | 用户购买应用商店付费应用成功后发送给应用ISV的通知事件。 | ||
| app_ticket 事件V1.0app_ticket | 对于应用商店应用，开放平台会每隔1小时推送一次 app_ticket ，应用通过该 app_ticket 获取 app_access_token。 | ||
| 应用卸载V1.0app_uninstalled | 企业解散后会推送此事件。商店应用开发者可在收到此事件后进行相应的账户注销、数据清理等处理。自建应用无此事件。 | ||
| 应用可用性范围增加V2.0application.application.visibility.added_v6 | 仅当企业的用户通过「普通成员安装」方式获得应用可用性时推送此事件。 | ||
| 申请发布应用V2.0application.application.app_version.publish_apply_v6 | 通过订阅该事件，可接收应用提交发布申请事件 | ||
| 撤回应用发布申请V2.0application.application.app_version.publish_revoke_v6 | 通过订阅该事件，可接收应用撤回发布申请事件 | ||
| 应用审核V2.0application.application.app_version.audit_v6 | 通过订阅该事件，可接收应用审核（通过 / 拒绝）事件 |
| 智能门禁 | |||
|---|---|---|---|
| 用户信息变更V2.0acs.user.updated_v1 | 智能门禁用户特征值变化时，发送此事件。 | ||
| 新增门禁访问记录V2.0acs.access_record.created_v1 | 门禁设备识别用户成功后发送该事件给订阅应用。 |
| 历史版本 | |||
|---|---|---|---|
| 用户状态变更V1.0user_status_change | 当员工的激活、暂停账号/恢复账号、操作离职时会触发此事件。此事件不依赖于任何权限。 | ||
| 员工变更V1.0user_add | 当员工加入企业（user_add）、离职（user_leave）、个人信息发生变化（user_update）时，推送此事件。 | ||
| 部门变更V1.0dept_add | 当新建部门（dept_add）、删除部门（dept_delete）、修改部门（dept_update）时，推送此事件。 | ||
| 授权范围变更V1.0contact_scope_change | 当应用申请了 以应用身份访问通讯录 权限后，管理员可以配置应用的通讯录授权范围。 |
扫码加入交流群修改于 2023-01-11 08:42:33