WhatsApp click-to-chat links for your business

A wa.me link opens a chat with your number in one tap, with an opening message already typed in. This guide covers the correct format, the number mistakes that break most links, and how to use the link on printed material.

Updated

The official wa.me format

According to WhatsApp's Help Center, a click-to-chat link has the form https://wa.me/<number>, where the number is a full phone number in international format. Leave out any zeroes, brackets or dashes. WhatsApp's own example of a correct link is https://wa.me/1XXXXXXXXXX and of a wrong one https://wa.me/+001-(XXX)XXXXXXX, so the plus sign goes too. The link works on phones and on WhatsApp Web, as long as the number has an active WhatsApp account. Customers don't need to save your number first.

Writing the number in international format

International format is the country calling code followed by the number without its domestic trunk prefix. In the UK, Australia and Indonesia that prefix is the leading 0 you dial at home. The US and Canada have no leading 0; their country code is 1, which is why WhatsApp's example starts with a 1 followed by ten digits. The whole number can be at most 15 digits (the E.164 standard).

CountryDialed locallyIn the link
US, Canada (+1)(201) 555-012312015550123
UK (+44)07700 900123447700900123
Australia (+61)0491 570 15661491570156
Indonesia (+62)0812-3456-78906281234567890

Two mistakes cause most broken links. Keeping the trunk 0 after the country code (4407700900123) produces a number that doesn't exist. Dropping the country code (7700900123) makes WhatsApp read the first digits as a country code: 7 is Russia and Kazakhstan, so the chat goes nowhere or to a stranger.

Pre-filled messages and URL encoding

A message is added with ?text=, and WhatsApp requires the text to be URL-encoded: every character with a special meaning in a web address is replaced by a percent code. The message only appears in the text field; the customer can still edit it and has to press send.

CharacterEncodedIf left as is
space%20Link breaks when pasted
line break%0ALink breaks
&%26Rest becomes another parameter
#%23Rest of the message is lost
+%2BMay be read as a space

The message "Hi, is the 2+1 deal still on? I saw #spring on Instagram & want 2 sets" becomes:

https://wa.me/447700900123?text=Hi%2C%20
is%20the%202%2B1%20deal%20still%20on%3F
%20I%20saw%20%23spring%20on%20Instagram
%20%26%20want%202%20sets

The link is split over four lines here to fit; the real one is a single line with no spaces. Unencoded, the message would stop before the #, because everything after it is treated as a page anchor, and the + might turn into a space. Letters such as é take two bytes in UTF-8 and become six characters (%C3%A9); an emoji takes four bytes and becomes twelve.

A different message for each channel

The opening message can double as a source tag. Use a different link in each place: "Hi, I found you on Instagram" in your bio, "Hi, I picked up your flyer" on the flyer's QR code. When chats arrive, you can see which channel brings in questions. Customers can delete or change the text, so treat the counts as estimates.

A message that names the product saves a round of questions. The QR code on a bag of coffee can carry "Hi, I'd like to reorder HB-250", so whoever answers knows the item without asking for a photo. On a product page button, name the product and its variant. Anything longer than one sentence is rarely needed; customers add the details themselves.

Where to put the link

  • Social media bios. One link in your Instagram or TikTok bio. If several staff numbers answer chats, give each its own link so conversations don't get split.
  • Your website or online store. A "Message us on WhatsApp" button on product pages, with a message that names the product.
  • Email and PDFs. Email signatures, catalogs and quotes; links in a PDF can be tapped on a phone.

A QR code for printed material

On flyers, packaging, receipts or a shop window, the link becomes a QR code, and the message length decides how dense it gets. At error correction level M, a UK number with no message (26 characters) gives a version 2 code, 25 × 25 modules. With "Hi, I saw your flyer" (62 characters) it is version 4, 33 modules. A 73-letter question makes a 139-character link and a version 8 code, 49 modules. Printed 1 inch (2.54 cm) wide, a module is 0.77 mm at version 4 and only 0.52 mm at version 8, which is much harder to scan from a small card. Keep messages for print short. The WiFi QR code guide covers module width and scanning distance in more detail.

The number inside a printed code can't be changed later. If your business number might change, consider a QR code that points to a page on your website and put the WhatsApp link on that page.

Making the link and QR code on swift.id

  1. Open the WhatsApp Link Generator. Set the Country code box (it starts at 1) and type the number as you would dial it locally. A trunk 0 is removed for you. To use another country code, start the number with + or 00.
  2. Write the Opening message. WhatsApp formatting such as *bold* and _italic_ carries over, and so do line breaks. URL encoding is done for you.
  3. Check the line under the number, for example "Read as +44 7700900123", then press Try it to confirm the chat opens to the right number, and Copy link.
  4. For print, press Download QR code (PNG). You get a 1024-pixel PNG at error correction level M.
  5. For banners or a print shop, paste the same link into the QR Code Generator under Link / Text, then download an SVG or raise the error correction.

Questions

Is the pre-filled message sent automatically?
No. WhatsApp only places it in the chat's text field. The customer can edit it and still has to press send.
Why does the link say the number isn't on WhatsApp?
The number is written wrong, usually with the trunk 0 kept after the country code or with the country code missing, or the number has no active WhatsApp account. Compare the number in the link with the table above.
Can I make a link without a number?
Yes. https://wa.me/?text=… carries only the message; when it opens, the person picks who to send it to. That suits a "share with a friend" button, not taking orders.
Do wa.me links expire?
The link contains your number directly, so it keeps working as long as that number is active on WhatsApp. If you change numbers, every link and printed QR code has to be replaced.