How to Setup Telegram Proxy? Complete Guide to Official Web-Proxy (tproxy)

Step 1: Get Your Web-Proxy Parameters

After you purchase or try the Web-Proxy service at TGV, you will receive a very special set of parameters. Unlike traditional proxies, it has no port number.

You will receive the following two strings (usually shown in the email or dashboard):

• Proxy server: A domain like proxy.example.com or proxy.example.com/path. Note: Do NOT include https:// or port number.
• Proxy secret: A 32-character hexadecimal string or a specific format secret (e.g., 000102030405060708090a0b0c0d0e0f).

Step 2: Configure Telegram Client

Method 1: One-Click Automatic Import (Fastest)

TGV dashboard or email will include a link like https://t.me/webproxy?server=...&secret=....

1. Copy this link on your phone or computer.
2. Send it to "Saved Messages" or any chat on Telegram.
3. Click the link directly, and Telegram will automatically pop up a prompt.
4. Confirm the addition to complete the configuration.

Method 2: Manual Setup (Step-by-Step)

If you cannot use the one-click link, please follow these steps to configure manually:

1. Open Telegram, go to Settings -> Data and Storage -> Proxy.
2. Click the "Add Proxy" button.
3. The most critical step: in the type selection, you must choose WEB (do not choose MTPROTO or SOCKS5).
4. In the Server field, enter the domain you received (e.g., proxy.example.com).
5. In the Secret field, paste the 32-character secret you received.
6. Click Done to save, and enable the proxy.

👆 Make sure to select WEB as the proxy type. Only domain and secret are required.

Step 3: How to Confirm Successful Configuration?

After configuring, return to the Proxy Settings page. If you see "web: connected" like the screenshot below, it means you have successfully connected to Telegram via the official Web-Proxy.

At this point, your traffic is disguised as regular HTTPS web browsing. DPI firewalls cannot identify that you are using a proxy, greatly reducing the risk of being blocked.

👆 Once successfully connected, it will show "web: connected" with a blue checkmark.

Step 4: FAQ

1. Why is there no "WEB" option in my Telegram?

As mentioned above, your client version is too old. Please download the latest desktop version from the official Telegram website or join the Beta program on Google Play.

2. What to do if it says "Proxy connection failed"?

• Check if the Server field contains extra https:// or port number (Web-Proxy only needs the plain domain).
• Check if the Secret is copied completely without any extra spaces.
• Network fluctuations can occasionally cause connection failures. Try a few more times or wait a few minutes.

3. Which is better, Web-Proxy or traditional MTProto?

Web-Proxy is the latest official underlying architecture, with far superior anti-blocking capabilities compared to traditional MTProto. In regions with severe censorship like Iran and Russia, Web-Proxy survives much longer. However, for older devices that do not support this protocol, MTProto is still needed as a backup.