Every broken WhatsApp link fails for the same reason: the phone number is in the wrong format. The rules are simple once you see them.
The one rule: E.164 without the plus
WhatsApp expects the number in E.164 international format, minus the leading +. That means:
- Country code first, no plus sign. Israel =
972, US =1, UK =44. - National number after, with no leading zero.
- No spaces, dashes, parentheses, or dots.
Concrete: the Israeli mobile 054-123-4567 becomes 972541234567. The London landline 020 7946 0958 becomes 442079460958. The New York number (212) 555-1234 becomes 12125551234.
Common mistakes and fixes
| Wrong | Right | Why |
|---|---|---|
| +972541234567 | 972541234567 | The + breaks the URL |
| 0541234567 | 972541234567 | Missing country code, leading 0 not stripped |
| 972-54-123-4567 | 972541234567 | Dashes break the format |
| 972 54 123 4567 | 972541234567 | Spaces need to be removed |
| 00972541234567 | 972541234567 | 00 is an international dial prefix, not part of the number |
Handling the leading zero (the #1 gotcha)
Most countries use a leading 0 when dialing locally. That zero is NOT part of the international number. You strip it and prepend the country code.
- Israel local:
054-...β strip0, prepend972β97254... - UK local:
0207 ...β strip0, prepend44β44207 ... - Germany local:
0176 ...β strip0, prepend49β49176...
Exception: North America (US, Canada, Caribbean). These use area codes with no leading zero. (212) 555-1234 β 12125551234 (country 1 + full 10-digit number).
Countries where the "national" number is fully local
A few countries have national numbers so short you might think you're missing digits:
- Denmark, Norway, Iceland: 8-digit national numbers, no leading zero to strip.
- Hong Kong: 8-digit national numbers.
- Singapore: 8-digit national numbers.
Just prepend the country code as-is.
The message part (?text=)
The URL query ?text=hello pre-fills the chat input. Text must be URL-encoded β spaces become %20 (or +), and non-ASCII characters get encoded as UTF-8 bytes.
hello worldβhello%20worldΧ©ΧΧΧβ%D7%A9%D7%9C%D7%95%D7%9D- Emoji π β
%F0%9F%91%8B
The encoded form looks ugly but WhatsApp decodes it perfectly. The customer sees "Χ©ΧΧΧ" in the chat, not the encoded gibberish.
Our generator handles all encoding for you β just type your message.
Troubleshooting a broken link
If your link doesn't open a chat, check in order:
- Country code present? No
+, no00, just the digits. - Leading zero stripped?
0after country code is almost always wrong. - Only digits in the number part? Copy-paste the URL into a text editor to hunt spaces or invisible characters.
- The number has an active WhatsApp account?
wa.me/12125551234will open a "start chat" page even for numbers without WhatsApp β the recipient just can't reply. - URL-encoded the message? If your text has special characters and you built the URL by hand, they need encoding.
Or just use a tool that handles it correctly: our free WhatsApp link generator does all of the above and shows you the working URL immediately.