WhatsApp Business API #

Verbind uw bedrijf met WhatsApp via de officiële WhatsApp Business API. Dit kanaal is de aanbevolen keuze voor bedrijven die betrouwbare WhatsApp-berichten met een hoog volume nodig hebben, inclusief vooraf goedgekeurde berichtsjablonen en bezorgingsregistratie.

Geen apart Twilio-account nodig. Twilio is de telefoon- en berichtenservice die achter de schermen je WhatsApp-berichten verstuurt. Het platform maakt automatisch een beheerd Twilio-account voor je aan, dus je hoeft je niet zelf bij Twilio aan te melden of het handmatig aan Meta te koppelen. Het kopen van een nummer of het koppelen van een bestaand nummer gebeurt volledig in de app. Als je specifiek je eigen Twilio-account wilt gebruiken (bijvoorbeeld omdat je daar al opgewarmde nummers en goedgekeurde sjablonen hebt), open dan de kaart Twilio-account op de pagina Kanalen en schakel over naar je eigen account. Koppel vervolgens je bestaande afzender — beide stappen worden uitgelegd in SMS-provider (Breng je eigen Twilio mee). De meeste gebruikers kunnen het beste de beheerde configuratie aanhouden.

Vereisten #

Zorg ervoor dat u over het volgende beschikt voordat u begint:

• Een Meta Business-account (business.facebook.com) — bedrijfsverificatie is optioneel: niet-geverifieerde bedrijven kunnen een nummer activeren, sjablonen laten goedkeuren en uitzendingen versturen, beginnend bij de limiet van 250 unieke contacten per 24 uur (zie Berichtlimieten hieronder)
• Een account met voldoende tegoed
• Een telefoonnummer dat niet al is geregistreerd bij WhatsApp (persoonlijke of Business-app) en dat nog geen Twilio-nummer van een ander account is

Voeg eerst uw bedrijfsnaam en adres toe. Voordat u uw eerste nummer kunt kopen, moet u uw bedrijfsnaam en adres invullen onder Instellingen → Bedrijf (Werkruimtegroep). De provider valideert dit adres, dus zorg dat het nauwkeurig en volledig is — de aankoop zal mislukken totdat dit is ingesteld.

Stap 1: Een telefoonnummer kopen #

1. Klik in de linkerzijbalk onderaan op Instellingen.
2. Klik in de linkerzijbalk van Instellingen onder Kanalen op Kanalen.
3. Zoek de kaart WhatsApp Business API en klik op de groene knop WhatsApp verbinden.
4. Kies Een nieuw nummer van ons verkrijgen en vervolgens Door ons beheerd.

4. Er opent een pop-upvenster Telefoonnummer kopen. Kies een land — nummers en actuele prijzen komen rechtstreeks van onze provider voor dat land — en filter eventueel op Bevat cijfers.

5. Blader door de lijst met beschikbare nummers die verschijnt, waarbij de eenmalige aanschafkosten en maandelijkse kosten ernaast worden weergegeven.

6. Klik op een nummer en vul de Weergavenaam in — de bedrijfsnaam die mensen zien op WhatsApp. Deze moet letters bevatten; een los telefoonnummer wordt geweigerd. Bevestig vervolgens de getoonde kosten en voltooi de aankoop.

Een nummer dat hier wordt gekocht is voor WhatsApp, niet voor sms. Nummers die via het platform worden aangeschaft, worden gebruikt voor WhatsApp Business. Het zijn geen sms-nummers en het zijn ook geen belnummers: een inkomende oproep bereikt een automatische opname (die er is om het verificatiegesprek van WhatsApp tijdens de installatie te beantwoorden), er is geen voicemail-inbox om terug te luisteren en je kunt niet uitbellen met het nummer. Sms loopt in plaats daarvan via je eigen Twilio-account — zie SMS. Vertel klanten niet dat een gekocht nummer beide kan; dat kan het niet.

