Telegram 链接格式

每一行显示普通网页链接、iPhone URL 方案和 Android 格式。将大写占位符替换为真实值。

内容网页链接iPhone(URL 方案)安卓
频道、群组或用户https://t.me/USERNAMEtg://resolve?domain=USERNAMEintent://t.me/USERNAME#Intent;package=org.telegram.messenger;scheme=https;end
特定帖子https://t.me/CHANNEL/123tg://resolve?domain=CHANNEL&post=123intent://t.me/CHANNEL/123#Intent;package=org.telegram.messenger;scheme=https;end
带有 start 参数的机器人https://t.me/BOTNAME?start=PAYLOADtg://resolve?domain=BOTNAME&start=PAYLOADintent://t.me/BOTNAME?start=PAYLOAD#Intent;package=org.telegram.messenger;scheme=https;end
私人邀请https://t.me/+INVITE_CODEtg://join?invite=INVITE_CODEintent://t.me/+INVITE_CODE#Intent;package=org.telegram.messenger;scheme=https;end
Note

tg:// 会跳过需要访客点击“在 Telegram 中打开”的 t.me 网页。

Not an official API

大多数应用程序并未正式记录它们的 URL 方案。下面的格式是 DSLink 目前在生产中使用的,但应用程序更新可能会更改它们 — 在将方案硬编码到自己的应用或网站之前,请在真实设备上进行测试。

在网站上使用该方案

URL 方案可以直接放入链接。在 iPhone 上,Safari 会在切换应用前要求访问者确认:

<a href="tg://resolve?domain=USERNAME">Open in Telegram</a>

在 Android 上,你可以将网页备用链接添加到 intent 本身。如果应用缺失,Chrome 会打开备用 URL,而不是失败:

intent://t.me/USERNAME#Intent;package=org.telegram.messenger;scheme=https;S.browser_fallback_url=https%3A%2F%2Ft.me%2FUSERNAME;end

有两个限制适用于所有情况。如果应用未安装,空方案没有任何有用的功能——iOS 会显示错误。而且像 Instagram、TikTok 或 X 这样的应用内置浏览器通常会阻止或忽略自定义方案,这恰恰是大多数链接被点击的地方。

DSLink 智能链接将所有这些包装在一个短 URL 中。在手机上,它会尝试设备的正确应用格式,如果应用缺失则回退到 Telegram 网页,并将桌面访问者直接发送到网站。你可以到处分享一个链接,并获得点击统计。

常见问题

tg:// URL 方案是什么?

tg:// 是 Telegram 应用注册的方案。tg://resolve?domain=NAME 可打开频道、群组、用户或机器人;tg://join?invite=CODE 可打开私人邀请。

我可以向 Telegram 机器人传递 start 参数吗?

可以:tg://resolve?domain=BOTNAME&start=PAYLOAD。payload 可以包含字母、数字、下划线和连字符。

如果未安装 Telegram 应用,会发生什么?

裸 URL 方案会失败:iOS 会显示错误并且不会打开任何内容。始终将其与网页回退配对——在 Android 上使用 intent 中的 S.browser_fallback_url,或者使用 DSLink 智能链接,它会自动回退到网页。