Special links

HTTP links:

• https://t.me/bot?start=foo. Starts @bot with parameter "foo".
• https://t.me/share/url?url=foo. Lets the user select a chat and have their input be "foo".

Links documented under @DeepLink:

• https://telegram.me
• https://t.me
• https://telegram.dog
• https://telesco.pe

With any of those URLs, the following paths may be used:

• joinchat/

• addstickers/

• iv/

  • url
  • rhash

• msg/, share/ and share/url

  • url
  • text

• confirmphone

  • phone
  • hash

• start

• startgroup

• game

• socks, proxy

  • server (address)
  • port (port)
  • user (user)
  • pass (password)
  • secret (secret)

• setlanguage/

  • (up to 12 characters)

• bg

  • slug
  • mode
  • intensity
  • bg_color

TG links:

• tg://resolve?domain=bot&start=foo. Starts @bot with parameter "foo".
• tg://openmessage?chat_id=123&message_id=456. Should go to the message 456 from chat 123.

Links documented under @DeepLink:

• tg://resolve

  • domain: username to resolve. If the domain is telegrampassport, see tg://passport for parameters.
  • start: start parameter to use in a private conversation with the bot.
  • startgroup : start parameter to use in a group with the bot.
  • game: undocumented.
  • post: undocumented.

• tg://join

  • invite: the invite hash to join to.

• tg://addstickers

  • set: the name of the sticker set to add.

• tg://msg, tg://share and tg://msg_url

  • url: the text (or URL) to share.
  • text: extra text to share (placeholder), selected to be changed.

• tg://confirmphone

  • phone: undocumented.
  • hash: undocumented.

• tg://openmessage

  • user_id: undocumented.
  • chat_id: undocumented.
  • message_id: the ID of the message to focus.

• tg://passport

  • bot_id: undocumented.
  • scope: undocumented.
  • public_key: undocumented.
  • callback_url: undocumented.
  • nonce: undocumented.
  • payload: undocumented.

• tg://proxy and tg://socks

  • server: address of the proxy to connect to.
  • port: port used by the proxy server.
  • user: user name credentials.
  • pass: user password credentials.
  • secret: the secret for this MTProto proxy.

• tg://need_update_for_some_feature

• tg://some_unsupported_feature

• tg://user

  • id: the ID of the user to mention.

• tg://share_game_score (and?) tg://gshare

  • hash: undocumented.

• tg://filename (?)

• tg://login

  • code: the code sent by Telegram to login.

• tg://bg

  • slug: undocumented.
  • mode: undocumented.

• tg://search_hashtag (Telegram Web/Telegram React)

  • hashtag: the hashtag to search for.

• tg://bot_command (Telegram Web/Telegram React)

  • command: the command to use.
  • bot: undocumented.

• tg://unsafe_url (Telegram Web)

  • url: the underlying URL to access to.

---

More can be found in tdesktop's click_handler_types.cpp.

The links/urls might be platform-/client-specific and as such might not work on every client. If you really need to use some special link make sure it works on all platforms.