如何在钉钉机器人消息卡片中添加点击跳转链接功能?

文章导读
在钉钉机器人消息卡片中添加点击跳转链接,群机器人需在 Link 或 OA 消息类型中配置 messageUrl 字段,企业内部应用互动卡片则在按钮交互事件中设置链接值。群机器人支持直接填写 https 链接,内部应用跳转微应用需构造 dingtalk://协议链接。
📋 目录
  1. 快速处理思路
  2. 为什么会这样
  3. 分步处理
  4. 怎么验证是否生效
  5. 常见坑
  6. 常见问题
  7. 参考来源
A A

在钉钉机器人消息卡片中添加点击跳转链接,群机器人需在 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) 字段如何获取与配置

点击工作通知跳转到网页应用

钉钉企业应用开发技巧:在单聊会话中实现互动卡片功能

交互方式

消息卡片发送及更新