在钉钉群里使用机器人推送告警或工单时,经常需要把手机号变成可点击的拨号链接。这个需求能不能实现,取决于消息类型而不是机器人类型。如果你已经在用自定义机器人,那么通常只需要把消息改成 markdown 类型,并在文本里加入 tel: 协议链接即可。下面按排查顺序记录,具体效果需要结合你使用的钉钉客户端版本确认。
纯文本消息不会自动拨号
在钉钉群聊中,机器人发送的纯文本消息里,手机号不会自动被识别为可点击链接。钉钉的普通文本消息只支持URL自动识别,像http/https这样的协议会被自动加链接,但tel:这类拨号协议不会自动解析。要想手机号可点击,必须主动构造超链接,而且需要消息类型为markdown。因为markdown类型消息支持[文本](链接)语法,而text类型不支持。所以判断依据是:如果希望群成员点击号码直接拨号,就需要将机器人消息配置成markdown,并在消息体中用链接语法包裹手机号。
也就是说,先别急着改代码,先确认你手里这个机器人能不能发送 markdown。钉钉自定义机器人 Webhook 的 msgtype 可以选择 text 或 markdown,如果你只是往 webhook 里 POST 了一段 text 消息,就算把手机号写成 tel: 格式,也不会被解析。
用 markdown 链接包住手机号
具体做法是在调用钉钉机器人Webhook时,把请求体中的msgtype设为markdown,然后在markdown字段的text属性里写上类似[13800138000](tel:13800138000)这样的内容。注意链接文本也可以是“拨打电话”等,不一定必须显示号码。如果你是在编写代码,构造JSON时需要对特殊字符做转义,特别是双引号和反斜杠。发送成功后,这条消息会显示为一个可点击的蓝色链接,点击后通常会在手机上唤起系统拨号界面。为了确保兼容,建议先在一个只有自己的测试群中发送一次,确认显示效果。
一个可以直接测试的请求体如下:
{
"msgtype": "markdown",
"markdown": {
"text": "点击拨打电话:[13800138000](tel:13800138000)"
}
}如果你使用 curl,注意请求体里 JSON 的双引号在命令行中要正确转义。另外,链接紧跟在 [文本] 后面时,末尾最好加一个空格,防止某些钉钉版本把下文中的标点也吞进链接。
tel: 协议不生效时的备选跳转
如果发现tel:协议在目标钉钉客户端上无法正常唤起拨号盘,一个后备做法是换用一个https链接。你可以部署一个简单的H5页面,页面通过window.location.href='tel:13800138000'来实现拨号,或者直接跳转到钉钉通讯录中带手机号的人员详情页。在钉钉机器人的markdown消息中,可以写成[拨打13800138000](https://your.domain/call?phone=13800138000)。但注意,钉钉对未知域名可能显示安全提示,所以域名最好是你自己备案过的。这个方案比tel:多一层跳转,但兼容性更好。
这里有个业务上的取舍:tel: 协议无法统计点击次数,如果你需要知道多少人点了号码,就必须走 https 链接,并在自己的服务器上记录请求。如果只是内部群里偶尔点一下,tel: 就够了。
发送之后要检查哪些东西
消息发送成功后,不要只盯着 Webhook 接口返回的 errcode。errcode 为 0 只代表消息推送成功,并不代表链接渲染正常。你需要到群里看两点:第一,消息文本是否显示为蓝色下划线链接;第二,长按或点击后有没有唤起拨号盘。由于钉钉在 iOS 和 Android 上对 tel: 的支持程度不同,建议在这两种客户端上分别试一次。如果点击无反应,再考虑换用上面的 https 方案。
常见坑还有三个:一是手机号里不要混入空格、短横线或括号,比如写成 138-0000-8000 会导致链接解析失败;二是如果一个 markdown 文本里同时有多个链接,注意括号和方括号要配对,必要时在链接结尾加空格分隔;三是自定义机器人 webhook 地址里的 access_token 属于敏感信息,不要在消息内容或代码仓库里暴露它。
另外要注意隐私边界。手机号以明文形式出现在群消息里,所有群成员都能看到并点击。如果这个群是公开群或人数较多,就可能被滥用。建议只在内部小范围群使用,或者展示脱敏号码,比如显示 138****8000,但链接内的号码仍用完整格式。钉钉机器人本身还有关键字和 IP 白名单限制,如果你的机器人配置了这些,链接中的域名或文字需要提前加进白名单或定义成关键字,否则消息会被拦截。
钉钉机器人带手机号链接这件事,实现路径不算复杂,但每个环节都需要确认。先用 markdown 和 tel: 做最小验证,不行再上 https 中转;同时控制群聊范围,避免手机号被滥用。按照这个顺序排查,基本能覆盖大部分情况。