Credits worden van uw account afgeschreven voor de aankoop. Voor elk nummer geldt vervolgens een maandelijkse huur om het actief te houden: minimaal 50 credits per maand, en premiumnummers kosten meer, in lijn met wat de provider in rekening brengt. De kaart van het nummer onder Instellingen → Kanalen toont altijd de exacte maandelijkse prijs, en het aankoopvenster toont deze voordat u bevestigt.

Die huur is de enige maandelijkse vergoeding voor het nummer — het is inclusief de WhatsApp-verbinding, dus er hoeft niets extra’s betaald te worden om het nummer op WhatsApp te houden. Als u hier al nummers huurt, gaan deze bij de volgende factuurcyclus over naar dit tarief. Zie Telefoonnummers.

Mexico en Argentinië: voor deze landen worden alleen mobiele nummers aangeboden. WhatsApp behandelt nummers daar als mobiele nummers en alleen een mobiel nummer kan de verificatiecode van WhatsApp ontvangen — vaste nummers kunnen dit niet en worden daarom niet vermeld. Dit betekent ook dat het kengetal kan afwijken van dat van je eigen stad; dit heeft geen invloed op de werking van je WhatsApp.

Stap 2: Het nummer verbinden met Meta #

Een gekocht nummer moet nog worden geactiveerd bij Meta voordat het kan verzenden en ontvangen:

1. Op de Kanalen-pagina toont de WhatsApp Business API-kaart je nieuwe nummer in de lijst.
2. Klik op de verbindingsactie van het nummer zelf (Installatie voltooien) — er opent een Meta-pop-up waarin je de verbinding voltooit met het Meta-account dat eigenaar is van je WhatsApp Business-account, door de aanwijzingen van Meta te volgen.
3. Wanneer Meta de verbinding bevestigt, gaat het nummer automatisch live — er is geen afzonderlijke “aankondigingsstap”. De status verandert vanzelf naar Actief zodra de verbinding online is.

U wordt gevraagd in te loggen op uw Meta Business-account en het platform toestemming te geven om namens u WhatsApp-berichten te verzenden en te ontvangen.

Activering is meestal automatisch. Het duurt een paar minuten en in de meeste gevallen heeft u geen verificatiegesprek of -code nodig. Soms houdt Meta het nummer op “In afwachting”; als dat gebeurt, volg dan de instructies op het scherm om per telefoongesprek te verifiëren. Als een nummer herhaaldelijk niet kan worden geregistreerd, kan WhatsApp het tijdelijk beperken — wacht 24 uur en probeer het opnieuw, of neem contact op met de ondersteuning.

Heeft u al uw eigen Meta Cloud API-nummer? #

Je hoeft niet via het platform te kopen. Klik op de WhatsApp Business API-kaart op WhatsApp verbinden, kies Een nummer gebruiken dat je al hebt en vervolgens Door ons beheerd om het WhatsApp Business API verbinden-venster te openen:

1. Voer het telefoonnummer in, in internationaal formaat (bijv. +1 555 123 4567).
2. Typ optioneel een weergavenaam — de naam die wordt getoond aan mensen die je een bericht stuurt op WhatsApp.
3. Klik op Doorgaan naar WhatsApp om de verbinding in het eigen venster van Meta te voltooien.

We raden ten zeerste aan om NIET je actieve persoonlijke WhatsApp Business-nummer te koppelen — dit hier koppelen kan je bestaande WhatsApp-app verstoren. Gebruik een nieuw nummer.

Voeg in het venster van Meta je eigen nummer toe en verifieer dit. Kies niet het gratis testnummer van Meta (dat begint met +1 555) — dit kan alleen berichten sturen naar een handvol testcontacten die je handmatig toevoegt, dus het kan nooit echte klanten bereiken. Als je het testnummer van Meta invoert of selecteert, wordt de verbinding geweigerd.

Een nummer verplaatsen dat momenteel in de WhatsApp-app staat #

Een nummer dat actief is geregistreerd in de WhatsApp- of WhatsApp Business-app kan niet worden gekoppeld aan de API; je moet het eerst vrijgeven uit de app. Volg deze volgorde:

