企微智能表格 操作技能

企业微信智能表格全流程自动化操作技能。 将用户的自然语言请求转化为企微智能表格写入 + 群机器人通知 + 本地追踪 + 定时提醒的完整闭环。

一、系统架构总览

1.1 三大智能表格

配置方式：首次使用前，需将企微智能表格的 Webhook Key 填入下方的占位符。Webhook Key 在企微文档 → 智能表格 → 更多 → Webhook 中获取。

表格写入 URL 格式：https://qyapi.weixin.qq.com/cgi-bin/wedoc/smartsheet/webhook?key={Webhook_Key}

1.2 三个群机器人

群通知 URL 格式：https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key={Bot_Key}

1.3 表格与群严格一一对应

费用申请系统 (expense) ──→ 费用审批群 (expense bot)
工作任务系统 (task)     ──→ 工作任务群 (task bot)
视频制作工作流 (video)  ──→ 视频制作群 (video bot)

⚠️ 绝对不能搞混！ 每个表格的通知必须发到它自己对应的群，不能统一发到所有群。

二、四步闭环 SOP（标准操作流程）

这是核心规则。每次操作企微智能表格，必须完整执行以下四步，缺一不可。

2.1 步骤①详细：写入表格

请求格式：

{
  "add_records": [
    {
      "values": {
        "字段ID": "字段值",
        "字段ID": "字段值"
      }
    }
  ]
}

curl 完整示例（工作任务系统）：

curl -s -X POST "https://qyapi.weixin.qq.com/cgi-bin/wedoc/smartsheet/webhook?key={TASK_WEBHOOK_KEY}" 
  -H "Content-Type: application/json" 
  -d '{
    "add_records": [{
      "values": {
        "ftQMc5": "查看公司写字楼附近的商业情况",
        "fMAfWQ": [{"user_id": "USER_ID_1"}],
        "fn8TJd": [{"user_id": "USER_ID_2"}],
        "fsaQFC": [{"user_id": "USER_ID_3"}],
        "fSP1Xe": "1777353600000",
        "fIH343": "1777447060000",
        "fp6iMs": [{"text": "未开始"}],
        "f9ftBb": 0
      }
    }]
  }'

成功响应：

{"errcode": 0, "errmsg": "ok", "add_records": [{"record_id": "recXXXXXX"}]}

失败响应示例：

{"errcode": 40001, "errmsg": "invalid userid"}

2.2 步骤②详细：群通知

Markdown 消息格式：

{
  "msgtype": "markdown",
  "markdown": {
    "content": "**📌 新任务通知**nn> 任务：任务名称n> 责任人：XXXn> 截止日期：2026-05-01n> 状态：未开始nn请及时处理！"
  }
}

curl 完整示例（工作任务群）：

curl -s -X POST "https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key={TASK_BOT_KEY}" 
  -H "Content-Type: application/json" 
  -d '{
    "msgtype": "markdown",
    "markdown": {
      "content": "**📌 新任务通知**nn> 任务：查看公司写字楼附近的商业情况n> 责任人：XXXn> 协作人：XXXn> 知会人：XXXn> 截止日期：2026-05-01n> 状态：未开始nn请及时处理！"
    }
  }'

通知模板（按表格类型）：

2.3 步骤③详细：本地追踪

每次成功写入表格后，需将关键信息追加到本地 JSON 文件。

文件路径：{WORKDIR}/wecom_deadline_tracker.json

记录格式：

{
  "table": "task",
  "record_id": "recXXXXXX",
  "name": "任务名称",
  "deadline": "2026-05-01",
  "responsible": "userid",
  "data": { ... },
  "tracked_at": "2026-04-27T16:30:00",
  "notified": false
}

可用 Python 函数（来自 wecom_smartsheet.py）：

• track_record(table, data, record_id) — 自动追加记录
• load_tracker() — 读取所有追踪记录
• get_upcoming_deadlines(days=3) — 获取未来 N 天内到期的记录

2.4 步骤④详细：设置提醒

使用 WorkBuddy 的 automation_update 工具创建一次性定时任务。

参数：

• mode: "suggested create"
• name: "任务提醒-{任务名称}"
• scheduleType: "once"
• scheduledAt: ISO 8601 格式，如 "2026-04-28T09:00"
• status: "ACTIVE"
• prompt: 包含 curl 命令，直接调群机器人发送提醒

prompt 模板：

发送一条提醒消息到工作任务群。执行以下命令：
curl -s -X POST "https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key={TASK_BOT_KEY}" -H "Content-Type: application/json" -d '{"msgtype":"markdown","markdown":{"content":"**⏰ 任务提醒**nn> 任务：{任务名称}n> 责任人：{责任人}n> 截止日期：{截止日期}n> 状态：{状态}nn请尽快处理！"}}'
发送完成后简要报告结果。

三、字段映射表（完整）

3.1 费用申请系统（expense）

3.2 工作任务系统（task）

3.3 视频制作工作流（video）

