Telegram link formats
Each row shows the normal web link, the iPhone URL scheme and the Android form. Replace the capitalised placeholders with real values.
| Content | Web link | iPhone (URL scheme) | Android |
|---|---|---|---|
| Channel, group or user | https://t.me/USERNAME | tg://resolve?domain=USERNAME | intent://t.me/USERNAME#Intent;package=org.telegram.messenger;scheme=https;end |
| Specific post | https://t.me/CHANNEL/123 | tg://resolve?domain=CHANNEL&post=123 | intent://t.me/CHANNEL/123#Intent;package=org.telegram.messenger;scheme=https;end |
| Bot with start parameter | https://t.me/BOTNAME?start=PAYLOAD | tg://resolve?domain=BOTNAME&start=PAYLOAD | intent://t.me/BOTNAME?start=PAYLOAD#Intent;package=org.telegram.messenger;scheme=https;end |
| Private invite | https://t.me/+INVITE_CODE | tg://join?invite=INVITE_CODE | intent://t.me/+INVITE_CODE#Intent;package=org.telegram.messenger;scheme=https;end |
tg:// skips the t.me web page that asks visitors to tap “Open in Telegram”.
Most apps do not officially document their URL schemes. The formats below are the ones DSLink uses in production today, but an app update can change them — test on a real device before hard-coding a scheme into your own app or site.
Using the scheme on a website
A URL scheme can go straight into a link. On iPhone, Safari asks the visitor to confirm before switching apps:
<a href="tg://resolve?domain=USERNAME">Open in Telegram</a>On Android you can add a web fallback to the intent itself. If the app is missing, Chrome opens the fallback URL instead of failing:
intent://t.me/USERNAME#Intent;package=org.telegram.messenger;scheme=https;S.browser_fallback_url=https%3A%2F%2Ft.me%2FUSERNAME;endTwo limits apply everywhere. If the app is not installed, a bare scheme does nothing useful — iOS shows an error. And built-in browsers inside apps such as Instagram, TikTok or X often block or ignore custom schemes, which is exactly where most links are tapped.
The no-code alternative: a smart link
A DSLink smart link wraps all of this in one short URL. On a phone it tries the right app format for the device, falls back to the Telegram web page if the app is missing, and sends desktop visitors straight to the website. You share one link everywhere and get click statistics on top.
Frequently asked questions
What is the tg:// URL scheme?
tg:// is the scheme the Telegram app registers. tg://resolve?domain=NAME opens a channel, group, user or bot; tg://join?invite=CODE opens a private invite.
Can I pass a start parameter to a Telegram bot?
Yes: tg://resolve?domain=BOTNAME&start=PAYLOAD. The payload may contain letters, digits, underscores and hyphens.
What happens if the Telegram app is not installed?
A bare URL scheme fails: iOS shows an error and nothing opens. Always pair it with a web fallback — on Android with S.browser_fallback_url in the intent, or use a DSLink smart link, which falls back to the web page automatically.