1. Sla eerst alles op wat je nodig hebt uit de app. Chatgeschiedenis wordt niet overgezet naar de API en het verwijderen van het account is definitief — exporteer of maak een back-up van belangrijke gesprekken voordat je doorgaat.
2. Schakel tweestapsverificatie uit in de app (Instellingen → Account → Tweestapsverificatie), zodat de oude pincode de API-registratie niet kan verstoren.
3. Verwijder het account in de app: Instellingen → Account → Mijn account verwijderen. Dit geeft het nummer vrij — een nummer kan alleen in de app of in de API staan, nooit in beide tegelijk.
4. Wacht een paar minuten totdat de vrijgave is verwerkt en volg daarna de koppelingsstappen hierboven om het nummer te koppelen.

Wilt u uw eigen WhatsApp Business-account zonder de ontwikkelaarsconfiguratie? #

Via onze Meta-app is een ander antwoord op de tweede vraag van dezelfde WhatsApp verbinden-knop. Je behoudt je eigen WhatsApp Business-account, maar je hoeft niets aan te maken op de ontwikkelaarswebsite van Meta — je gebruikt onze Meta-app. Meta factureert de gesprekken rechtstreeks aan je eigen WhatsApp Business-account. Als je je eigen nummer meeneemt: 50 credits per maand van ons voor de verbinding. Als je hier je nummer huurt: niets extra’s, omdat de huur van het nummer de verbinding al dekt. Zie Verbinden via onze Meta-app.

Gebruik je WhatsApp liever via je eigen Meta-app? #

Er is een verdere optie voor technische gebruikers en bureaus: maak uw eigen app aan op de ontwikkelaarssite van Meta en verbind deze rechtstreeks. Meta factureert u tegen hun eigen tarieven, er zijn geen kosten per bericht van onze kant, en uw klanten zien alleen uw bedrijfsnaam. De volledige handleiding staat in Uw eigen Meta-app verbinden.

Bij elke verbinding die gebruikmaakt van je eigen WhatsApp Business-account, factureert Meta de berichten — niet wij. Dat geldt voor het verbinden van je eigen nummer via Door ons beheerd hierboven, Via onze Meta-app en je eigen Meta-app. Meta brengt de kosten in rekening bij de betaalmethode die aan dat WhatsApp Business-account is gekoppeld. Als er geen werkende betaalmethode is, blokkeert Meta uitzendingen, campagnes en sjabloonberichten totdat je er een toevoegt. Lees WhatsApp-kosten & de wijziging van oktober 2026 voordat je je eerste bericht verstuurt — hierin wordt ook de prijswijziging behandeld die op 1 oktober 2026 ingaat.

Valkuilen bij de verbinding #

Een paar problemen zorgen bij de meeste nieuwe gebruikers voor struikelblokken tijdens het Meta-verbindingsproces. Lees deze door voordat u met de activering begint.

Kies uw eigen nummer, niet het testnummer van Meta #

Tijdens het Meta-koppelingsproces biedt Meta je een testtelefoonnummer aan (een voorbeeldnummer in de +1 555-reeks), naast de optie om je eigen nummer te gebruiken. Gebruik altijd je eigen nummer. Het testnummer van Meta kan wel berichten ontvangen, maar kan alleen berichten sturen naar een handvol nummers die je handmatig toevoegt in Meta. Het zal dus nooit berichten naar echte klanten sturen — elk antwoord mislukt stilletjes bij het verzenden. De app blokkeert dit: als je het testnummer van Meta invoert of selecteert, wordt de koppeling geweigerd en word je gevraagd om in plaats daarvan een echt nummer te gebruiken.

Uw nummer moet in het WhatsApp Business-account terechtkomen #

Dit is de meest voorkomende reden waarom een koppeling precies bij de laatste stap mislukt. Het kiezen van het testnummer van Meta, of het overslaan van de stap voor het telefoonnummer, zorgt ervoor dat het WhatsApp Business-account dat je hebt geselecteerd geen nummer bevat — en er is dan niets voor ons om te koppelen.

