What is the wa.me text parameter?

The wa.me text parameter is the optional `?text=` query string appended to a WhatsApp click-to-chat URL that pre-fills the first message in the chat window. The value must be URL-encoded — spaces become %20, line breaks become %0A. Example: `https://wa.me/15551234567?text=Hi%20I%20found%20you%20on%20your%20website` opens a WhatsApp chat with that message already typed.

What is the WhatsApp click-to-chat link format?

The click-to-chat link format is `https://wa.me/PHONENUMBER` where PHONENUMBER is the full international phone number with no `+` sign, no spaces, and no dashes. To add a pre-filled message, append `?text=URL_ENCODED_MESSAGE`. The same format works on mobile (opens WhatsApp), desktop (opens WhatsApp Web), and in QR codes.

How do I add a pre-filled message to a WhatsApp click-to-chat link?

Append `?text=` followed by your URL-encoded message. For example: `https://wa.me/15551234567?text=Hi%2C%20I%27m%20interested%20in%20your%20services`. Spaces must be encoded as %20, commas as %2C, apostrophes as %27, line breaks as %0A. Most modern URL builders or the NumSwift WhatsApp Link Generator handle the encoding automatically.

Can a wa.me link include line breaks or emojis?

Yes. Line breaks use the `%0A` URL encoding. Emojis work as long as they are URL-encoded — for example, the wave emoji 👋 becomes `%F0%9F%91%8B`. Multi-line example: `https://wa.me/15551234567?text=Hi%0AI%20saw%20your%20listing%0ACan%20we%20talk%3F` pre-fills three lines in the WhatsApp text field.

Why does my WhatsApp click-to-chat link not work?

The most common causes are including a `+` sign before the number, using spaces or dashes inside the number, or omitting the country code. The number must be digits only with the country code prefixed. Also drop any leading zero used for domestic dialling — for example a UK mobile becomes `447911123456`, not `4407911123456`.

What is the difference between wa.me and api.whatsapp.com?

Both URL formats open WhatsApp click-to-chat with the same `text` parameter behaviour. `wa.me/PHONENUMBER` is the official short format and what WhatsApp recommends. `api.whatsapp.com/send?phone=PHONENUMBER&text=MESSAGE` is the legacy long format. Either works on mobile and desktop, but `wa.me` is shorter, easier to share, and renders better in QR codes.

Do WhatsApp click-to-chat links work without saving the contact?

Yes — that is exactly what they are designed for. The recipient does not need to be in your contacts, and you do not need to be in theirs. Clicking the link opens a chat window directly. This makes wa.me links ideal for one-off conversations, customer support, and anywhere you want to message someone without first adding them to your address book.

WhatsApp wa.me Text Parameter: Click-to-Chat Link Format Guide (2026)

WhatsApp's click-to-chat feature lets anyone start a conversation with you — without saving your number first. The link format uses a simple wa.me URL, and the optional wa.me text parameter lets you pre-fill the first message before the recipient sees it. Mastering the wa.me text parameter is the difference between a generic chat link and a polished customer entry point. If you just want to send a message without saving a contact, wa.me links are the fastest way.

Here's the complete guide to the WhatsApp click-to-chat link format and the wa.me text parameter in 2026.

How wa.me Links Work

The basic format is:

https://wa.me/PHONENUMBER

Replace PHONENUMBER with the full international phone number — country code included, no + sign, no spaces, no dashes.

Example: To message the US number (555) 123-4567:

https://wa.me/15551234567

When someone clicks this link:

On mobile: WhatsApp opens with a chat to that number
On desktop: WhatsApp Web opens with the same chat
The recipient doesn't need to be in the sender's contacts

Adding a Pre-Filled Message

You can include a default message that appears in the text field when the chat opens:

https://wa.me/15551234567?text=Hi%20I%20found%20you%20on%20your%20website

The text parameter uses URL encoding — spaces become %20, and special characters need encoding too.

Common URL encodings:

| Character | Encoding | | --------- | -------- | | Space | %20 | | ! | %21 | | ? | %3F | | & | %26 | | = | %3D | | Newline | %0A |

Multi-line message example:

https://wa.me/15551234567?text=Hi%0AI%20found%20your%20listing%0ACan%20we%20talk%3F

This pre-fills:

Hi
I found your listing
Can we talk?

Common Formatting Mistakes

Wrong: Including the + sign

https://wa.me/+15551234567  ← won't work
https://wa.me/15551234567   ← correct

Wrong: Including spaces or dashes

https://wa.me/1-555-123-4567  ← won't work
https://wa.me/1 555 123 4567  ← won't work
https://wa.me/15551234567     ← correct

Wrong: Missing the country code

https://wa.me/5551234567   ← which country?
https://wa.me/15551234567  ← US (+1), correct

Wrong: Including leading zeros

Some countries use a leading zero for domestic calls that should be dropped in international format:

https://wa.me/4407911123456  ← wrong (UK with leading 0)
https://wa.me/447911123456   ← correct (UK without leading 0)

Where to Use Click-to-Chat Links

On Your Website

Add a WhatsApp button that opens a chat:

<a href="https://wa.me/15551234567?text=Hi%20I%20have%20a%20question"> Chat on WhatsApp </a>

In Email Signatures

Include a clickable WhatsApp link in your signature so recipients can message you directly.

On Social Media Profiles

Add your wa.me link to your Instagram bio, Twitter profile, or LinkedIn about section.

In QR Codes

Generate a QR code from your wa.me link. Customers can scan it to start a conversation — useful for physical stores, business cards, and flyers.

In Ads

Facebook and Instagram ads can link directly to WhatsApp conversations using wa.me links. This is often called "click-to-WhatsApp" advertising.

The wa.me/PHONE vs api.whatsapp.com Format

You'll see two URL formats used:

https://wa.me/15551234567
https://api.whatsapp.com/send?phone=15551234567

Both work, but wa.me is the official short format and is recommended. The api.whatsapp.com format also works and supports the same text parameter:

https://api.whatsapp.com/send?phone=15551234567&text=Hello

Universal Links vs. Deep Links

On mobile, wa.me links are "universal links" — they open WhatsApp directly if it's installed, or redirect to the app store if it's not. This makes them reliable for any audience.

On desktop, they open WhatsApp Web in the browser or the WhatsApp Desktop app if installed.

Generating Links Without Manual Formatting

If you deal with phone numbers regularly and don't want to manually format wa.me links each time, NumSwift can help.

Paste any text containing phone numbers, and NumSwift extracts each number with a one-click WhatsApp button — no manual formatting needed. It handles country code detection and number formatting automatically.

For dedicated link generation, the NumSwift WhatsApp Link Generator lets you enter a number and get a properly formatted wa.me link with optional pre-filled message. You can also use it to send WhatsApp to multiple numbers without saving any of them.

Business vs. Personal Use

Personal use: wa.me links work for any WhatsApp account. Share them with friends, on forums, or in marketplace listings.

Business use: WhatsApp Business accounts get additional features like business profiles, catalogs, and automated greetings — but the wa.me link format is the same. If you're using WhatsApp for business communication, check out our guide on WhatsApp message templates for pre-written messages that pair well with click-to-chat links.

Related Guides

How to send WhatsApp without saving contacts — all the methods compared, from wa.me links to one-click tools
Messaging multiple numbers without a Business account — practical approaches for reaching 10-50 people from your personal WhatsApp
Generate WhatsApp links instantly — create properly formatted wa.me links with pre-filled messages
WhatsApp Click-to-Chat for Small Business — Complete guide to WhatsApp click-to-chat for small businesses

Bottom Line

wa.me links are the simplest way to let anyone message you on WhatsApp without exchanging contacts. Format them correctly (country code, no spaces, no +), and they work everywhere — websites, emails, social media, QR codes, and ads.

For bulk number handling or when you're unsure about formatting, NumSwift generates the correct links automatically.