Nu bouwen
NL
WhatsApp click-to-chat

WhatsApp Link API: wa.me & api.whatsapp.com uitgelegd

Een WhatsApp-link is een URL, geen API. Hier vindt u de exacte formaten, de text-parameter, een gratis generator en het punt waar de link ophoudt.

Nu bouwen
Zo werkt het

WhatsApp Link API: zo werken links via wa.me en api.whatsapp.com echt

Beide openen een chat, daarna neemt een persoon het over.

  1. 1Iemand opent de URL
  2. 2WhatsApp opent de chat
  3. 3Een persoon drukt op verzenden
Definitie

Wat is een WhatsApp link API?

Een WhatsApp link API bestaat niet. https://wa.me/<number> en https://api.whatsapp.com/send?phone=<number> zijn click-to-chat-URL's. De API's beginnen waar de link ophoudt.

Een WhatsApp-link
Instellen
Niet nodig
Bij een klik
Opent een chat, vult tekst vooraf in
Wie handelt
Een mens drukt op verzenden
Een WhatsApp API
Instellen
Account koppelen en een API-sleutel
Bij een call
Verstuurt, ontvangt en toont berichten
Wie handelt
Uw software, namens het gekoppelde account
Formaat

Wat is het exacte formaat van een wa.me-link?

Het gedocumenteerde formaat is https://wa.me/<number>, met het volledige telefoonnummer in internationaal formaat.

Opbouw van de URL
https://wa.me/1XXXXXXXXXX
Host. Altijd hetzelfde.
Nummer. Eerst de landcode, alleen cijfers.
Gebruikhttps://wa.me/1XXXXXXXXXX
Niet gebruikenhttps://wa.me/+001-(XXX)XXXXXXX
Verwijder vooraf+VoorloopnulSpatiesStreepjesHaakjes

Bron: WhatsApp Helpcentrum, "How to use click to chat"

Vergelijking

Wat is het verschil tussen wa.me en api.whatsapp.com/send?

Beide openen hetzelfde gesprek. Alleen de plek van het nummer verschilt.

wa.meGedocumenteerd
https://wa.me/1XXXXXXXXXX?text=Hi

Nummer in het pad. Gedocumenteerd door WhatsApp.

api.whatsapp.com/sendNog veel gebruikt
https://api.whatsapp.com/send?phone=1XXXXXXXXXX&text=Hi

Nummer in de parameter phone. Niet terug te vinden op de huidige helppagina.

Een gat in de documentatie, geen uitfasering. Bouw nieuwe links op wa.me.

De text-parameter

Hoe voegt u een vooraf ingevuld bericht toe aan een WhatsApp-link?

Voeg ?text= en het URL-gecodeerde bericht toe: https://wa.me/<number>?text=<urlencodedtext>. De tekst blijft bewerkbaar.

Te coderen tekens
Spatie%20
Nieuwe regel%0A
&%26
#%23
+%2B

Emoji en de rest: encodeURIComponent().

Geen nummer? https://wa.me/?text=... opent de contactkiezer.

build-link.js
const number = "1XXXXXXXXXX";
const text = "Hi! I have a question.";
const link = `https://wa.me/${number}` +
  `?text=${encodeURIComponent(text)}`;
https://wa.me/1XXXXXXXXXX?text=Hi!%20I%20have%20a%20question.
Gratis tool

Genereer uw WhatsApp-link

Typ een nummer en een bericht, kopieer wat u nodig hebt.

Alleen cijfers, eerst de landcode.
Optioneel, blijft bewerkbaar.

Draait in uw browser. Er wordt geen nummer naar een server gestuurd.

