wa.me Link Not Working? The wa.me Format Checked Line by Line (iPhone Troubleshooting)

You put a WhatsApp link on a flyer, in an Instagram bio or at the bottom of an invoice, a customer tapped it, and something went wrong: 'this phone number is not on WhatsApp', a chat that opened with no message in it, or a web page instead of the app. The wa.me format is short enough that it is easy to assume you got it right, and strict enough that one character breaks it. This post checks the format line by line, matches each symptom to its cause, and ends with the way to make a link on an iPhone that cannot be mistyped.

If you want the general how-to first, the earlier wa.me link generator and QR guide covers the basics; this one is for when the link already exists and does not work.

The wa.me format, exactly

A click-to-chat link has two parts, and only the first is required:

https://wa.me/<number>?text=<URL-encoded message>

https://wa.me/4915112345678
https://wa.me/4915112345678?text=Hi%2C%20I%20would%20like%20to%20book%20a%20table

The number is the phone number in international format with digits only. The optional ?text= carries a pre-filled message, URL-encoded so that spaces, punctuation and emoji survive inside a URL. The older form https://api.whatsapp.com/send?phone=<number>&text=<message> still works and means the same thing; wa.me is just the short version.

The number rules:

• Country code first, then the number: 14155550142 (US), 4915112345678 (Germany), 447700900123 (UK), 919876543210 (India).
• No plus sign. +49... is how you dial; in the link it is just 49....
• No spaces, dashes, dots or brackets. +44 (0)7700 900123 becomes 447700900123.
• Drop the leading zero of the local part. The UK number above is written 07700 900123 locally; the 0 goes away once the 44 is in front. The same applies to Germany's 0151, India's 0 before a landline code, and most other countries.
• Nothing else: no tel:, no whatsapp://, no trailing slash before the ?.

Symptom: 'This phone number is not on WhatsApp' or 'invalid number'

The link opened WhatsApp, WhatsApp looked the number up, and nothing matched. Nine times out of ten the number is right and the format is wrong.

• The country code is missing. 7700900123 is not a UK number to WhatsApp; it is a number in whatever country the reader's phone thinks it is in. Add the code.
• The leading zero was kept. 4407700900123 fails. Remove the 0 after the country code.
• A plus sign got encoded. You typed +44..., something turned the plus into %2B, and the number is now %2B447700900123. Delete the plus entirely.
• A space or dash survived. Copying a number out of Contacts often brings formatting with it. Retype it as a single run of digits.
• The number really is not on WhatsApp. A landline, a number that was never registered, or a line that moved to WhatsApp Business under a different number. Test it from a second phone before blaming the link.

Symptom: the chat opens but the message is missing or cut short

The number part is fine; the text= part is not. A URL cannot contain a raw space, and several ordinary characters have special meaning inside a URL, so the message has to be encoded.

• Spaces were left as spaces. Some apps stop the link at the first space, so ?text=Hi there becomes just ?text=Hi. Spaces must be %20.
• An ampersand or a hash in the message. & starts a new parameter and # starts a fragment, so Table for 2 & a highchair #birthday loses everything after the &. Encode them as %26 and %23.
• Emoji and accented letters. These need multi-byte encoding (a thumbs-up is %F0%9F%91%8D). Hand-typed, they often come through as question marks.
• Line breaks. A two-line message needs %0A between the lines; pasting a real line break ends the link.
• Two question marks. wa.me/number?text=Hi? is fine, but wa.me/number?phone=...?text=... is not; only the first ? starts the query, and the parts are joined with &.

The fix in every case is proper URL encoding of the whole message, which is tedious by hand and is exactly what a generator is for.

Symptom: the link opens Safari instead of WhatsApp

A wa.me link is a normal https address, so on an iPhone it may first open a small WhatsApp web page with a Continue to Chat button, and only that button hands over to the app. That is normal, not a broken link. It can also happen when the person does not have WhatsApp installed (the page then offers the App Store), or when the link was tapped inside an app whose built-in browser does not hand off to other apps. If your own tests always go straight to the chat and a customer reports a web page, ask which app they tapped it from; the link itself is probably fine.

Symptom: it works for me but not for other people

Whether your number is saved in the other person's Contacts makes no difference; click-to-chat exists precisely so that it does not have to be. So the usual explanation is a typo you cannot see: you tested an earlier, correct version of the link and the one on the flyer is a different copy with a digit missing, or the link was retyped by a designer, or it was shortened by a link service that mangled the ?text= part. Open the exact link from the printed material on a phone that has never messaged you.

Symptom: the QR code will not scan

• Too small. A QR with a long pre-filled message has many more modules than a bare number and needs more physical size to stay readable. Shorten the message or print it larger.
• Low contrast. Dark code on a dark brand colour, or a pale grey code, defeats the camera. Black on white is still the safest.
• Printed from a screenshot. A screenshot is a blurry, low-resolution copy of the code; the printer enlarges the blur. Save the code as an image file at full resolution instead.
• No quiet zone. The white margin around the code is part of the code. Cropping it off, or printing it flush against text or a border, stops many scanners.

The way to make a wa.me link that cannot be wrong

Every error above is a formatting error, and the point of Chat Link & QR Code Maker is to make those impossible. You type the number with its country code in whatever shape you have it, and the app strips the plus sign, spaces, dashes and leading zeros for you. You type the message as normal text, with apostrophes, emoji and line breaks, and the app URL-encodes it so the finished link survives being pasted into a bio, an email signature or an invoice footer.

• Copy link puts the finished https://wa.me/...?text=... on the clipboard.
• Open chat hands the link to iOS so you can confirm it opens the right conversation before anyone else sees it; this is the test from the 'works for me' section, done in one tap.
• Save QR to Photos stores the code as a full-resolution PNG with no watermark, which is what fixes the screenshot and quiet-zone problems at the printing stage. The earlier post on printing a WhatsApp QR for a menu or counter covers placement and sizes.
• Profile Pic pads any photo onto a square so the whole picture fits inside the round profile circle without being cropped.

It is a $2.99 one-time purchase, runs on iOS 15.1 or later, works offline, and uploads nothing: the number and the message are built into a link on the phone and never sent to a server. There is no account and no watermark. A version for Android is on Google Play as well.

A thirty-second checklist

• Does the number start with the country code and contain only digits?
• Is the leading zero of the local number gone?
• Is there no plus sign anywhere, including an encoded %2B?
• Is every space in the message %20, every & %26, every line break %0A?
• Is there exactly one ? and does text= come straight after it?
• Did you test the exact printed link from a second phone?

If all six pass and the chat still does not open, the number is not on WhatsApp, and no link format will change that.

The apps mentioned here are independent utilities built by the author. They are not affiliated with, endorsed by, or connected to WhatsApp LLC or Meta Platforms, Inc. WhatsApp is a registered trademark of Meta Platforms, Inc.