The problem with sharing your WhatsApp number
You want people to message you on WhatsApp without making them stop, copy your number, open the app, tap the new chat button, paste, and search. Every one of those steps loses someone. A click to chat link removes all of them. Tap it, and WhatsApp opens straight to a conversation with you, sometimes with a message already typed and waiting to send.
This guide explains exactly how the WhatsApp click to chat link works, how to build one by hand, how to pre-fill a message, how it behaves on Android, iPhone, and WhatsApp Web, and the small formatting mistakes that quietly break these links. By the end you will understand the wa.me and api.whatsapp.com formats well enough to construct a link from memory, and you will know when to reach for a generator instead.
Build a wa.me link step by step
The short form of a click to chat link uses the wa.me domain. The structure is simple:
https://wa.me/<phone number>
The number is the only thing that matters, and it has to be written in full international format. That means the country code followed by the full subscriber number, with no plus sign, no zeros used for national dialing, no spaces, no dashes, and no brackets.
Get the number format right
Say your number in the United Kingdom is 07911 123456. Written for international dialing that is +44 7911 123456. For a wa.me link you strip the plus, the spaces, and the leading zero of the national number, leaving:
https://wa.me/447911123456
A US number like (415) 555 0132 becomes https://wa.me/14155550132, where 1 is the country code. The leading zero point trips people up constantly. Many countries write local numbers with a trunk zero (the 0 in 07911). That zero is for domestic dialing only and must be dropped in the international form.
Add a pre-filled message
To open the chat with text already drafted, add a query string:
https://wa.me/447911123456?text=Hi%2C%20I%20saw%20your%20listing
The text after text= is URL encoded, which is why the space became %20 and the comma became %2C. You do not always have to encode by hand. If you paste plain text into a browser address bar it often encodes automatically, but for a link you are putting into HTML, an email, or a printed source, proper encoding is safer. This is where a WhatsApp Link Generator saves time, because it handles the encoding and the number stripping for you and gives you a clean link to copy.
The api.whatsapp.com form
There is a longer, equivalent format:
https://api.whatsapp.com/send?phone=447911123456&text=Hello
Here the number lives in a phone parameter rather than the path, and the message lives in text as before. Functionally it does the same job as wa.me. The api.whatsapp.com version is the older syntax that WhatsApp documented for businesses, and it is handy when you want an explicit named parameter for the number. If you build a lot of these, a WhatsApp API Link Builder lays out both parameters as separate fields so you are not hand assembling query strings.
You can also create a link with no number at all, https://wa.me/?text=Hello, which opens WhatsApp with the message ready and lets the user pick who to send it to. That form is useful for share buttons.
How it behaves across devices
Android and iPhone
On a phone with WhatsApp installed, tapping a wa.me link opens the app directly into the chat. If the recipient number is not yet a saved contact, WhatsApp still opens the conversation and offers to add the contact. On iPhone the behavior is the same, though iOS sometimes shows a brief confirmation before switching apps. Neither platform requires the recipient to have you saved. They only need a valid WhatsApp account tied to that number.
WhatsApp Web and desktop
On a computer, the same link opens web.whatsapp.com or the desktop app if it is installed and you are logged in. If you are not logged in, WhatsApp will show its landing page asking you to scan the QR code with your phone first. This is worth remembering when you put links on a desktop-heavy site. A visitor who has never used WhatsApp Web will hit the login screen, not a chat.
Why the format is so strict
The reason the number has to be clean is that WhatsApp treats it as a direct account identifier, not as a phone number to be dialed. There is no dialing logic to interpret a trunk zero or a local format, so anything other than country code plus subscriber number fails to resolve. The plus sign and spaces are not valid in this part of a URL path, which is why they get stripped or encoded. Understanding this is the difference between guessing and knowing why a link opens the message “The phone number shared via link is incorrect.”
Real use cases
- Support and sales. A “Message us on WhatsApp” button on your site or email signature, pre-filled with something like “Hi, I have a question about” so the customer starts halfway there.
- Marketplace listings. Sellers who put a wa.me link in a classified ad get contacted more because the buyer does not have to save a stranger’s number first.
- Print and packaging. Pair the link with a QR code on a flyer, business card, or product box. A QR Code Generator can turn any wa.me link into a scannable code, and the code simply encodes the URL as plain text, nothing more. Scanning it opens the same chat.
- Campaigns with many agents. If you route enquiries to different team numbers, generating dozens of links at once with a Bulk WhatsApp Link Generator is far faster than editing each URL by hand.
Common mistakes and how to avoid them
- Leaving the plus sign or leading zero in.
wa.me/+44...orwa.me/07911...will not resolve. Country code first, no plus, no trunk zero. - Spaces or dashes in the number. Strip everything except digits.
- Forgetting to URL encode the message. Unencoded spaces, ampersands, and hash symbols can cut your pre-filled text short or break the link.
- Assuming the recipient will see the message automatically. A pre-filled message is a draft. Nothing is sent until the user taps send. This is by design and cannot be bypassed.
- Using a landline or a number with no WhatsApp account. The link only works if that number has an active WhatsApp account.
Troubleshooting
If you see “The phone number shared via link is incorrect,” check the number format first. Ninety percent of the time it is a stray plus sign, a leading zero, or a missing country code. Copy the digits into a plain note and count them: country code plus the local number without its trunk zero.
If the link opens WhatsApp but lands on your own chat list instead of a conversation, the number likely has no WhatsApp account, or you mistyped it. If the pre-filled text appears cut off, the message was not encoded and a special character terminated it early. If a desktop visitor keeps hitting the QR login screen, that is expected WhatsApp Web behavior, not a fault in your link.
One honest limitation to set expectations around: a click to chat link starts a conversation, and that is all it does. It cannot read anyone’s messages, cannot send on their behalf, and cannot reveal whether they have you saved. If a tool claims otherwise, be skeptical.
Conclusion
A click to chat link is one of the most reliable small tools WhatsApp offers, and it is nothing more than a tidy URL with a correctly formatted number and an optional encoded message. Once you can picture the wa.me and api.whatsapp.com structures, you can build one anywhere, verify it in seconds, and fix a broken one by looking at the number. For anything beyond a link or two, let a generator handle the encoding so you can focus on where the link goes and what it says.
Frequently Asked Questions
What is a WhatsApp click to chat link?
It is a URL, usually in the form https://wa.me/<number>, that opens a WhatsApp conversation with a specific number when tapped. The recipient does not need to have you saved as a contact, and you can optionally include a pre-filled message with a ?text= parameter.
How do I format the phone number in a wa.me link?
Use full international format: the country code followed by the subscriber number, with no plus sign, no spaces, no dashes, and no trunk zero. For example +44 07911 123456 becomes 447911123456, giving https://wa.me/447911123456.
Does a pre-filled message send automatically?
No. The text added with ?text= only appears as a draft in the chat box. Nothing is sent until the recipient (or you) taps the send button. This is intentional and cannot be bypassed by any link.
Why does my WhatsApp link say the phone number is incorrect?
Almost always a formatting issue: a leftover plus sign, a leading zero from the national number, spaces or dashes, or a missing country code. Strip the number down to country code plus local digits only. The number must also belong to an active WhatsApp account.
What is the difference between wa.me and api.whatsapp.com?
They do the same thing. wa.me is the short form (https://wa.me/number?text=hi), while api.whatsapp.com/send?phone=number&text=hi is the longer form with named parameters. Both open a chat with an optional pre-filled message.
