在钉钉机器人消息卡片中添加点击跳转链接,群机器人需在 Link 或 OA 消息类型中配置 messageUrl 字段,企业内部应用互动卡片则在按钮交互事件中设置链接值。群机器人支持直接填写 https 链接,内部应用跳转微应用需构造 dingtalk://协议链接。
先说结论:群机器人通过消息 payload 配置跳转,互动卡片通过模板按钮事件配置跳转
- 适合:服务器监控告警、业务审批通知、内部系统状态提醒
- 先准备:钉钉机器人 Webhook 地址或企业内部应用 Client ID 和 Client Secret
- 验收:点击消息卡片或按钮,确认浏览器或钉钉客户端能打开目标网页
快速处理思路
群机器人发送 Link 消息时,JSON payload 中直接填入 messageUrl 字段即可实现点击标题跳转。互动卡片需在卡片模板设计中,为按钮组件配置“点击事件类型”为链接跳转,并填写链接值。
为什么会这样
钉钉消息类型决定了跳转能力的配置位置,群机器人侧重简单通知,互动卡片侧重业务交互。群机器人的 Link 消息和 OA 消息原生支持 messageUrl 字段,点击消息主体即可跳转。互动卡片允许为单个按钮绑定独立链接,支持更复杂的业务操作如审批同意或查看详情。
分步处理
第一步,确认机器人类型。如果是群机器人 webhook,选择 Link 消息类型;如果是企业内部应用,选择互动卡片模板。
第二步,配置跳转链接。群机器人在 JSON 中设置 messageUrl 为 https 开头的网址。互动卡片在按钮设置项里,配置按钮点击事件类型为链接跳转,链接值填写目标地址。
第三步,处理内部应用跳转。若需跳转至企业内部微应用,链接需构造为 dingtalk://dingtalkclient/action/openapp 格式,包含 corpid 和 app_id 参数。
怎么验证是否生效
发送测试消息到钉钉群聊或个人会话,点击消息卡片标题或底部按钮。观察是否唤起浏览器打开指定网页,或是否在钉钉客户端内打开微应用页面。
常见坑
跳转地址必须经过 URL Encode 处理,否则参数可能丢失导致跳转失败。内部应用跳转若未配置 dingtalk://协议开头,可能无法在客户端内正确唤起。群机器人若启用签名验证,需确保请求头携带正确签名,否则消息发送失败导致无法测试跳转。
常见问题
群机器人消息跳转 URL 填写什么格式?
直接填写 https 开头的完整网页地址,例如 https://www.example.com/,收到消息后点击图片即可跳转。
互动卡片按钮点击无响应怎么办?
检查按钮设置项里的链接值是否为空,若值为空则点击无响应,需填写固定链接或绑定变量。
内部应用跳转链接如何构造?
需使用 dingtalk://协议,包含 corpid、container_type、app_id 等参数,具体参考消息链接说明构造。
参考来源
钉钉群机器人“消息跳转 URL”(messageUrl) 字段如何获取与配置
点击工作通知跳转到网页应用
钉钉企业应用开发技巧:在单聊会话中实现互动卡片功能
交互方式
消息卡片发送及更新