DeepLink

Special-links.md

@@ -1,11 +1,121 @@
-HTTP 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".
 
-TG links:
+## Links documented under [@DeepLink](https://t.me/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](https://t.me/bot?start=foo). Starts @bot with parameter "foo".
 * [tg://openmessage?chat_id=123&message_id=456](https://t.me/openmessage?chat_id=123&message_id=456). Should go to the message `456` from chat `123`.
 
+## Links documented under [@DeepLink](https://t.me/DeepLink):
+* tg://resolve
+  * `domain`: username to resolve. If the `domain` is `telegrampassport`, see tg://passport for parameters.
+  * `start`: [start parameter to use](https://lonamiwebs.github.io/Telethon/methods/messages/start_bot.html) in a private conversation with the bot.
+  * `startgroup `: [start parameter to use](https://lonamiwebs.github.io/Telethon/methods/messages/start_bot.html) in a group with the bot.
+  * `game`: undocumented.
+  * `post`: undocumented.
+
+* tg://join
+  * `invite`: [the invite hash to join to](https://lonamiwebs.github.io/Telethon/methods/messages/import_chat_invite.html).
+
+* tg://addstickers
+  * `set`: [the name of the sticker set to add](https://lonamiwebs.github.io/Telethon/methods/messages/install_sticker_set.html).
+
+* 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 (?)](https://t.me/DeepLink/28)
+* 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`](https://github.com/telegramdesktop/tdesktop/blob/v1.5.5/Telegram/SourceFiles/core/click_handler_types.cpp#L34-L69).
 
 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.