wa.me-link
https://wa.me/15550123456?text=Hallo!%20Ik%20heb%20een%20vraag%20over%20uw%20product.
Equivalent via api.whatsapp.com
https://api.whatsapp.com/send?phone=15550123456&text=Hallo!%20Ik%20heb%20een%20vraag%20over%20uw%20product.
text-parameter, gecodeerd
Hallo!%20Ik%20heb%20een%20vraag%20over%20uw%20product.
HTML-snippet
<a href="https://wa.me/15550123456?text=Hallo!%20Ik%20heb%20een%20vraag%20over%20uw%20product." target="_blank" rel="noopener" aria-label="Chat on WhatsApp with 15550123456">Chat on WhatsApp</a>
Knop "Chat on WhatsApp"
<a href="https://wa.me/15550123456?text=Hallo!%20Ik%20heb%20een%20vraag%20over%20uw%20product." target="_blank" rel="noopener"><img src="whatsapp-icon.svg" alt=""> Chat on WhatsApp</a>

Een link opent een chat. Hij verstuurt niets, en uw product ziet het antwoord nooit.

Bouw wat een link niet kan
Kort antwoord

Verstuurt een WhatsApp-link het bericht?

Nee. Er wordt niets afgeleverd tot de persoon met de telefoon op verzenden drukt.

Chat geopend
Tekst vooraf ingevuld
Pas afgeleverd na een tik op verzenden
Waar de link ophoudt

Wat kan een WhatsApp-link niet?

Een click-to-chat-link is stateless: uw app komt nooit te weten wat er daarna gebeurde.

Wat de link doet
  • Link aangeklikt
  • Chat gaat open
  • Bericht vooraf ingevuld
  • Handmatig verzenden
Hier houdt de link op
Wat een API vereist
  • Antwoord ontvangen
  • Gespreksgeschiedenis
  • Webhook-event
  • Toewijzing per gebruiker
Geen afleverings- of leesstatus
Geen bijlagen
Geen trigger aan serverzijde
Faalt stil bij een nummer zonder WhatsApp
Ander gedrag per apparaat
Geen groepen, zie de limieten van de WhatsApp Group API
Bouw een echte WhatsApp-integratie
Voorbij de link

Hoe krijgt u het antwoord terug in uw app?

U hebt een API nodig die een WhatsApp-sessie aanhoudt. Er zijn twee routes.

Meta Cloud APIGeverifieerd bedrijf
  • Vereist een geverifieerd WhatsApp Business-account
  • Gefactureerd per bericht sinds 1 juli 2025, zie de prijzen van de WhatsApp Business API
  • Antwoorden binnen het 24-uursvenster: sinds 1 oktober 2026 elke maand 1.000 gratis per nummer
Gekoppeld account, UnipileGeen Business-verificatie
  • Elke eindgebruiker koppelt zijn eigen WhatsApp-account
  • Uw app handelt namens de geauthenticeerde gebruiker
  • Leest en verstuurt vanuit de echte inbox, antwoorden inbegrepen
  • Dezelfde API als voor LinkedIn, Telegram, Gmail en meer
Met Unipile
  1. 1Koppel het account via QR-code of koppelingscode
  2. 2Verstuur vanuit uw app
  3. 3Ontvang antwoorden via webhook: message_received

Bekijk de WhatsApp API van Unipile en hoe u WhatsApp-berichten via een API verstuurt. Referentie: developer.unipile.com/v1.0/docs/whatsapp.

Bouw het met Unipile
Keuze

Link, Cloud API of gekoppeld account: wat hebt u nodig?

Kies op basis van wie als eerste schrijft.

Een link

Een mens start de chat vanaf uw pagina.

Auth
Geen
Kosten
Gratis
Antwoorden
Niet zichtbaar voor uw app
Gebruik de generator hierboven
Meta Cloud API

Een geverifieerd bedrijf verstuurt templates.

Auth
Geverifieerd Meta Business-account
Kosten
Per bericht, sinds 1 juli 2025
Antwoorden
Ja, via webhook
Integratiegids voor de WhatsApp Cloud API
Gekoppeld account

Uw product werkt in de eigen inbox van elke gebruiker.

