钉钉聊天中链接转卡片

钉钉支持在聊天中发送链接时自动转换为链接卡片消息，以丰富消息内容，提升消息阅读者查看效率。

实现原理

钉钉会尝试抓取和分析聊天输入框中的链接的网页内容，并根据OGP****协议（全称Open Graph Data协议）提取其中的标签作为分享标签的内容。显示效果如下：
卡片链接

OGP协议是一套Metatags的规格，用来标注你的页面，告诉我们你的网页快照。帮助社交app高效并准确的获取网页中的核心链接、标题、主图、正文摘要等信息，使得该网页在社交分享中有更好的展现体验。

如果网页不支持OGP，那么基于算法和规则来提取网页中标题、主图、正文摘要，准确性无法做到100%，体验也不能充分保证。尤其是有部分页面html采用前端js渲染，而不是服务端渲染，会导致无法提取主图、正文摘要，链接卡片体验比较糟糕。

如何适配Open Graph Data

你只需要在页面的HTML标签中增加以下meta标签即可。

注意

出于性能和体验考虑，链接转卡片服务不支持执行HTML中的js，上述Metatags必须在服务端渲染。

参考示例

可以参考网站 https://www.apple.com

常见问题

通过js动态渲染的meta头，是否可以支持？

当前不保证支持，受限于抓取方式，建议由服务端渲染meta头。

我们网站移动端和PC端页面是不一样的，是否都需要适配？

是的，都需要适配好相应的meta头，钉钉抓取时，会根据抓取效果，不定期调整抓取策略，可能是移动端的User-Agent，也可能是PC端的User-Agent，以提升抓取效果，优化链接卡片体验。

我们网站适配OGP后，是否只在钉钉上有好的链接卡片体验？

不仅仅是钉钉，OGP是个开放协议，包括Facebook在内的大量社交app都支持了OGP协议，如果网页适配了OGP协议，那么在这些app中都会有非常好的链接卡片体验。

钉钉上链接转卡片服务会提升哪些场景下链接体验？

除了上面描述的聊天之外，通过手机浏览器分享到钉钉（例如Safari中分享到钉钉），或者钉钉聊天中打开链接的页面，分享到钉钉。这些场景都会通过OGP协议提取链接卡片信息，实现更好的分享体验。

如果我不需要卡片，需要原始链接怎么办？

升级到钉钉最新版本，可以在链接卡片上看到复制按钮，通过复制按钮，可以复制原始的链接。

如果不希望消息中链接被转成卡片，可以怎么做？

当前可以有两种方式，一种是发送代码，以代码形式发送的链接不会被转成卡片消息，另一种是文字和链接一起发送，也不会被自动转换。

钉钉链接转卡片是否有缓存？我们网页中信息已经更新了，但是转换出来的链接卡片还是旧的。

目前在服务端抓取时没有缓存，但是为了提升体验，在客户端上（包括移动端和桌面端）有内存缓存，重启钉钉后，缓存自动失效。特别注意：已经转成卡片的消息不再更新，如果测试的话，可以重新发一次来验证。

我们内网链接不希望被抓取怎么办？

钉钉链接卡片的抓取，采用的是阿里云公有云服务器，内网网站正常做好网络隔离、权限控制即可。例如仅限内网用户访问，或者设置必须合法登录才能访问等。

我们内网链接希望转成更友好的卡片消息怎么办？

为了避免企业内网信息泄漏，钉钉链接转卡片服务不会针对内网做穿透等抓取，暂时不会提供针对内网的抓取服务和方案。如果希望内网页面有个好的链接卡片样式，可以针对未登录用户，参考上述技术描述，增加相应的OGP Metatags来自定义链接卡片样式。

该服务的爬虫有什么标识吗？

可以通过这个User-Agent来识别：DingTalk-LinkService/1.0

我们网站是正常的，为什么链接转卡片后标题/描述中出现类似“验证码”、“当前请求存在恶意行为已被系统拦截……”等异常信息？

请检查网站的安全策略模块，是否把钉钉的爬虫自动加入到黑名单中。备注：可以通过上面的User-Agent来识别钉钉爬虫服务。

参考资料

Must-Have Social Meta Tags for Twitter, Google+, Facebook and More

OGP, The Open Graph protocol

钉钉聊天中链接转卡片

实现原理#

如何适配Open Graph Data#

推荐使用场景#

参考示例#

常见问题#

参考资料#

实现原理

如何适配Open Graph Data

推荐使用场景

参考示例

常见问题

参考资料