Bij de stap voor het telefoonnummer in het Meta-venster:

1. Kies ervoor om een nieuw nummer toe te voegen.
2. Voer je nummer in.
3. Verifieer het met de code die Meta je via sms of telefoon stuurt.

Wanneer dit correct is gedaan, verschijnt je nummer onder Telefoonnummers in dat account in WhatsApp Manager, gemarkeerd als geverifieerd. Als de koppeling mislukt, vertelt de app je precies wat er is gebeurd.

Als het mislukt, verwijder dan niets en maak niets opnieuw aan #

Wanneer een koppeling mislukt, is het verleidelijk om het WhatsApp Business-account te verwijderen en opnieuw te beginnen. Doe dit niet. Het verwijderen van een account waaraan je nummer is gekoppeld, maakt het probleem meestal moeilijker op te lossen, en herhaalde koppelingspogingen kunnen ertoe leiden dat een nummer tijdelijk wordt geblokkeerd door WhatsApp — wat permanent kan worden. Lees het foutbericht: het benoemt het specifieke probleem en de volgende stap. Als het nog steeds niet lukt om te koppelen, neem dan contact op met de ondersteuning met het telefoonnummer en de foutmelding.

Elk account heeft een eigen WhatsApp Business-account nodig #

Een WhatsApp Business-account kan slechts aan één berichtenaccount tegelijk worden gekoppeld. Je kunt hier dus geen tweede nummer via hetzelfde WhatsApp Business-account verbinden vanuit een ander account — dit komt het vaakst voor bij een bureau en een van zijn subaccounts, of twee subaccounts die allemaal naar hetzelfde Business-account verwijzen. Meta toont de verbinding nog steeds als geslaagd, omdat het nummer daadwerkelijk is geverifieerd en actief is in dat Business-account, maar de activering stopt hier met een melding die het account noemt dat het al gebruikt.

Twee manieren om verder te gaan:

• Verbind het nummer met het account dat dat WhatsApp Business-account al gebruikt. Het toevoegen van meer nummers daaraan werkt normaal.
• Geef dit account een eigen WhatsApp Business-account. Start de verbinding opnieuw en kies ervoor om een nieuw WhatsApp Business-account aan te maken in plaats van het bestaande te selecteren. Verwijder eerst het nummer uit het oude Business-account in Meta Business Manager, aangezien een nummer slechts bij één ervan kan horen.

Verwijder het bestaande WhatsApp Business-account niet om het vrij te maken — het nummer dat er al op draait, zou dan stoppen met werken.

Gebruik geen WhatsApp Business-account opnieuw dat al aan een andere BSP is gekoppeld #

Als je WhatsApp Business-account (WABA) al is gekoppeld aan een andere BSP (Business Service Provider — een ander platform dat er eerder verbinding mee heeft gemaakt), zal de verbinding hier mislukken en kan dit niet worden opgelost door het opnieuw te proberen; de activering stopt met een melding dat het Business-account al ergens anders is gekoppeld. Om dit te voorkomen, maak je een nieuw WhatsApp Business-account aan in Meta Business Manager voor deze verbinding, in plaats van er een te hergebruiken die elders is aangesloten.

Stap 3: Uw WhatsApp Business-profiel instellen #

Je WhatsApp Business-profiel is wat klanten zien wanneer ze contact opnemen met je bedrijf.

1. Zoek op de pagina Kanalen je WhatsApp-actieve nummer en open de profielbewerker.
2. Vul het volgende in:

3. Sla op om je profiel bij te werken.

Eén agent per nummer #

Als je account meer dan één WhatsApp Business API-nummer heeft, kan elk nummer door een andere AI-agent worden beantwoord. Het paneel Wie beantwoordt nieuwe gesprekken op de pagina AI-agents toont een blok per nummer voor WhatsApp met een keuzemenu per gekoppeld nummer: Zelfde als WhatsApp volgt de agent van het kanaal; het kiezen van een andere agent (of Niemand antwoordt) is alleen van toepassing op dat nummer. Antwoorden worden altijd verstuurd vanaf het nummer waar de klant een bericht naar heeft gestuurd. Details: Toegangspunten → Eén agent per WhatsApp-nummer.

