LinkedIn
Instagram
Telegram
Gmail
Outlook
Google Agenda
Word lid van de Slack-gemeenschap Inhoudsopgave
De Link
Bouw een link
Voorbij de Link
WhatsApp Klik-om-te-Chat-links
WhatsApp Link API: Hoe wa.me en api.whatsapp.com Links Werken Daadwerkelijk
Een WhatsApp-link is een URL, geen API. Deze gids geeft je de exacte wa.me en api.whatsapp.com/send formatten, de text parameter, een gratis generator, en het punt waar de link ophoudt en een daadwerkelijke integratie moet beginnen.
7 dagen gratis op proef, geen creditcard vereist
Gewoon een URL
Geen authenticatie, geen code
Hallo! Ik heb een vraag over jullie product.
Opent de chat. Een mens moet nog steeds op verzenden drukken.
Definitie
Wat is een WhatsApp-link-API?
Er is geen WhatsApp-link-API.
https://wa.me/<number> en https://api.whatsapp.com/send?phone=<number> zijn click-to-chat-URL's: als je erop klikt, wordt er een gesprek geopend in WhatsApp. Ze vereisen geen authenticatie, geen ontwikkelaarsaccount en geen code. De WhatsApp-api's vormen een aparte laag en beginnen precies waar de link ophoudt.Criterium
Een WhatsApp-link
Een WhatsApp-API
Formaat
KoppelingEen URL die je overal kunt plakken
APIEen geauthenticeerd HTTP-eindpunt
Setup
KoppelingGeen. Het werkt onmiddellijk
APIAccountkoppeling, een API-sleutel, een clientbibliotheek
Wat gebeurt er bij een klik / oproep
KoppelingOpent een chat en kan een tekstveld vooraf invullen
APIVerstuurt, ontvangt en lijst berichten programmatisch
Wie acteert
KoppelingEen mens drukt op verzenden
APIUw software handelt namens het gekoppelde account
Formaat
Wat is de exacte wa.me-linkindeling?
Het gedocumenteerde formaat is
https://wa.me/<number>, waar <number> is een volledig telefoonnummer in internationaal formaat. Het Helpcentrum van WhatsApp stelt dat je alle nullen, haakjes of streepjes moet weglaten.Gebruik: https://wa.me/1XXXXXXXXXX
Niet gebruiken: https://wa.me/+001-(XXX)XXXXXXX Wat te behouden
Landcode plus abonneenummer, uitsluitend cijfers. Geen leidende
+. Wat te strippen
Voorloopnullen, spaties, streepjes, haakjes. Geen enkele daarvan hoort thuis in het pad.
Vergelijking
Wat is het verschil tussen wa.me en api.whatsapp.com/send?
Beide openen dezelfde conversatie.
wa.me/ staat de korte vorm gedocumenteerd in het Helpcentrum van WhatsApp, met het nummer in het pad. api.whatsapp.com/send?phone= is de lange vorm, die het nummer als queryparameter meedraagt, nog steeds veel in gebruik.URL-anatomie, segment voor segment
https://wa.me/1XXXXXXXXXXHoi
https://api.whatsapp.comverzenden?phone=1XXXXXXXXXXHoi
Gastheer
Vast pad
Het nummer
Het bericht
Criterium
wa.me
api.whatsapp.com/send
Waar het nummer woont
wa.meIn het URL-pad
api.whatsapp.comIn de
telefoon queryparameterVastgelegd in het Helpcentrum van WhatsApp
wa.meJa, dit exacte formaat
api.whatsapp.comNiet te vinden op de huidige hulppagina
Waargenomen gedrag
wa.meOpent de chat
api.whatsapp.comOpent dezelfde chat
Een documentatiehiaat, geen afschaffing. We konden geen actuele, officiële WhatsApp- of Meta-pagina vinden die gedocumenteerd staat
api.whatsapp.com/send. Dat betekent niet dat het is gestopt met werken: beide formaten leiden vandaag de dag door naar hetzelfde gesprek. Het betekent dat het eigen Helpcentrum van WhatsApp alleen behandelt wa.me. Bouw nieuwe links op basis van het gedocumenteerde formaat.De tekstparameter
Hoe voeg je een vooraf ingevuld bericht toe aan een WhatsApp-link?
Toevoegen
?text= gevolgd door het URL-gecodeerde bericht: https://wa.me/<number>?text=<urlencodedtext>. De tekst verschijnt in het chat-invoerveld, vooraf ingevuld en bewerkbaar.https://wa.me/1XXXXXXXXXX?text=Ikbengeïnteresseerdinuwautodietekoopstaat// geen nummer: opent in plaats daarvan een contactenkiezerhttps://wa.me/?text=I'minquiringabouttheapartmentlisting Zonder nummer opent WhatsApp de contactenlijst van de afzender in plaats van een specifieke chat.
Codering, de bepaalde mappings text vult nog steeds automatisch in zodra er een contactpersoon is geselecteerd. Karakter
Ruimte
Nieuwe regel
&
#
Gecodeerd als
%20
%0A
%26
%23
Ook het vermelden waard:
Bouw de link in de code + codeert naar %2B. Voor al het andere, inclusief emoji's, moet je de tabel niet zelf bouwen: roep encodeURIComponent() in JavaScript of urllib.parse.quote() in Python. // JavaScriptconst number = "1XXXXXXXXXX";
const text = "Hi! I have a question.";
const link = `https://wa.me/${number}?text=${encodeURIComponent(text)}`;# Pythonfrom urllib.parse import quote
number, text = "1XXXXXXXXXX", "Hallo! Ik heb een vraag."
link = f"https://wa.me/{number}?text={quote(text)}"Gratis hulpmiddel
Genereer uw WhatsApp-link
Voer een getal en een bericht in. Ontvang de wa.me de link api.whatsapp.com equivalent, de gecodeerde tekst, een HTML-fragment en de officiële knop, allemaal tegelijk.
Werkt volledig in je browser. Er wordt nooit een nummer naar een server verzonden.
Volledig internationaal nummer. Geen +, geen 0, geen spaties of streepjes.
Optioneel. Komt in het chat-invoerveld te staan, en kan nog steeds door de afzender worden bewerkt.
wa.me-link
https://wa.me/15550123456?text=Hi!%20I%20have%20a%20question%20about%20your%20product.
wa.me
https://api.whatsapp.com/send?phone=15550123456&text=Hi!%20I%20have%20a%20question%20about%20your%20product.
tekstparameter, gecodeerd
Hoi! Ik heb een vraag over jullie product.
HTML-fragment, klaar om te plakken
<a href="https://wa.me/15550123456?text=Hi!%20I%20have%20a%20question%20about%20your%20product." target="_blank" rel="noopener" aria-label="Chat op WhatsApp">Chat op WhatsApp</a>
Officiële "Chat op WhatsApp"-knop
Chat op WhatsApp <a href="https://wa.me/15550123456?text=Hi!%20I%20have%20a%20question%20about%20your%20product." target="_blank" rel="noopener"><img src="whatsapp-icon.svg" alt=""> Chat op WhatsApp</a>
Deze link opent een chat. Hiermee wordt het bericht niet verzonden en uw product ziet het antwoord niet.
Stuurt een WhatsApp-link het bericht direct?
Nee. Een klik-om-te-chat-link opent het gesprek en vult het tekstveld vooraf in. Er wordt niets verzonden voordat degene die de telefoon vasthoudt op verzenden drukt.
Het eerlijke deel
Wat kan een WhatsApp-link niet doen?
Een ‘click-to-chat’-link is stateless. Je product weet nooit of er op de link is geklikt, of het bericht is verzonden of dat de ontvanger heeft gereageerd.
Waar de schakel stopt
Link geklikt
Chat wordt geopend
Bericht vooraf ingevuld
Handmatig verzenden
Koppelingstopthier
Antwoord ontvangen
Conversatiegeschiedenis
Webhook-gebeurtenis
Toeschrijving per gebruiker
Geen bezorg- of leesbevestiging
Geen antwoord teruggestuurd naar uw applicatie
Geen gespreksgeschiedenis
Geen bijlagen
Geen server-side trigger. Er is een mens en een klik voor nodig
Geen toeschrijving per gebruiker in een product met meerdere tenants
Stille mislukking als het nummer geen actief WhatsApp-account heeft
Ander gedrag op desktop, WhatsApp Web en mobiel
Geen groepscreatie of -beheer. Een link opent alleen een één-op-één-chat, zie de WhatsApp Groeps-API limieten voor alles wat met groepen te maken heeft
Een link kan geen klikken, antwoorden of geschiedenis rapporteren. Een API kan dat wel. Bouw een echte WhatsApp-integratie
Plak de link
Hoe krijg je het antwoord weer terug in je app?
Je hebt een API nodig die een WhatsApp-sessie vasthoudt. Er bestaan twee routes: Meta's Cloud-API, waarvoor een geverifieerd Bedrijfsaccount is vereist, of een connected-account API zoals Unipile, waarbij de eindgebruiker zijn eigen WhatsApp-account koppelt namens de geauthenticeerde gebruiker, via een QR-code of koppelingscode.
Meta Cloud APIGeverifieerd bedrijf
Vereist een geverifieerd WhatsApp Business-account
Gefactureerd per bericht sinds 1 juli 2025, zie de WhatsApp Zakelijke API-prijzen uitsplitsing
Het 24-uurs klantenservicevenster bestaat nog steeds, het bepaalt wat gratis is, niet wat er in rekening wordt gebracht
Ontworpen voor getransableerde meldingen op grote schaal
Gekoppeld account, UnipileGeen verificatie
Elke eindgebruiker koppelt zijn of haar eigen WhatsApp-account, namens de geauthenticeerde gebruiker
Via QR-code of koppelingscode, geen Meta Business-verificatie
Leest en verzendt vanuit de daadwerkelijk gekoppelde inbox, inclusief antwoorden
Hetzelfde connect-, send-, list-, listen-patroon als LinkedIn, Instagram, Telegram, Gmail, Outlook en IMAP
// 1. Koppel het account namens de geauthenticeerde gebruiker
const { qrCodeString } = wacht op account van de cliënt.VerbindWhatsapp();// 2. Verstuur een bericht zodra gekoppeld
POST /api/v1/chats/{chat_id}/messages{ "tekst": "Hoi! Uw bestelling is verzonden." }// 3. Ontvang antwoorden via een webhook, geen polling{ "gebeurtenis": "bericht_ontvangen", "chat_id": "chat_182...", "bericht": "Is dit nog beschikbaar?"}Voor de volledige verzendhandleiding, payloads en webhook-afhandeling, zie hoe je WhatsApp-berichten via de API verzendt. Eindpuntreferentie: developer.unipile.com/docs/whatsapp.
Beslissing
Link, Cloud API of verbonden account: welke heb je nodig?
Gebruik een link wanneer een mens het gesprek initieert vanaf een pagina die u beheert. Gebruik de Cloud API wanneer een geverifieerd bedrijf getemplateerde meldingen op schaal verzendt. Gebruik een API voor gekoppelde accounts wanneer uw product moet lezen en verzenden vanuit de eigen WhatsApp-inbox van de gebruiker.
Criterium
Koppeling
Meta Cloud API
Gekoppelde account
Wie initieert
KoppelingEen mens, van een pagina die je beheert
Cloud APIJe bedrijf stuurt als eerste, een sjabloon
Gekoppelde accountAan beide kanten, vanuit de gekoppelde inbox
Auth vereist
KoppelingNiets
Cloud APIGeverifieerd Meta Business-account
Gekoppelde accountQR-code of koppelingscode, geen bedrijfsverificatie
Kosten
KoppelingGratis
Cloud APIPer bericht, sinds 1 juli 2025
Gekoppelde accountUnipile abonnementsprijzen, niet gefactureerd per bericht
Ontvangt antwoorden
KoppelingGeen
Cloud APIJa, via webhook
Gekoppelde accountJa, via webhook
Conversatiegeschiedenis
KoppelingGeen
Cloud APIJa
Gekoppelde accountJa
Multi-tenant producten
KoppelingOnderbrekingen, één vastgecodeerd getal
Cloud APIVereist aangepaste routering per bedrijfsnummer
Gekoppelde accountNative, één gekoppeld account per eindgebruiker
Installatietijd
KoppelingNotulen
Cloud APIDagen tot weken, Bedrijfsverificatie
Gekoppelde accountMinuten naar uren
Ik heb alleen een link nodig
Gebruik de generator hierboven. Geen account, geen installatie.
Het verzenden van meldingen op basis van sjablonen
Zie de WhatsApp Cloud API-integratie gids.
Lezen en versturen per gebruiker
Begin met de complete WhatsApp API-gids.
De meeste producten groeien binnen een week uit de link. Begin waar je uiteindelijk toch zult eindigen. Beginnen met bouwen
Implementatie
Hoe sluit je een WhatsApp-link in een product in?
Genereer de link server-side, per gebruiker, en hardcode nooit een telefoonnummer in een multi-tenant product. De link is slechts een anker, dus deze hoort in je templatelaag thuis, niet in je API-laag.
<a href="https://wa.me/{{ user.whatsapp_number }}?text={{ prefilled_text | url_encode }}"
doelwit="_blank" relatie="noopener"
aria-label="Chat op WhatsApp"Chat op WhatsAppa>Officiële knop
WhatsApp publiceert een kant-en-klare "Chat op WhatsApp"-badge, groen-wit, in enkele vaste formaten, bedoeld om zonder wijzigingen te worden gebruikt.
Chat op WhatsApp QR-code
Elke QR-codegenerator die een URL accepteert, verandert een
wa.me link naar een scanbare code voor print, verpakking of fysieke bewegwijzering. Mobiel Opent de WhatsApp-app direct, met de chat en de vooraf ingevulde tekst gereed.
Bureaublad, app geïnstalleerd Opent de WhatsApp-bureaubladapp in plaats van de browser.
Desktop, geen app Opent WhatsApp Web in de browser en vraagt om een QR-inlog als de sessie nog niet actief is.
Waarom de link breekt in multi-tenant producten: een enkel hardcoded nummer kan je klanten niet uit elkaar houden. Genereer de link elke keer vanuit de specifieke gebruiker- of workspacerecord, zodat deze het nummer bevat dat die gebruiker daadwerkelijk bezit, en niet een nummer dat ooit in een sjabloon is geplakt.
Probleemoplossing
Waarom werkt mijn WhatsApp-link niet?
De twee meest voorkomende oorzaken zijn een telefoonnummer dat niet in de standaard internationale indeling staat, en een
text parameter die niet als URL was gecodeerd.OorzaakTelefoonnummer niet in standaard internationaal formaat
RepareerGebruik het volledige internationale nummer, alleen cijfers: nee
+, geen leidende 0, geen spaties, streepjes of haakjes.OorzaakDe tekstparameter was niet URL-gecodeerd
RepareerStuur het bericht door
encodeURIComponent() in JavaScript of urllib.parse.quote() in Python voordat je het toevoegt.OorzaakHet nummer heeft geen actief WhatsApp-account
RepareerDe link wordt nog steeds geopend, maar de chat faalt geruisloos. Verifieer eerst of het nummer daadwerkelijk is geregistreerd op WhatsApp.
OorzaakGeopend in de in-app browser van een app van een derde partij
RepareerIn-app browsers van sociale of advertentieplatforms blokkeren of verwerken de doorverwijzing soms onjuist. Open de link in plaats daarvan in de systeembrowser.
OorzaakEen linkpreview-crawler heeft de URL herschreven
RepareerSommige platforms verpakken uitgaande links in hun eigen omleiding, waardoor de query-string verloren kan gaan. Test de onbewerkte
wa.me URL direct.WhatsApp Link API - FAQ
Alles wat ontwikkelaars vragen over wa.me, api.whatsapp.com, de tekstparameter en waar de link ophoudt.
Er bestaat geen enkele WhatsApp-link-API. wa.me en api.whatsapp.com/send zijn click-to-chat-URL's: het openen hiervan start een gesprek in WhatsApp, zonder dat er authenticatie, een ontwikkelaarsaccount of code voor nodig is. De eigen API's van WhatsApp zijn een aparte laag die precies begint waar de link stopt, zodra een persoon moet reageren.
Het gedocumenteerde formaat is https://wa.me/<number>, waar <number> is het volledige telefoonnummer in internationaal formaat. Het Helpcentrum van WhatsApp instructeert om eventuele voorloopnullen, haakjes, spaties of streepjes weglaten, bijvoorbeeld https://wa.me/1XXXXXXXXXX.
Beide openen dezelfde conversatie. wa.me/ staat de korte vorm gedocumenteerd in het Helpcentrum van WhatsApp, met het nummer in het URL-pad. api.whatsapp.com/send?phone= wordt de lange vorm, die het nummer in plaats daarvan als queryparameter meedraagt, nog steeds veel gebruikt.
Nee. Een click-to-chat-link opent het gesprek en kan het tekstveld vooraf invullen, maar er wordt niets verzonden totdat de persoon met de telefoon op verzenden drukt.
Ja. Toevoegen ?text= gevolgd door een URL-gecodeerd bericht, bijvoorbeeld https://wa.me/1XXXXXXXXXX?text=Hi%2C%20I%20have%20a%20question. De tekst belandt in het chatinvoerveld, vooraf ingevuld en nog bewerkbaar voordat deze wordt verzonden. Probeer het in de generator hierboven.
De twee meest voorkomende oorzaken zijn een telefoonnummer dat niet in de standaard internationale indeling staat en een text parameter die niet URL-gecodeerd was. Controleer ook of het nummer een actief WhatsApp-account heeft en of de link niet werd geopend in de in-app browser van een app van derden.
Nee. A wa.me of api.whatsapp.com/send link vereist geen zakelijk account, geen verificatie en geen API-toegang. Het WhatsApp Business Platform, of Cloud API, is een afzonderlijk geverifieerd product voor bedrijven die op grote schaal sjabloonmeldingen moeten verzenden of programmatisch antwoorden moeten ontvangen. Zie de complete WhatsApp API-gids.
Een link zelf kan geen antwoorden terugrapporteren aan je app, deze is stateless. Om te lezen en te verzenden vanuit een daadwerkelijke inbox heb je een API nodig die een WhatsApp-sessie vasthoudt: ofwel de Cloud API van Meta met een geverifieerd bedrijfsaccount, ofwel een connected-account API zoals Unipile, waarbij elke eindgebruiker zijn eigen WhatsApp-account koppelt namens de geauthenticeerde gebruiker, via een QR-code of koppelingscode. Zie hoe je WhatsApp-berichten via de API verzendt.
Weet je nog steeds niet zeker of je een link of een API nodig hebt? Ons team kan je helpen beslissen.
NL 
EN 
FR 
ES 
DE 
IT 
BR 
PL 
TR