You shared a WhatsApp link in your bio, on a flyer or in an email, and someone tells you it does not work. It opens a blank page, says the number is invalid, or the pre-filled text is garbled. The good news: almost every broken link comes down to a handful of fixable causes. This guide explains why a wa.me link is not working and how to fix it, step by step, on phones and computers.
How a wa.me link is supposed to work
A wa.me link is WhatsApp's official click-to-chat URL. The basic structure is https://wa.me/<number>, where the number is in full international format with digits only. An optional pre-filled message is added as ?text= followed by URL-encoded text, for example https://wa.me/447700900123?text=Hi%20there. When someone opens the link, WhatsApp starts a chat with that number and puts the text in the message box; nothing is sent until they tap send. WhatsApp documents the format in its Help Center article on click to chat. If you have never built one, our existing article on how to create a wa.me link covers the basics.
Quick diagnosis: symptoms and fixes
| Symptom | Most likely cause | Fix |
|---|---|---|
| "Phone number shared via URL is invalid" | Plus sign, spaces, dashes or domestic 0 in the number | Use digits only: country code + number |
| Opens chat with the wrong person | Wrong or duplicated country code | Re-check the country code |
| Pre-filled text is cut off or shows %20 or odd symbols | Text not URL-encoded, or "&" / "#" in the text | Encode the text with a link generator |
| Blank page or "Continue to chat" loop on desktop | WhatsApp Desktop not installed, browser blocks app links | Choose "use WhatsApp Web" or install the desktop app |
| Link does nothing inside Instagram or TikTok | In-app browser restrictions | Open in the phone's default browser |
| "This number isn't on WhatsApp" | No account on that number, or a typo | Test the number directly; confirm with the owner |
| Link works for you but not others | You tested from the same number, or old cached version | Test from another phone and update shared copies |
Fix 1: correct the phone number format
This is the cause in the large majority of cases. WhatsApp expects the number in E.164 international format without any symbols:
- Remove the plus sign, spaces, brackets, dots and dashes.
- Remove the domestic leading 0 that many countries use for local calls.
- Put the country code first, e.g. 44 for the UK, 33 for France, 212 for Morocco.
- Check there is only one country code.
Example: +44 (0)7700 900-123 becomes 447700900123. Our full guide to the international phone number format for WhatsApp has examples for many countries, and the WhatsApp number formatter fixes whole lists automatically.
Fix 2: encode the pre-filled message properly
Links can only contain certain characters. Spaces must become %20, line breaks %0A, and characters such as &, #, ? and emojis must be encoded too, otherwise the text is cut at that point. Typing an encoded message by hand is error-prone. Use the free wa.me link generator: type your number and message normally and it produces a correctly encoded link. Keep pre-filled messages short; very long texts are harder to read and more likely to be cut by other apps.

Fix 3: desktop and browser problems
On a computer, a wa.me link opens a WhatsApp page that tries to launch the WhatsApp Desktop app. If the app is not installed, or the browser blocks the "open app" request, you can get stuck. Options:
- Click the option to use WhatsApp Web instead, then scan the QR code to link your phone if needed.
- Allow the browser to open WhatsApp links when it asks.
- Install or update WhatsApp Desktop from the official site or your app store.
- Try another browser if an extension (ad blocker, privacy tool) is interfering.
Fix 4: links inside social apps
Instagram, TikTok, Facebook and some email apps open links in their own built-in browser, which does not always hand off to WhatsApp correctly. If a link fails there, tap the three-dot menu and choose Open in browser (or Open in Chrome / Safari). As the link owner, you can reduce the problem by using a clean wa.me link rather than a chain of redirects or shorteners. Our article on adding a WhatsApp link to your Instagram bio has more platform-specific tips.
Fix 5: the number really isn't on WhatsApp
Sometimes the link is perfect but the number has no WhatsApp account, has moved to a new number, or the account was banned. To check, open the number with the chat without saving a number tool. If WhatsApp says the number is not on WhatsApp, confirm the correct number with its owner. For businesses, make sure the number in your links is the same one registered on WhatsApp Business.
How to test a WhatsApp link properly
- Generate the link with a tool rather than typing it.
- Open it on a phone that is not using the destination number.
- Test on both Android and iPhone if possible, and once on a computer.
- Test inside the app where you will share it, e.g. Instagram.
- If it goes on print, scan the final QR code made with the QR code generator from the printed proof.
api.whatsapp.com vs wa.me: is there a difference?
Both formats are official. https://api.whatsapp.com/send?phone=447700900123&text=Hi and https://wa.me/447700900123?text=Hi lead to the same place. wa.me is shorter and easier to share, so it is usually the better choice. If an old link with api.whatsapp.com fails, the cause is almost always the number or the text encoding, not the domain itself. Avoid unofficial shorteners that hide the destination; customers and email filters trust visible official links more.
Keeping links working over time
Links break when businesses change numbers. If you move to a new number, update your website, bios, email signatures and printed materials, and consider keeping the old number active for a while with an away message pointing to the new one. Also, use links only for people to contact you; WhatsApp's Business Policy still applies to how you reply and follow up.
Key takeaways
- Most broken wa.me links have a badly formatted number: use digits only, country code first, no leading 0.
- Encode pre-filled text; use a link generator rather than writing it by hand.
- On desktop, choose WhatsApp Web or install the app; in social apps, open in the system browser.
- Test from another phone before you share or print.