Berichtenlimieten begrijpen #

WhatsApp hanteert berichtenlimieten om gebruikers te beschermen tegen spam. Deze limieten bepalen naar hoeveel unieke contacten u binnen een voortschrijdende periode van 24 uur berichten kunt sturen.

Tiersysteem #

Hoe u uw limieten kunt verhogen #

• Verifieer je bedrijf in Meta Business Manager om de initiële limiet van 250 contacten te verhogen naar 2.000.
• Behoud een hoge berichtkwaliteit — voorkom dat je wordt gerapporteerd of geblokkeerd door ontvangers.
• Verstuur berichten consistent — WhatsApp verhoogt automatisch je niveau wanneer je ongeveer de helft van je huidige limiet bereikt met goede kwaliteitsbeoordelingen, meestal binnen 6 uur nadat aan de criteria is voldaan.

Berichttypen #

Sessieberichten (Vrije vorm) #

Reguliere tekst, afbeeldingen, video’s, documenten en andere media die je kunt verzenden binnen een actief gespreksvenster.

• Kan alle inhoud bevatten
• Kan alleen worden verzonden binnen het 24-uurs berichtenvenster (zie hieronder)
• Geen voorafgaande goedkeuring vereist

Sjabloonberichten #

Vooraf goedgekeurde berichtformats waarmee u gesprekken met klanten kunt starten buiten het 24-uursvenster.

• Moeten vóór gebruik ter goedkeuring worden ingediend bij Meta
• Ondersteunen variabelen voor personalisatie (bijv. klantnaam, bestelnummer)
• Vereist voor het starten van nieuwe gesprekken of opnieuw contact opnemen na 24 uur
• Beschikbaar in meerdere talen

Sjablonen staan nu op hun eigen pagina — zie WhatsApp-berichtsjablonen voor de volledige uitleg.

Het 24-uurs berichtenvenster #

WhatsApp hanteert een 24-uurs gespreksvenster om gebruikers te beschermen:

• Wanneer een klant u een bericht stuurt, opent er een 24-uursvenster. Tijdens dit venster kunt u vrijelijk elk type bericht (sessieberichten) versturen.
• Na 24 uur inactiviteit (geen bericht van de klant) sluit het venster. U kunt het gesprek alleen hervatten met een goedgekeurd sjabloonbericht.
• Wanneer u een sjabloonbericht verstuurt, opent er een nieuw 24-uursvenster zodra de klant reageert.

Antwoorden binnen dit venster zijn vanaf 1 oktober 2026 niet meer gratis. Meta heeft aangekondigd dat ze vanaf die datum kosten in rekening brengen voor vrije antwoorden die een bedrijf verstuurt binnen het venster van 24 uur, per bericht, tegen het tarief van elke markt — hetzelfde tarief dat utility- en authenticatiesjablonen al kosten. Sinds november 2024 waren deze gratis. Elk telefoonnummer krijgt eerst 1.000 gratis serviceberichten per maand, en pas vanaf het 1.001e bericht worden er kosten in rekening gebracht; het tarief is het utility-tarief van de markt, dat al op de tariefkaart van Meta staat. Wat dit voor u betekent en wat u vóór die tijd moet controleren, leest u op WhatsApp-kosten & de wijziging van oktober 2026.

Uw configuratie testen #

Voordat u live gaat met klanten, moet u controleren of alles werkt:

1. Verstuur een testbericht. Open de AI-agent of Broadcast die aan dit nummer is toegewezen en gebruik het Uitproberen-paneel om uzelf een testbericht te sturen, of verstuur er direct een vanuit Chats.
2. Test inkomende berichten. Stuur een WhatsApp-bericht vanaf uw persoonlijke telefoon naar uw zakelijke nummer en bevestig dat het verschijnt in Chats.
3. Test AI-antwoorden. Bevestig dat de agent binnen de verwachte tijd reageert en dat de antwoorden overeenkomen met uw instructies en Knowledge Base.
4. Test sjabloonberichten. Maak en keur een eenvoudig sjabloon goed, stuur het naar uw testnummer en bevestig dat het aankomt met alle variabelen ingevuld.