四、字段格式规范（严格执行）

4.1 类型→格式映射表

4.2 时间戳计算

日期字段必须传 Unix 毫秒时间戳字符串。

计算方法（macOS 终端）：

# 将日期转为毫秒时间戳
date -j -f "%Y-%m-%d" "2026-05-01" "+%s000"
# 输出: 1777353600000

Python 方法：

from datetime import datetime
ts = str(int(datetime.strptime("2026-05-01", "%Y-%m-%d").timestamp() * 1000))
# ts = "1777353600000"

⚠️ 绝不能手动计算时间戳！ 必须用 date 命令或 Python 计算。

4.3 userid 注意事项

⚠️ 传入无效 userid 会导致整条写入失败！

在首次使用前，请在企微通讯录中确认每个成员的 userid。如果不确定某个人的 userid，先移除该人，写入成功后再补。

五、完整操作示例

5.1 新建工作任务（最常用场景）

用户说："在工作任务表格中新建一个任务，任务描述：查看公司写字楼附近的商业情况，完全责任人：张三，协作人：李四，知会人：王五，2026-05-01 前完成，2026-04-28 提醒"

执行步骤：

① 计算时间戳：

# 计划开始时间（今天）
date -j -f "%Y-%m-%d" "2026-04-27" "+%s000"
# 计划结束时间
date -j -f "%Y-%m-%d" "2026-05-01" "+%s000"

② 写入表格：

curl -s -X POST "https://qyapi.weixin.qq.com/cgi-bin/wedoc/smartsheet/webhook?key={TASK_WEBHOOK_KEY}" 
  -H "Content-Type: application/json" 
  -d '{
    "add_records": [{
      "values": {
        "ftQMc5": "查看公司写字楼附近的商业情况",
        "fMAfWQ": [{"user_id": "USER_ID_1"}],
        "fn8TJd": [{"user_id": "USER_ID_2"}],
        "fsaQFC": [{"user_id": "USER_ID_3"}],
        "fSP1Xe": "1742697600000",
        "fIH343": "1777353600000",
        "fp6iMs": [{"text": "未开始"}],
        "f9ftBb": 0
      }
    }]
  }'

③ 群通知（工作任务群）：

curl -s -X POST "https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key={TASK_BOT_KEY}" 
  -H "Content-Type: application/json" 
  -d '{
    "msgtype": "markdown",
    "markdown": {
      "content": "**📌 新任务通知**nn> 任务：查看公司写字楼附近的商业情况n> 责任人：张三n> 协作人：李四n> 知会人：王五n> 截止日期：2026-05-01n> 状态：未开始nn请及时处理！"
    }
  }'

④ 本地追踪： 调用 track_record("task", data, record_id)

⑤ 设置提醒： 用 automation_update 创建一次性定时任务：

• scheduledAt: "2026-04-28T09:00"
• prompt: 包含 curl 命令调工作任务群机器人发送提醒

5.2 新建费用申请

① 写入表格（费用申请系统）：

curl -s -X POST "https://qyapi.weixin.qq.com/cgi-bin/wedoc/smartsheet/webhook?key={EXPENSE_WEBHOOK_KEY}" 
  -H "Content-Type: application/json" 
  -d '{
    "add_records": [{
      "values": {
        "f95bql": "4月办公室租金",
        "fSIkwz": [{"text": "房租税金"}],
        "ftk5Tx": "4800",
        "fMAfWQ": [{"user_id": "USER_ID"}],
        "fgeUSZ": "1777353600000"
      }
    }]
  }'

② 群通知（费用审批群）：

curl -s -X POST "https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key={EXPENSE_BOT_KEY}" 
  -H "Content-Type: application/json" 
  -d '{
    "msgtype": "markdown",
    "markdown": {
      "content": "**💰 费用审批通知**nn> 报销描述：4月办公室租金n> 费用类型：房租税金n> 金额：¥4800n> 申请人：XXXn> 付款截止：2026-05-01nn请审批！"
    }
  }'

③ 本地追踪 + ④ 设置提醒：同上

5.3 新建视频制作任务

① 写入表格（视频制作工作流）：

curl -s -X POST "https://qyapi.weixin.qq.com/cgi-bin/wedoc/smartsheet/webhook?key={VIDEO_WEBHOOK_KEY}" 
  -H "Content-Type: application/json" 
  -d '{
    "add_records": [{
      "values": {
        "fIxg8J": [{"text": "短视频"}],
        "fRZCUc": "AI创业入门5步法",
        "ftQMc5": [{"user_id": "USER_ID"}],
        "f0WI70": [{"user_id": "USER_ID"}],
        "faGcmb": "1777353600000"
      }
    }]
  }'

② 群通知（视频制作群）：

curl -s -X POST "https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key={VIDEO_BOT_KEY}" 
  -H "Content-Type: application/json" 
  -d '{
    "msgtype": "markdown",
    "markdown": {
      "content": "**🎬 视频制作通知**nn> 视频标题：AI创业入门5步法n> 类别：短视频n> 逐字稿负责人：XXXn> 计划完成日期：2026-05-01nn请及时推进！"
    }
  }'

