必须先完成钉钉侧机器人接入授权与消息权限开通，否则卡片无法渲染或触发回调；配置流程包括：创建绑定钉钉机器人、启用并配置「钉钉群机器人」插件、认证AppKey/AppSecret；设计卡片支持内置编辑器、手写JSON或复用模板ID；回调需在钉钉侧填写Coze Webhook地址（末尾不带斜杠），并在Coze中设置「卡片回调」事件节点解析action.value并更新卡片。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在扣子（Coze）中配置卡片消息提升群聊交互体验，必须先完成机器人在钉钉侧的接入授权与消息权限开通，否则卡片将无法渲染或触发回调；未配置回调地址的卡片点击后会静默失败，且无任何错误提示。
创建并绑定钉钉机器人
登录 Coze 工作区 → 进入「Bot」页面 → 点击右上角「+新建 Bot」→ 填写名称、描述，选择「群聊机器人」类型 → 创建完成后，进入 Bot 设置页 → 左侧菜单点击「插件」→ 找到「钉钉群机器人」插件并启用。
点击插件右侧「配置」按钮 → 在弹窗中粘贴你在钉钉开放平台创建的企业内部应用的 【AppKey 和 AppSecret】 → 点击「保存并测试」→ 若显示“连接成功”，说明身份已认证通过；若失败，请确认钉钉侧应用是否已开通「群消息发送」和「互动卡片」权限。
这一步必须完成，否则后续所有卡片模板都无法下发到钉钉群内。
设计可交互的卡片模板
方法一：使用 Coze 内置卡片编辑器（推荐新手）
进入 Bot 编辑页 → 点击「对话流」→ 新建一个节点 → 类型选「发送消息」→ 消息类型切换为「卡片」→ 点击「编辑卡片」→ 选择「基础卡片」或「列表卡片」模板 → 在字段中填入标题、描述、按钮文字；按钮行为选「执行动作」→ 动作类型选「触发对话流节点」或「调用插件」。
方法二：手写 JSON 卡片结构（适合复杂布局）
在卡片编辑器中点击「切换为代码模式」→ 替换默认 JSON → 注意 key 必须符合钉钉卡片 schema 规范，例如按钮字段必须为 "action": {"type": "button", "text": "确认", "value": {"action": "confirm"}} ；【缺少 value 字段会导致按钮点击无响应】。
方法三：复用钉钉官方模板 ID
在 Coze 卡片编辑器中选择「使用模板 ID」→ 输入已在钉钉酷应用后台发布的合法 cardTemplateId → 该 ID 对应的卡片结构、样式、回调路由全部由钉钉侧托管，Coze 仅负责传入 cardData 数据。
配置卡片回调与事件响应
第一步：在钉钉开放平台酷应用后台，进入「功能设置」→「消息接收」→ 填写 Coze 提供的 Webhook 地址（格式如 https://bot.coze.cn/webhook/xxx），并启用「卡片回调事件」开关。
第二步：回到 Coze，进入「Bot 设置」→ 「网络」→ 找到「Webhook 接收地址」→ 复制该地址，确保与钉钉侧填写的一致；【地址末尾不能带斜杠 /，否则钉钉回调会 404】。
第三步：新建一个「事件触发」节点 → 事件类型选「卡片回调」→ 在节点内解析 payload 中的 action.value → 根据不同 value 值分支处理逻辑，例如 value 为 {"action":"approve"} 时自动更新审批状态并刷新卡片。
第四步：在该节点末尾添加「发送消息」动作 → 类型选「更新卡片」→ 输入原始卡片的 msgId（从回调 payload 中提取）→ 传入新 cardData → 完成状态实时刷新。
