# Dingtalk Event

钉钉个人 IM、OA 审批、VoIP 通话邀请、待办、互动卡片与好友事件长连接监听。Use when...

- Repository: https://github.com/DingTalk-Real-AI/dingtalk-workspace-cli (3872 stars)
- Category: Engineering
- License: Apache-2.0
- Last updated: 2026-10-29
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add DingTalk-Real-AI/dingtalk-workspace-cli --skill dingtalk-event -g -a claude-code -y`
Codex: `npx skills add DingTalk-Real-AI/dingtalk-workspace-cli --skill dingtalk-event -g -a codex -y`
Cursor: `npx skills add DingTalk-Real-AI/dingtalk-workspace-cli --skill dingtalk-event -g -a cursor -y`
Gemini CLI: `npx skills add DingTalk-Real-AI/dingtalk-workspace-cli --skill dingtalk-event -g -a gemini-cli -y`

## Description

钉钉个人 IM、OA 审批、VoIP 通话邀请、待办、互动卡片与好友事件长连接监听。Use when 用户说监听消息/@我/某人/某群/全部消息、已读/撤回/reaction、群成员加入/群成员退出，监听审批任务创建/完成/转交、审批实例发起/抄送/终止/完成、VoIP 通话邀请、待办创建/更新/删除、好友申请/好友添加成功，或互动卡片回调。命令前缀：dws event。

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 钉钉个人 IM、OA 审批、VoIP、待办、互动卡片与好友事件

> **前置：执行 `dws` 前必须完整读取 [`dingtalk-shared`](../dingtalk-shared/SKILL.md)。**Shared references 仅按需加载。

本 Skill 只负责实时个人事件；发送/历史消息、审批处理、待办操作分别走 `dingtalk-chat`、`dingtalk-misc`、`dingtalk-todo`。

<!-- dws-intent: event.listen.im -->消息、reaction、已读和撤回的默认监听入口是 `dws event +listen-im`；
只有群生命周期、Filter DSL、原始 envelope 或底层订阅控制才使用 `event consume`。

<!-- dws-intent: event.listen.oa -->OA 审批任务与审批实例的实时变化使用 `dws event consume`；查询或操作已有审批走 `dws oa`，不要用轮询模拟事件。

<!-- dws-intent: event.listen.todo -->待办创建、更新或删除的实时变化使用 `dws event consume`；查询或操作已有待办走 `dws todo`，不要用轮询模拟事件。

## Golden Route

The rest: https://github.com/DingTalk-Real-AI/dingtalk-workspace-cli/blob/HEAD/skills/multi/dingtalk-event/SKILL.md