六、每日巡检自动化

6.1 配置方式

• 运行时间：每日 09:00
• 执行内容：运行 wecom_daily_check.py
• 工作目录：本技能所在目录

6.2 巡检逻辑

1. 从 wecom_deadline_tracker.json 读取所有追踪记录
2. 筛选未来 3 天内到期的记录
3. 按表格类型分组（task/video/expense）
4. 逐组发送到对应群：
   • 有到期记录 → 发送到期提醒（🔴/🟡/🟢 标识紧急程度）
   • 无到期记录 → 发送日常摘要

6.3 巡检消息模板

有到期记录时：

**📌 工作任务提醒**
> 日期：2026-04-28

🔴 **任务名称**
   截止：2026-05-01（剩余3天）
   责任人：XXX

_定时巡检_

无到期记录时：

**📌 工作任务提醒**
> 日期：2026-04-28

> 任务追踪记录：X 条
> 即将到期：0 条（3天内）

> 今日暂无紧急到期任务 ✅

_定时巡检_

紧急程度标识：

• 🔴 剩余 ≤1 天
• 🟡 剩余 ≤2 天
• 🟢 剩余 ≤3 天

七、踩坑记录与注意事项

7.1 已踩过的坑

7.2 操作注意事项

1. 绝对不要用 wecom-cli 写入智能表格。直接 POST Webhook 是唯一推荐方式。
2. 绝对不要手动计算时间戳。用 date -j 命令或 Python datetime 计算。
3. 金额字段永远传字符串。即使看起来像数字，也必须用引号包裹。
4. 人员字段必须是数组格式。即使只有一个人，也要用 [{"user_id": "xxx"}]。
5. 文本数组字段必须是数组格式。即使只有一个选项，也要用 [{"text": "选项"}]。
6. 无效 userid 会导致整条记录写入失败。不确定的 userid 先跳过。
7. 每个表格的通知只发到它对应的群。task→工作任务群，expense→费用审批群，video→视频制作群。
8. 附件字段无法通过 Webhook 上传。传 [] 即可。
9. 四步闭环必须完整执行。写入→通知→追踪→提醒，缺一不可。
10. 日期字段传毫秒时间戳字符串。注意是字符串格式，不是数字。

八、工具链与脚本

8.1 脚本文件

8.2 CLI 工具

• wecom-cli（如已安装）：不推荐用于智能表格写入（参数复杂且需 sheet_id）
• 推荐方式：直接 curl POST Webhook

8.3 Python 可用函数（from wecom_smartsheet.py）

# 推送到表格
push_to_table(table, data, track=True)

# 构造 Webhook payload
build_webhook_payload(table, data)

# 发送群通知
send_notification(notify_type, title, fields, mention_list=None)

# 场景化通知
notify_expense_pending(description, amount, deadline, applicant, reviewer)
notify_task_deadline(task_name, responsible, deadline, priority, progress)
notify_video_milestone(video_title, stage, deadline, responsible)

# 本地追踪
track_record(table, data, record_id)
load_tracker()
save_tracker(records)
get_upcoming_deadlines(days=3)

# 日期转换
date_to_timestamp(date_str)  # "2026-05-01" → "1777353600000"

# 字段值自动转换
convert_field_value(table, field_title, value)

九、Markdown 通知格式规范

9.1 企微群 Markdown 支持范围

企微群机器人 Markdown 仅支持以下语法：

• 粗体：**文本**
• 引用：> 文本
• 字体颜色：文本（支持 info/warning/comment）
• 链接：[文本](URL)

不支持：标题（#）、代码块（```）、表格、图片、列表等。

9.2 颜色值

十、首次配置指南

克隆此技能后，按以下步骤配置凭证：

1. 在企微智能表格中获取三个表格的 Webhook Key：

   • 企微文档 → 智能表格 → 更多 → Webhook
   • 将 Key 填入脚本的对应位置

2. 在企微群中添加群机器人，获取群机器人 Webhook Key：

   • 群设置 → 群机器人 → 添加机器人
   • 记录每个群对应的 Key

3. 配置 userid 映射：

   • 在企微通讯录中确认每个成员的 userid
   • 建立中文名→userid 的映射表

十一、执行检查清单

每次操作前，用此清单自查：

• 确定目标表格类型（expense / task / video）
• 字段 ID 是否正确（查本文第三章映射表）
• 人员字段是否用 [{"user_id": "xxx"}] 格式
• 日期字段是否用毫秒时间戳字符串（用命令计算，不手算）
• 金额字段是否传了字符串（不是数字）
• 文本数组字段是否用 [{"text": "选项"}] 格式
• userid 是否在已验证列表中（不在则先跳过）
• 通知是否发到了正确的群（对照对应关系）
• 本地 tracker 是否已更新
• 提醒自动化是否已创建
• 四步闭环是否全部完成