How to use a VLESS link, and what to do when it fails

The link from the bot is a line of text with an address inside it. Put it into an app, choose a city, and use the checks below if the app refuses it.

Import, in the order that avoids most mistakes

  1. Ask the bot for the link and wait for the reply, which takes about a minute.

  2. Copy the whole message. On a phone, press and hold it in the chat; on a computer, select it. Check that the last characters survived the copy.

  3. Open the app and look for an add or import option. The wording differs between apps and versions, and it is usually something close to add from clipboard or scan a QR code.

  4. Confirm that an entry, or a list of cities, has appeared. Choose a city and press connect.

  5. Accept the VPN permission if you are on a phone, then open an ordinary page to see that it loads.

What sits inside a vless:// line

A single VLESS line has a fixed shape. The word vless comes first, then a user ID, an at sign, an address and a port. A question mark opens a run of settings, such as the transport type and the security mode, and after a hash sign comes a name that the app shows in its list. The shape is set out in a proposal in the Xray project, which calls itself a proposal that may still change, so apps follow it closely but not always identically.

Leave the parts alone. The ID is what the server uses to recognise the link, the address and port say where the server is, and the settings must match what that server expects. Change one character and the connection fails without telling you why. A subscription link is one step up: rather than one line it is an address from which the app fetches a list of lines, which is how a single link can show several cities.

When the import fails: what to look at first

  • Only part of the link was copied, because the message wrapped or a character was cut off. Copy it again from the chat in full.
  • The link was opened in a browser or another messenger instead of being pasted into the VPN app.
  • The app is an old version. Update it from the store and try again.
  • The device had no working connection while the app tried to fetch the list. On hotel or hostel Wi-Fi that wants a web login first, finish the login and retry; on mobile data, check that your allowance has not run out.
  • The term has ended. A term stops connecting after its last day, and a new one is paid for in the bot.

Before you ask for help in the bot

  • Date and time are set to automatic, since secure connections depend on a correct clock.
  • No other VPN or proxy app is switched on, because a phone runs only one at a time.
  • You have tried both mobile data and Wi-Fi, in case the trouble belongs to one network.
  • You have tried a second city from the list.
  • You have tried a second app with the same link.
  • When you do write to the bot, say which app, which network and what the app displayed.

Questions

Do I pick the city inside the app or in the link?

Inside the app. After the import it shows a list of cities, and you choose one there before pressing connect. If you want a different city later, switch within the app. The link itself stays as it is and never needs editing.

The app rejects the link. Should I edit it?

No. Copy it again from the chat in full first. If the app still refuses it, put the same link into another client from the list instead of changing characters. A hand-edited link tends to fail in ways that tell you nothing about the cause.

Do I need to keep Telegram open once the link is in the app?

No. Telegram is only where the link is issued. Once the app holds the link, the connection runs without the chat, and only paying for a new term, when you want one, takes you back to the bot.

Is the QR code the same thing as the link?

It plays the same role. A QR code writes a short piece of text as a picture so a camera can read it. The app turns what it scans into an entry just as it does with a pasted link, so use whichever is easier: scan when the link is on another screen, paste when it is on this one.

Does an iPhone need a different link from an Android phone?

No. The link has no device limit and nothing in the way you obtain it depends on the platform. What changes is the app you put it into, so an iPhone and an Android phone can sit on one link each with their own client.

Can I open the link on my phone by tapping it in the chat?

Sometimes. Some clients register themselves to open such links and some do not, and a tap that opens nothing is not a fault in the link. Copying the message and importing from the clipboard is the route to try first.

Ask the bot, paste the link, connect. Paying comes only after the free days.

Ask the Iskele bot for a link
Back to The Happ app and four other apps for your link

Your link is one message away

Ask the bot, paste the link into a free app and go. The free days let you try it on your own line before you pay anything.

Open the Iskele botopens Telegram