TSocial TSocial
Open in Telegram
Better in TelegramOpen in Telegram
TSocial planet logoTelesocial

Telesocial › Cheat sheets

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 openLink
A public chat, channel or bothttps://t.me/name
A bot with a payloadhttps://t.me/bot?start=payload
A bot, then choose a grouphttps://t.me/bot?startgroup=payload
A Mini Apphttps://t.me/bot/app
A Mini App with a valuehttps://t.me/bot/app?startapp=value
A post in a public channelhttps://t.me/channel/123
A private invitehttps://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

  1. Click it on a phone and on desktop.
  2. Check what your handler receives.
  3. Write it in a link icon 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.

More cheat sheets

t.me Link Formats Cheat Sheet | Telesocial