Telegram deep link builder
Generate tg:// deep links and https://t.me URLs for every common Telegram action. Useful for app integrations, marketing pages, welcome flows, and "open in Telegram" buttons.
To build a Telegram deep link, pick the action below (open user, start bot with parameter, join group, share message, open channel, etc.) and tgkit generates both the universal https://t.me/... URL and the in-app tg://... form. Use t.me for web/QR; use tg:// for in-app buttons. Free, no login.
| Universal link (t.me) | |
|---|---|
| App-only deep link (tg://) |
Deep link reference
| Open user / channel | tg://resolve?domain=username |
|---|---|
| Bot with start param | tg://resolve?domain=bot&start=value |
| Bot startgroup | tg://resolve?domain=bot&startgroup=value |
| Invite link | tg://join?invite=AbCdEfGhIjK |
| Share | tg://msg_url?url=...&text=... |
| Phone | tg://resolve?phone=15551234567 |
tg:// links open the Telegram app directly when the user has it installed. https://t.me/... links work universally (web fallback if no app). Most pages should use t.me; use tg:// inside your own app where you know Telegram is installed.
Start parameters explained
A start parameter is a custom string (≤64 chars, A-Z, a-z, 0-9, _ or -) that your bot receives the first time a user clicks the link. Use it to attribute referral source, pre-fill a coupon code, deep-link to a specific bot screen, or carry an auth token from your website into the bot conversation.
Why this matters for marketing
Every campaign should pass its own start parameter, ?start=instagram, ?start=summer25, ?start=podcast_ep14. The bot then logs the source the moment the user first interacts, giving you clean attribution that survives device switches and incognito tabs.
Frequently asked questions
How do I build a Telegram deep link?
A deep link points to a specific Telegram action: open a user, start a bot with a parameter, join a group, share a message. tgkit's deep link builder generates both the universal https://t.me/... form (best for web links scanned with a phone camera) and the in-app tg://... form (best for buttons inside Telegram), so you don't have to remember the syntax.
What's the difference between t.me links and tg:// links?
https://t.me/... works as a normal web URL: clicking it on a phone opens the Telegram app, on a desktop it shows a landing page that hands off to the desktop app. tg://... is the native scheme; reliable inside Telegram (in-app buttons, deep links inside other apps) but some browsers and apps don't handle it. Default to t.me unless you're sure the user is in-app.
How do I pass a parameter to a Telegram bot via a deep link?
Use https://t.me/ (or tg://resolve?domain=yourbot&start=PARAM). When the user opens the link and presses Start, your bot receives /start PARAM. PARAM can be up to 64 characters of A-Z a-z 0-9 _ -; great for referral tracking, UTM-like attribution, or jumping the user into a specific flow.
Can a deep link open a channel or join a group?
Yes. t.me/channelname opens (and lets the user join) a public channel; t.me/+ABCDEF uses an invite hash for private groups/channels; t.me/share/url?url=&text= pre-fills a message the user can forward. The builder generates all of these.