Auth
QR-code of koppelingscode
Kosten
Unipile-abonnement, niet per bericht gefactureerd
Antwoorden
Ja, via webhook
Complete gids voor de WhatsApp API
Begin met bouwen
Implementatie

Hoe bouwt u een WhatsApp-link in een product in?

Bouw hem per gebruiker op in uw templates. Hardcode nooit één nummer in een multi-tenant product.

Linktemplate
https://wa.me/{{ user.whatsapp_number }}?text={{ prefilled_text | url_encode }}
Nummer. Uit het gebruikersrecord.
Tekst. URL-gecodeerd bij het renderen.
Officiële knop

De groene "Chat on WhatsApp"-badge van WhatsApp, ongewijzigd gebruikt.

QR-code

Elke QR-generator maakt van een wa.me-link een printbare code.

Waar hij opent
Mobiel
De WhatsApp-app
Desktop, app geïnstalleerd
De desktopapp
Desktop, zonder app
WhatsApp Web
Probleemoplossing

Waarom werkt mijn WhatsApp-link niet?

Meestal: het nummerformaat of niet-gecodeerde tekst.

1 Het nummer staat niet in puur internationaal formaat
https://wa.me/+001-(XXX)XXXXXXX
https://wa.me/1XXXXXXXXXX

Oplossing: alleen cijfers, eerst de landcode.

2 De text-parameter is niet URL-gecodeerd
?text=Hi there & welcome
?text=Hi%20there%20%26%20welcome

Oplossing: encodeURIComponent() of urllib.parse.quote().

3 Geen actief WhatsApp-account

De chat faalt zonder melding.

4 Geopend in een in-app browser

Gebruik de systeembrowser.

5 Een linkvoorbeeld heeft de URL herschreven

De querystring is verloren gegaan. Test de ruwe URL.

Bouw op gekoppelde accounts

WhatsApp Link API: veelgestelde vragen

Snelle antwoorden voor developers.

Nee. wa.me en api.whatsapp.com/send zijn click-to-chat-URL's: ze openen een WhatsApp-chat, zonder authenticatie of code. De API's van WhatsApp beginnen waar de link ophoudt.

https://wa.me/<number>, waarbij <number> het volledige nummer in internationaal formaat is, zonder voorloopnullen, haakjes, spaties of streepjes. Bijvoorbeeld: https://wa.me/1XXXXXXXXXX.

Beide openen hetzelfde gesprek. wa.me/<number> is de korte vorm die in het WhatsApp Helpcentrum is gedocumenteerd, met het nummer in het pad. api.whatsapp.com/send?phone=<number> is de lange vorm, met het nummer als queryparameter.

Nee. De link opent het gesprek en kan het tekstveld vooraf invullen. Er wordt niets afgeleverd tot de persoon met de telefoon op verzenden drukt.

Ja. Voeg ?text= en een URL-gecodeerd bericht toe, bijvoorbeeld https://wa.me/1XXXXXXXXXX?text=Hi%2C%20I%20have%20a%20question. De tekst blijft bewerkbaar voor het verzenden. Probeer de generator hierboven.

Meestal staat het nummer niet in puur internationaal formaat, of is de tekst niet URL-gecodeerd. Controleer ook of het nummer op WhatsApp zit en vermijd in-app browsers.

Nee. Een link via wa.me of api.whatsapp.com/send vereist geen Business-account of API-toegang. De Cloud API is een apart, geverifieerd product. Zie de complete gids voor de WhatsApp API.

Niet met een link: die is stateless. Gebruik de Cloud API van Meta met een geverifieerd Business-account, of Unipile, waarbij elke eindgebruiker zijn eigen account koppelt via QR-code of koppelingscode en uw app handelt namens de geauthenticeerde gebruiker. Zie hoe u WhatsApp-berichten via een API verstuurt.

Link of API? Ons team helpt u kiezen.

Praat met een expert