企业微信待办详情查询技能

wecom-cli 是企业微信提供的命令行程序，所有操作通过执行 wecom-cli 命令完成。

通过 wecom-cli 根据待办 ID 列表批量查询完整详情，包含待办内容和分派人信息。

行为策略

人员 ID 转姓名（关键步骤）: 返回结果中的 follower_id 和 creator_id 都是系统内部 ID，直接展示给用户毫无意义——用户不认识这些 ID，只认识姓名。因此在向用户展示待办详情之前，必须先调用 wecomcli-lookup-contact 技能获取通讯录，将所有 follower_id 和 creator_id 匹配为真实姓名。具体做法：

wecom-cli contact get_userlist '{}'

如果通讯录中找不到某个 ID，展示时标注"未知用户(ID: xxx)"即可。

重试策略: 遭遇"返回 HTTP 错误"或"HTTP 请求失败"时，主动重试，最多重试三次。

调用方式

wecom-cli todo get_todo_detail '<json格式的入参>'

参数说明

参数

类型

必填

说明

todo_id_list

array

✅

待办 ID 列表，最多 20 个

调用示例：

wecom-cli todo get_todo_detail '{"todo_id_list": ["TODO_ID_1", "TODO_ID_2"]}'

返回格式

{

    "errcode": 0,

    "errmsg": "ok",

    "data_list": [

        {

            "todo_id": "TODO_ID",

            "todo_status": 1,

            "content": "完成Q2规划文档",

            "follower_list": {

                "followers": [

                    {

                        "follower_id": "FOLLOWER_ID",

                        "follower_status": 1,

                        "update_time": "2025-01-16 14:20:00"

                    }

                ]

            },

            "creator_id": "CREATOR_ID",

            "user_status": 1,

            "remind_time": "2025-06-01 09:00:00",

            "create_time": "2025-01-15 10:30:00",

            "update_time": "2025-01-16 14:20:00"

        }

    ]

}

返回字段说明

字段

类型

说明

data_list

array

待办详情列表，最多 20 条

data_list[].todo_id

string

待办 ID

data_list[].todo_status

number

待办状态：0-已完成，1-进行中，2-已删除

data_list[].content

string

待办内容

data_list[].follower_list.followers

array

分派人列表

data_list[].follower_list.followers[].follower_id

string

分派人 ID（即 userid）— 展示前需通过 wecomcli-lookup-contact 转为姓名

data_list[].follower_list.followers[].follower_status

number

分派人状态：0-拒绝，1-接受，2-已完成

data_list[].follower_list.followers[].update_time

string

分派人状态更新时间

data_list[].creator_id

string

创建人 ID — 展示前需通过 wecomcli-lookup-contact 转为姓名

data_list[].user_status

number

当前用户状态

data_list[].remind_time

string

提醒时间

data_list[].create_time

string

创建时间

data_list[].update_time

string

更新时间

典型工作流

列表 + 详情联合查询（三步缺一不可）

用户问："看看我最近的待办" / "我有哪些待办事项？"

• 第一步：通过 wecomcli-get-todo-list 获取待办列表。

wecom-cli todo get_todo_list '{}'

• 第二步：根据返回的 todo_id 批量获取详情。

wecom-cli todo get_todo_detail '{"todo_id_list": ["TODO_ID_1", "TODO_ID_2", "TODO_ID_3"]}'

• 第三步（不要跳过！）：通过 wecomcli-lookup-contact 获取通讯录，将 follower_id / creator_id 转为姓名。用返回的 userlist 中的 userid 匹配 follower_id 和 creator_id，取 name 字段作为展示姓名

第三步是展示可读结果的前提。没有这一步，用户看到的是一串无意义的 ID 而非姓名。

展示格式（注意：分派人和创建人必须显示为姓名，不是 ID）：

📋 您当前的待办事项（共 3 项）

1. 🔵 完成Q2规划文档

   - 待办状态：进行中 | 我的状态：已接受

   - 提醒时间：2025-06-01 09:00

   - 分派人：张三、李四

   - 创建时间：2025-01-15

2. 🔵 提交周报

   - 待办状态：进行中 | 我的状态：已接受

   - 提醒时间：2025-03-17 18:00

   - 创建时间：2025-03-10

3. ☑️ 代码评审

   - 待办状态：已完成 | 我的状态：已完成

   - 创建时间：2025-03-01

注意事项

-

人员 ID 必须转姓名

• 返回结果中的 follower_id 和 creator_id 是系统内部标识，用户无法识别

• 展示待办详情前，先

wecom-cli contact get_userlist '{}'

获取通讯录

• 用通讯录的 userid 匹配 follower_id / creator_id，用 name 替换展示

-

todo_id 来源规则

• todo_id 必须来自 wecomcli-get-todo-list 返回的结果，禁止自行推测或构造

• 用户通常提供待办内容描述而非 ID，应先通过 wecomcli-get-todo-list 查列表再匹配

-

状态值含义

• 待办状态（todo_status）：0-已完成，1-进行中，2-已删除

• 用户状态（user_status）：0-拒绝，1-接受，2-已完成

• 分派人状态（follower_status）：0-拒绝，1-接受，2-已完成

-

错误处理：若 errcode 不为 0，告知用户 errmsg 中的错误信息

-

单次上限：todo_id_list 最多传 20 个 ID，超过需要分批请求