WhatsApp API Link Builder

Start a WhatsApp chat from any link, no saved contact required

A WhatsApp API link (often called a click-to-chat link) is a plain web URL that opens a conversation with a specific phone number the moment someone taps it. No one has to save your number first, dig through the app, or copy anything. The WhatsApp API Link Builder turns a phone number and an optional prefilled message into a ready-to-share link in the exact format WhatsApp expects, using either the short wa.me domain or the longer api.whatsapp.com/send endpoint.

This tool is built for anyone who wants people to reach them on WhatsApp with one tap: a freelancer adding a chat button to a portfolio, a shop putting a “Message us on WhatsApp” link in an Instagram bio, a support team pasting a link into an email signature, or a developer wiring a contact button into a website. Everything runs in your browser. You type the number, the tool assembles and URL-encodes the link, and you copy it. Nothing is sent to a server.

How the WhatsApp API Link Builder actually works

WhatsApp exposes two public URL patterns for opening a chat. The first is the short form, https://wa.me/<number>. The second is the equivalent long form, https://api.whatsapp.com/send?phone=<number>. Both do the same thing: on a phone they open the WhatsApp app on that conversation, and on a computer they open WhatsApp Web or the desktop app. This builder produces whichever style you prefer, and both behave identically for the person clicking.

The phone number has to be in full international format

This is the single detail that trips up most people. The number in a WhatsApp link must be written in full international format with the country code, and with nothing else attached. That means no plus sign, no leading zeros, no spaces, no brackets, and no dashes. A United Kingdom mobile written locally as 07911 123456 becomes 447911123456. A United States number shown as (415) 555-2671 becomes 14155552671. The builder strips out the common punctuation for you and shows the cleaned digits, but the country code is on you to include, because there is no reliable way to guess it from a bare local number.

The prefilled message is URL-encoded, not sent automatically

You can attach a message that appears already typed in the chat box using the text parameter: https://wa.me/14155552671?text=Hi%20there. A prefilled message is a convenience, not an auto-send. WhatsApp drops the text into the input field, and the person still has to press send themselves, which keeps them in control of the conversation. Because a message can contain spaces, emoji, line breaks, and symbols that are not URL-safe, the tool percent-encodes it for you. A space becomes %20, a line break becomes %0A, and so on. If you were to paste raw text with spaces straight into a URL, some apps would silently truncate the message at the first space, which is exactly the kind of breakage this encoding prevents.

Number-only links versus message links

If you leave the message blank, the link simply opens an empty chat, which is what you want for a general “contact me” button. Add a message and you can steer the conversation from the first tap, for example prefilling an order reference, a product name, or a greeting in the reader’s language. Both variants are valid and the builder handles either.

Real ways people use a WhatsApp click-to-chat link

The most common use is a contact button on a website or landing page. Instead of publishing your raw number, you link the button to your wa.me URL so a visitor goes straight into a chat. Social profiles are the next big one: Instagram, TikTok, and X allow a single link in the bio, and pointing that link at WhatsApp turns casual followers into direct messages.

Small businesses lean on prefilled messages heavily. A bakery can share wa.me/447911123456?text=I%27d%20like%20to%20order%20a%20cake so every enquiry lands with a clear subject, and staff can reply faster because they already know why the person is writing. Support and sales teams paste click-to-chat links into email signatures and PDF invoices, letting a customer switch from reading to chatting without hunting for a number. Event organisers add them to printed flyers as a QR code that encodes the same link, so a scan opens WhatsApp with the event name already in the box.

There is also a quieter personal use: messaging a number you do not want to save. If a taxi driver or a marketplace seller gives you a one-time number, a click-to-chat link lets you write to them without adding a permanent contact to your phone.

Best practices for links people will actually click

Test every link on both a phone and a desktop before you publish it, because the two open different WhatsApp surfaces and it is easy to assume a link works when you have only tried one. Keep prefilled messages short and genuinely useful; a single line that identifies the topic beats a paragraph the reader has to delete. When your audience spans languages, write the prefilled text in the language they read, since it is the first thing they see. If you are printing the link, generate a QR code from the finished URL rather than asking anyone to type a long address by hand. And when you share the raw link in text, the short wa.me form looks cleaner and is less likely to get mangled by link previews than the long api.whatsapp.com version.

Common mistakes and how to avoid them

Leaving in a leading zero is the classic error. Local dialing formats often start with a 0, but international format replaces that 0 with the country code, so 07911... must become 4479 11... and never 4407911.... Including the plus sign or a “00” international prefix breaks the link the same way; the number is just digits, starting with the country code. Spaces, dashes, and brackets copied from a contact card will also stop the link resolving, which is why the builder cleans them out.

Another frequent slip is pasting an unencoded message directly into a URL. Spaces and special characters need percent-encoding, and skipping that step is how messages arrive cut off. Finally, remember that a prefilled message never sends by itself, so do not design a flow that assumes the customer’s first message is guaranteed; treat it as a helpful draft they can edit.

Troubleshooting WhatsApp links that will not open

If tapping your link shows “The phone number shared via link is not on WhatsApp” or “Phone number is invalid,” the number is almost always the problem rather than the link format. Confirm the country code is present, drop any leading zero, and remove every space and symbol so only digits remain. It is also worth checking that the number actually has an active WhatsApp account, because a valid-looking number with no WhatsApp will still fail.

When the message does not prefill, the usual cause is missing or broken URL encoding on the text value, so regenerate the link with the builder rather than hand-editing it. If the link opens WhatsApp Web on a computer but nothing happens, make sure you are logged into WhatsApp Web or have the desktop app installed, since click-to-chat needs a signed-in session to open the conversation. On a phone where the link opens a browser page instead of the app, confirm WhatsApp is installed and set to handle its own links. And if a shortened or tracked version of your link fails while the plain one works, the shortener is likely stripping the ?text= query string, so link to the full URL directly.

One limitation to keep in mind: this is only for opening chats. There is no public WhatsApp URL that pulls someone’s profile photo, About text, or status, and click-to-chat cannot pre-select a group or send on the user’s behalf. Anyone claiming otherwise is describing something WhatsApp does not offer.