LINKMINT PRACTICAL GUIDE
WhatsApp Link Not Working? A Step-by-Step Troubleshooting Guide
Find the exact fault in a wa.me link by checking the phone number, URL encoding, account availability and the device used for testing.
Published and reviewed 5 October 2026 · By the LinkMint Editorial Team · How we test and review
A WhatsApp click-to-chat link has only two essential parts: a phone number in international format and, optionally, a URL-encoded message. When the link fails, checking those parts separately is faster than repeatedly regenerating the same URL.
Start with a clean number-only test
Make a link that contains no message: https://wa.me/COUNTRYCODEANDNUMBER. WhatsApp says the number must be written in full international format, without a plus sign, brackets, spaces or dashes. A Malaysian mobile number written locally as 012-345 6789 would normally become 60123456789: add country code 60 and remove the domestic trunk prefix. Numbering rules vary by country, so confirm the actual international number with the recipient.
Open the clean link on a phone where WhatsApp is installed. If it fails, the problem is probably the number, the WhatsApp account, or the device handoff. If it works, add the message and test again.
Read the symptom before changing anything
| What happens | Likely cause | What to check |
|---|---|---|
| WhatsApp says the number is invalid | Wrong country code, an extra zero or a number that is not active on WhatsApp | Compare the digits with the recipient's international number and ask them to confirm the account |
| The chat opens but the message is incomplete | The message was not URL encoded | Regenerate the link so spaces, ampersands, question marks and line breaks are encoded |
| A browser opens but WhatsApp does not | No compatible app, blocked handoff or an unsupported environment | Try WhatsApp Web, another browser or a phone with WhatsApp installed |
| The link works for you but not for customers | The test device already has a session or the shared link was altered | Copy the final link into a private window and test it on a second device |
Check the pre-filled message
A pre-filled message follows ?text=. Characters such as spaces, &, ?, # and line breaks have special meanings in a URL and must be encoded. LinkMint performs that encoding automatically. If you assemble links in a spreadsheet, website builder or campaign tool, make sure that system does not decode and re-encode the message incorrectly.
The customer still has to press Send. Click-to-chat opens a conversation and prepares the text; it does not send a message automatically. Keep the text short enough that a customer can review it before sending.
Test the published version
- Generate a number-only link and confirm that it opens the intended chat.
- Add the message and confirm punctuation and line breaks.
- Paste the exact published link into a private browsing window.
- Test once on mobile and once on desktop or WhatsApp Web.
- If you also publish a QR code, scan the printed sample rather than testing only the image on screen.
Do not infer that a number belongs to a business merely because a chat opens. Confirm the recipient through a trusted channel before sharing a payment request or confidential information.
Make a corrected link
Use the WhatsApp Link Generator to normalize the number and encode the message. The generator works in the browser and cannot check whether the number has an active WhatsApp account.
Primary source: WhatsApp Help Center: How to use click to chat.