使用方式
在回复中输出 ```json ``` 代码块，内容为符合 JSON Schema 的模板卡片 JSON。插件自动提取并发送。
你的回复文本...
```json
{
"card_type": "...",
...
}
```
生成规则
- 严格按 schema 生成：字段名、类型、嵌套结构必须与 ./references/api-template-card-types.md 中的 JSON Schema 定义完全一致
- 每张卡片必须有
task_id：格式 task_{场景}_{时间戳}，只能包含数字、字母、_-@
- 不要调用
wecom-cli 或其他工具发送卡片，直接在最终回复中输出 JSON 代码块
- 代码块外的文本会作为普通回复发送
卡片类型选择
决策流程
用户需求是否需要交互？
├─ 否（纯通知/信息推送）
│ ├─ 需要图片展示？ → news_notice
│ └─ 不需要图片 → text_notice
│
└─ 是（需要用户操作）
├─ 从有限选项中做一个操作（≤6个按钮）→ button_interaction
├─ 从一组选项中投票/选择（可多选） → vote_interaction
└─ 提供多个维度的选择（≤3个下拉框） → multiple_interaction
场景速查
| card_type |
典型场景 |
text_notice |
系统告警、部署通知、数据日报、审批结果、放假公告 |
news_notice |
新闻推送、活动宣传、产品发布、带图表的周报、新员工介绍 |
button_interaction |
审批（同意/驳回）、工单处理（接单/转派）、确认操作、满意度评价、二次确认（是/否） |
vote_interaction |
团建投票、会议时间协调、问卷单题、意见征集、方案评选 |
multiple_interaction |
多维度信息收集（部门+楼层+时间）、报障工单（类型+紧急程度）、会议室预定（日期+时间+房间） |
易混淆卡片区分
- button_interaction vs vote_interaction：按钮型适合"少量选项+即时操作"（如确认/取消），投票型适合"选项多+可多选+统一提交"（如投票）
- vote_interaction vs multiple_interaction：投票型是"一个问题选多项"，多项选择型是"多个独立问题各选一项"（如同时选时间和地点）
必填字段速查
| card_type |
required |
text_notice |
card_type, task_id, card_action, (main_title 或 sub_title_text 至少一个) |
news_notice |
card_type, task_id, main_title, card_action |
button_interaction |
card_type, task_id, main_title, button_list |
vote_interaction |
card_type, task_id, title, options |
multiple_interaction |
card_type, task_id, title, selectors |
最小示例
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"
}
wecomteam