Note that chat invite links have the same syntax, but <phone_number> is not a valid phone number.
Used to link to users by their user ID: such links should only be parsed when encountered in inline or reply keyboard buttons.
-They are useful when linking to users without a username, but of course they will work only if the client has the user's access hash already stored in its database.
tg: syntax:
tg://user?id=<user_id>Parameters:
-| Name | -Optional | -Description | -
|---|---|---|
user_id |
-Required | -User ID | -
Used to invite users to private groups and channels, see here for more info on how to generate such links ».
t.me syntax:
Used to bring the user to the app settings.
-tg: syntax:
tg://settingsNo parameters.
-Used to bring the user to the phone number modification page, invoking account.sendChangePhoneCode and account.changePhone.
-tg: syntax:
tg://settings/change_numberNo parameters.
-Used to bring the user to the active sessions page, calling account.getAuthorizations.
-tg: syntax:
tg://settings/devicesNo parameters.
-Used to bring the user to the folder settings.
-tg: syntax:
tg://settings/foldersNo parameters.
-Used to bring the user to the language settings.
-tg: syntax:
tg://settings/languageNo parameters.
-Used to bring the user to the privacy and security settings.
-tg: syntax:
tg://settings/privacyNo parameters.
-Used to bring the user to the theme settings section of the app.
-tg: syntax:
tg://settings/themeNo parameters.
-Contains the phone number verification code to use during user authorization ».
+Used to import stickersets:
t.me syntax:
t.me/login/<code>t.me/addstickers/<name>tg: syntax:
tg://login?code=<code>tg://addstickers?set=<name>Parameters:
code |
+name |
Required | -Login code. | +Stickerset name | +
Used to import custom emoji stickersets:
+t.me syntax:
t.me/addemoji/<name>tg: syntax:
tg://addemoji?set=<name>Parameters:
+| Name | +Optional | +Description | +
|---|---|---|
name |
+Required | +Stickerset name | +
t.me syntax:
t.me/addtheme/<name>tg: syntax:
tg://addtheme?slug=<name>Parameters:
+| Name | +Optional | +Description | +
|---|---|---|
name |
+Required | +Theme name | +
Used to join voice chats and video chats in groups, and livestreams in channels.
+Such links are generated using phone.exportGroupCallInvite.
t.me syntax:
t.me/<username>?voicechat
+t.me/<username>?voicechat=<invite_hash>
+t.me/<username>?videochat
+t.me/<username>?videochat=<invite_hash>
+t.me/<username>?livestream
+t.me/<username>?livestream=<invite_hash>tg: syntax:
tg://resolve?domain=<username>&voicechat
+tg://resolve?domain=<username>&voicechat=<invite_hash>
+tg://resolve?domain=<username>&videochat
+tg://resolve?domain=<username>&videochat=<invite_hash>
+tg://resolve?domain=<username>&livestream
+tg://resolve?domain=<username>&livestream=<invite_hash>Parameters:
+| Name | +Optional | +Description | +
|---|---|---|
invite_hash |
+Optional | +Invite hash exported if the can_self_unmute flag is set when calling phone.exportGroupCallInvite: should be passed to phone.joinGroupCall, allows the user to speak in livestreams or muted group chats. |
+
Used to share a proxy server that can be used to connect to Telegram.
+Used for MTProxies ».
+t.me syntax:
t.me/proxy?server=<server>&port=<port>&secret=<secret>tg: syntax:
tg://proxy?server=<server>&port=<port>&secret=<secret>Parameters:
+| Name | +Optional | +Description | +
|---|---|---|
server |
+Required | +MTProxy server IP address or host | +
port |
+Required | +MTProxy server port | +
secret |
+Required | +MTProxy secret » | +
Used for socks5 proxies.
+t.me syntax:
t.me/socks?server=<server>&port=<port>&user=<user>&pass=<pass>tg: syntax:
tg://socks?server=<server>&port=<port>&user=<user>&pass=<pass>Parameters:
+| Name | +Optional | +Description | +
|---|---|---|
server |
+Required | +Proxy server IP address or host | +
port |
+Required | +Proxy server port | +
user |
+Optional | +Proxy server username | +
pass |
+Optional | +Proxy server password |
Used to bring the user to the app settings.
+tg: syntax:
tg://settingsNo parameters.
+Used to bring the user to the phone number modification page, invoking account.sendChangePhoneCode and account.changePhone.
+tg: syntax:
tg://settings/change_numberNo parameters.
+Used to bring the user to the active sessions page, calling account.getAuthorizations.
+tg: syntax:
tg://settings/devicesNo parameters.
+Used to bring the user to the folder settings.
+tg: syntax:
tg://settings/foldersNo parameters.
+Used to bring the user to the language settings.
+tg: syntax:
tg://settings/languageNo parameters.
+Used to bring the user to the privacy and security settings.
+tg: syntax:
tg://settings/privacyNo parameters.
+Used to bring the user to the theme settings section of the app.
+tg: syntax:
tg://settings/themeNo parameters.
+Contains the phone number verification code to use during user authorization ».
+t.me syntax:
t.me/login/<code>tg: syntax:
tg://login?code=<code>Parameters:
+| Name | +Optional | +Description | +
|---|---|---|
code |
+Required | +Login code. | +
t.me syntax:
t.me/invoice/<slug>
@@ -798,79 +951,6 @@ These links are used to confirm ownership of the phone number, to prevent accoun
-Proxy links
-Used to share a proxy server that can be used to connect to Telegram.
-MTProxy links
-Used for MTProxies ».
-t.me syntax:
-t.me/proxy?server=<server>&port=<port>&secret=<secret>
-tg: syntax:
-tg://proxy?server=<server>&port=<port>&secret=<secret>
-Parameters:
-
-
-
-Name
-Optional
-Description
-
-
-
-
-serverRequired
-MTProxy server IP address or host
-
-
-portRequired
-MTProxy server port
-
-
-secretRequired
-MTProxy secret »
-
-
-
-Socks5 proxy links
-Used for socks5 proxies.
-t.me syntax:
-t.me/socks?server=<server>&port=<port>&user=<user>&pass=<pass>
-tg: syntax:
-tg://socks?server=<server>&port=<port>&user=<user>&pass=<pass>
-Parameters:
-
-
-
-Name
-Optional
-Description
-
-
-
-
-serverRequired
-Proxy server IP address or host
-
-
-portRequired
-Proxy server port
-
-
-userOptional
-Proxy server username
-
-
-passOptional
-Proxy server password
-
-
-
QR code login links
Used by QR code login.
tg: syntax:
@@ -892,108 +972,6 @@ These links are used to confirm ownership of the phone number, to prevent accoun
-Stickerset links
-Used to import stickersets:
-t.me syntax:
-t.me/addstickers/<name>
-tg: syntax:
-tg://addstickers?set=<name>
-Parameters:
-
-
-
-Name
-Optional
-Description
-
-
-
-
-nameRequired
-Stickerset name
-
-
-
-Custom emoji stickerset links
-Used to import custom emoji stickersets:
-t.me syntax:
-t.me/addemoji/<name>
-tg: syntax:
-tg://addemoji?set=<name>
-Parameters:
-
-
-
-Name
-Optional
-Description
-
-
-
-
-nameRequired
-Stickerset name
-
-
-
-Theme links
-t.me syntax:
-t.me/addtheme/<name>
-tg: syntax:
-tg://addtheme?slug=<name>
-Parameters:
-
-
-
-Name
-Optional
-Description
-
-
-
-
-nameRequired
-Theme name
-
-
-
-Voice chat/Video chat/Livestream links
-Used to join voice chats and video chats in groups, and livestreams in channels.
-Such links are generated using phone.exportGroupCallInvite.
-t.me syntax:
-t.me/<username>?voicechat
-t.me/<username>?voicechat=<invite_hash>
-t.me/<username>?videochat
-t.me/<username>?videochat=<invite_hash>
-t.me/<username>?livestream
-t.me/<username>?livestream=<invite_hash>
-tg: syntax:
-tg://resolve?domain=<username>&voicechat
-tg://resolve?domain=<username>&voicechat=<invite_hash>
-tg://resolve?domain=<username>&videochat
-tg://resolve?domain=<username>&videochat=<invite_hash>
-tg://resolve?domain=<username>&livestream
-tg://resolve?domain=<username>&livestream=<invite_hash>
-Parameters:
-
-
-
-Name
-Optional
-Description
-
-
-
-
-invite_hashOptional
-Invite hash exported if the can_self_unmute flag is set when calling phone.exportGroupCallInvite: should be passed to phone.joinGroupCall, allows the user to speak in livestreams or muted group chats.
-
-
-
Bot attachment menu links
t.me syntax:
t.me/<username>?attach=<bot_username>