t.me Link Formats Cheat Sheet
Cheat sheets · 2026-11-06 · 18+ readers
Copy, adapt, test. Replace the bold parts with your own names.
The shapes
| You want to open | Link |
|---|---|
| A public chat, channel or bot | https://t.me/name |
| A bot with a payload | https://t.me/bot?start=payload |
| A bot, then choose a group | https://t.me/bot?startgroup=payload |
| A Mini App | https://t.me/bot/app |
| A Mini App with a value | https://t.me/bot/app?startapp=value |
| A post in a public channel | https://t.me/channel/123 |
| A private invite | https://t.me/+hash |
Payload rules
- Up to 64 characters.
- Letters, digits, underscore and hyphen.
- Visible to users, so no secrets.
Ideas for payloads
src_instagram,src_email: where a visitor came from.ref_abc: a referral code you look up.link_token: a one time token to connect a website account.
Before you publish
- Click it on a phone and on desktop.
- Check what your handler receives.
- Write it in a link register.
Frequently asked questions
Does the payload work on repeat visits?
Yes. Telegram sends
/start payload when the link is opened.
What if I need more than 64 characters?
Store the data on your server and pass a short key.
Do private invites expire?
Admins can limit them by count or time.