Probleemoplossing #

Nummer verschijnt niet als actief #

• Zorg ervoor dat u het volledige activeringsproces heeft voltooid, inclusief het inloggen op uw Meta Business-account en het verlenen van machtigingen.
• Controleer of uw Meta Business-account een goede reputatie heeft.
• Wacht een paar minuten en ververs de pagina — activering kan enige tijd in beslag nemen.

Berichten worden niet verzonden #

• Controleer of u voldoende tegoed in uw account heeft.
• Controleer of u uw limiet voor het verzenden van berichten heeft bereikt.
• Zorg ervoor dat het telefoonnummer van de ontvanger in het juiste internationale formaat is (bijv. +1234567890).
• Als u buiten het 24-uursvenster verzendt, zorg er dan voor dat u een goedgekeurd sjabloon gebruikt.

Uitzendingen en sjablonen geblokkeerd, maar antwoorden werken nog steeds #

Dit patroon — je kunt mensen beantwoorden die jou als eerste een bericht sturen, maar niets dat je zelf start wordt verzonden — betekent bijna altijd dat het WhatsApp Business-account achter het nummer geen werkende betaalmethode heeft. Dit is alleen van toepassing op verbindingen die op je eigen WhatsApp Business-account draaien. Meta blokkeert door bedrijven geïnitieerde gesprekken (uitzendingen, campagnes, elk sjabloon) totdat er een geldige betaalmethode aan het account is gekoppeld en rapporteert de fout in WhatsApp Manager.

De app stopt in deze situatie nu een uitzending of campagne voordat deze wordt verzonden en vraagt je om een betaalmethode toe te voegen, in plaats van elk bericht te laten mislukken. Voeg de betaalmethode toe of herstel deze in WhatsApp Manager en probeer het opnieuw — het opnieuw verbinden van het nummer hier zal dit niet oplossen. Zie WhatsApp-kosten & de wijziging van oktober 2026.

Sjabloon afgewezen #

• Bekijk de sjabloonrichtlijnen van Meta — sjablonen mogen in bepaalde categorieën geen promotionele inhoud bevatten.
• Controleer op opmaakfouten, zoals niet-overeenkomende tijdelijke aanduidingen (placeholders).
• Lees de reden voor afwijzing die Meta heeft verstrekt, pas het sjabloon aan en dien het opnieuw in — zie WhatsApp-berichtsjablonen.

Slechte beoordeling van berichtkwaliteit #

• Controleer uw berichtinhoud op relevantie en waarde voor de ontvangers.
• Vermijd het berichten van contacten die geen toestemming hebben gegeven.
• Verlaag de berichtfrequentie als ontvangers u rapporteren of blokkeren.

Foutmelding “Telefoonnummer niet gevonden” #

• Het telefoonnummer is mogelijk niet correct gekoppeld aan uw Meta Business-account.
• Probeer het telefoonnummer opnieuw te activeren via de WhatsApp-verbindingsstroom.
• Neem contact op met de ondersteuning als het probleem aanhoudt.

Best practices #

• Vraag altijd om toestemming voordat je klanten een bericht stuurt op WhatsApp.
• Reageer snel op klantberichten om optimaal gebruik te maken van het venster van 24 uur.
• Houd sjablonen beknopt en waardevol — sjablonen van hoge kwaliteit worden sneller goedgekeurd en presteren beter.
• Houd je kwaliteitsbeoordeling in de gaten in Meta Business Manager om verlagingen van je niveau te voorkomen.
• Laat een AI-agent antwoorden afhandelen om 24/7 reactievermogen binnen het berichtenvenster te garanderen — zie AI-agents.