wecom-send-template-card

使用方式

在回复中输出 `json ` 代码块，内容为符合 [JSON Schema](./references/api-template-card-types.md) 的模板卡片 JSON。插件自动提取并发送。

```` 你的回复文本...

{
  "card_type": "...",
  ...
}

````

生成规则

1. 严格按 schema 生成：字段名、类型、嵌套结构必须与 [./references/api-template-card-types.md](./references/api-template-card-types.md) 中的 JSON Schema 定义完全一致
2. 每张卡片必须有 taskid：格式 task{场景}{时间戳}，只能包含数字、字母、-@
3. 不要调用 wecom-cli 或其他工具发送卡片，直接在最终回复中输出 JSON 代码块
4. 代码块外的文本会作为普通回复发送

卡片类型选择

决策流程

用户需求是否需要交互？
├─ 否（纯通知/信息推送）
│  ├─ 需要图片展示？ → news_notice
│  └─ 不需要图片   → text_notice
│
└─ 是（需要用户操作）
   ├─ 从有限选项中做一个操作（≤6个按钮）→ button_interaction
   ├─ 从一组选项中投票/选择（可多选）    → vote_interaction
   └─ 提供多个维度的选择（≤3个下拉框）  → multiple_interaction

场景速查

易混淆卡片区分

• buttoninteraction vs voteinteraction：按钮型适合"少量选项+即时操作"（如确认/取消），投票型适合"选项多+可多选+统一提交"（如投票）
• voteinteraction vs multipleinteraction：投票型是"一个问题选多项"，多项选择型是"多个独立问题各选一项"（如同时选时间和地点）

必填字段速查

最小示例

text_notice

{
  "card_type": "text_notice",
  "main_title": { "title": "项目进度更新", "desc": "进度已达 80%" },
  "emphasis_content": { "title": "80%", "desc": "完成度" },
  "card_action": { "type": 1, "url": "https://work.weixin.qq.com" },
  "task_id": "task_progress_1711234567"
}

news_notice

{
  "card_type": "news_notice",
  "main_title": { "title": "新功能上线", "desc": "v5.0 已发布" },
  "card_image": { "url": "https://wework.qpic.cn/wwpic/xxx/0" },
  "card_action": { "type": 1, "url": "https://work.weixin.qq.com" },
  "task_id": "task_release_1711234568"
}

button_interaction

{
  "card_type": "button_interaction",
  "main_title": { "title": "方案选择", "desc": "请选择技术方案" },
  "button_list": [
    { "text": "A方案-重构", "style": 1, "key": "plan_a" },
    { "text": "B方案-兼容", "style": 4, "key": "plan_b" }
  ],
  "task_id": "task_plan_select_1711234569"
}

vote_interaction（简化格式）

{
  "card_type": "vote_interaction",
  "title": "团建投票",
  "description": "选择你想参加的活动",
  "options": [
    { "id": "hiking", "text": "爬山" },
    { "id": "dinner", "text": "聚餐" },
    { "id": "escape", "text": "密室逃脱" }
  ],
  "mode": 1,
  "submit_text": "提交投票",
  "task_id": "task_team_vote_1711234570"
}

multiple_interaction（简化格式）

{
  "card_type": "multiple_interaction",
  "title": "团建安排",
  "description": "分别选择时间和地点",
  "selectors": [
    {
      "title": "时间",
      "options": [
        { "id": "sat", "text": "周六" },
        { "id": "sun", "text": "周日" }
      ]
    },
    {
      "title": "地点",
      "options": [
        { "id": "park", "text": "公园" },
        { "id": "resort", "text": "度假村" }
      ]
    }
  ],
  "submit_text": "提交选择",
  "task_id": "task_arrange_1711234571"
}