Artikelen

De WhatsApp Business API uitgelegd: toegang, sjablonen, kosten en koppeling met uw CRM

Met de WhatsApp Business API koppelt u een nummer officieel aan software in plaats van aan een telefoon. Wat u ervoor nodig hebt, wat het kost en wat er in het dagelijkse werk verandert.

Kort samengevat: De WhatsApp Business API, tegenwoordig geleverd als de Cloud API, is de officiële interface van Meta waarmee software WhatsApp-berichten voor een zakelijk nummer verstuurt en ontvangt. U hebt een Meta-bedrijfsportfolio nodig, een app, een telefoonnummer met een weergavenaam en goedgekeurde sjablonen voor alles wat u verstuurt buiten het venster van 24 uur na het laatste bericht van de klant. Meta rekent per afgeleverd bericht, naar categorie en land; berichten van klanten zijn gratis. NeuroCRM koppelt de Cloud API handmatig met uw eigen tokens, en daarnaast is er een GREEN-API-gateway.

Wat is de WhatsApp Business API?

Het is een interface, geen app. U downloadt niets en er is geen scherm om op in te loggen. Uw software (een CRM, een helpdesk, een eigen script) praat via deze interface met WhatsApp: binnenkomende berichten komen aan op een webhookadres, en antwoorden gaan de deur uit als API-aanroepen.

De interface die Meta vandaag documenteert, is de Cloud API, gehost door Meta zelf. Wie zoekt op «whatsapp api», «api van whatsapp» of «whatsapp cloud api», bedoelt dit. «WhatsApp Business Platform» is de bredere naam die Meta gebruikt voor zijn zakelijke berichtendiensten; de Cloud API is de interface daarbinnen.

Wat u wint ten opzichte van een telefoon: meerdere mensen kunnen één nummer beantwoorden, software kan berichten versturen en elk gesprek kan naast een contact en een deal staan. Wat u erbij neemt: regels voor sjablonen, een venster van 24 uur en facturering per bericht. Alle drie leest u hieronder.

Wat is het verschil tussen de WhatsApp Business-app, WhatsApp Business Web en de API?

  • WhatsApp Business-app. Een telefoonapp waarvan WhatsApp zegt dat hij is gemaakt met de eigenaar van een klein bedrijf in gedachten. Eén bedrijf, meestal één persoon achter het toetsenbord.
  • WhatsApp Business Web. De zoekterm voor hetzelfde zakelijke account, maar dan geopend in een browser. Het blijft het chatvenster van de app, geen koppeling: er hangt niets aan deals, taken of rapporten.
  • WhatsApp Business API (Cloud API). Een programmeerinterface. Het nummer wordt op het platform geregistreerd, en een programma in plaats van een telefoon handelt de gesprekken af.

Hoeft u maar een handvol mensen te antwoorden vanaf een laptop, dan volstaan de app en de browserversie misschien. Stap over op de API zodra meerdere medewerkers het nummer delen, berichten automatisch moeten uitgaan of gesprekken in een CRM moeten belanden.

Wie krijgt toegang, en wat hebt u nodig?

De startgids van Meta vraagt om een Facebook-account of een beheerd Meta-account, een registratie als ontwikkelaar en een toestel met WhatsApp voor testberichten. In dezelfde stappen kiest of maakt u een Meta-bedrijfsportfolio, maakt u een app aan met de use case WhatsApp en voegt u een telefoonnummer toe.

Voor het nummer gelden regels, volgens de documentatie van Meta over telefoonnummers:

  • Een nummer dat al met WhatsApp wordt gebruikt, kunt u pas registreren nadat het eerst uit WhatsApp is verwijderd.
  • Het moet van u zijn, een land- en netnummer bevatten en een sms of telefoontje voor verificatie kunnen ontvangen.
  • Bij de registratie is een weergavenaam verplicht. Die verschijnt op het WhatsApp-profiel van het nummer.

Om te beginnen met testen hebt u geen sjablonen nodig: de snelstart van Meta zelf verstuurt het kant-en-klare sjabloon hello_world. Eigen goedgekeurde sjablonen hebt u nodig zodra u als eerste schrijft of antwoordt nadat het venster is gesloten.

Hoe werkt het venster van 24 uur?

Zodra een klant u schrijft of belt, gaat er een venster van 24 uur open. Elk nieuw bericht van de klant zet het opnieuw op 24 uur. Zolang het open is, mag u berichten in vrije vorm sturen. Daarna zijn alleen sjabloonberichten toegestaan (zo staat het op de prijspagina van Meta).

Sjablonen vallen in drie categorieën: marketing, utility en authenticatie. U maakt ze aan in WhatsApp Manager en Meta beoordeelt ze; reken op enige wachttijd voordat een nieuw sjabloon werkt.

Hoe factureert Meta de WhatsApp Business API?

Volgens de prijspagina van Meta, gecontroleerd op 18 november 2026:

  • Sinds 1 juli 2025 rekent Meta per afgeleverd bericht, niet per gesprek. De prijs hangt af van de berichtcategorie en het landnummer van de ontvanger.
  • Berichten die klanten u sturen, worden niet in rekening gebracht.
  • Sjablonen zijn marketing, utility of authenticatie; antwoorden zonder sjabloon binnen het venster zijn service. Meta noemt daarnaast Meta Business Agent.
  • Elk zakelijk telefoonnummer krijgt 1.000 gratis serviceberichten per maand, elke maand opnieuw. Vanaf 1 oktober 2026 betaalt u voor serviceberichten vanaf nummer 1.001.
  • Staat er geen betaalmethode op het berichtenaccount, dan levert Meta serviceberichten alleen af binnen het gratis tegoed.
  • Utility-sjablonen die binnen een open venster worden verstuurd, waren gratis tot en met 30 september 2026 en worden vanaf 1 oktober 2026 in rekening gebracht.
  • Stuurt een klant u een bericht vanuit een Click to WhatsApp-advertentie in de mobiele app en antwoordt u binnen het venster, dan gaat er een gratis toegangsvenster van maximaal 7 dagen open voor marketing-, utility-, authenticatie- en serviceberichten.

De tarieven in dollars staan in tarievenlijsten die Meta vanaf die pagina koppelt, en ze verschillen per land en categorie. Kijk in de lijst voor uw landen voordat u een budget maakt; hier noemen we geen tarief.

De kosten van Meta komen op het WhatsApp-account dat u koppelt. Een CRM of andere softwareleverancier rekent daarbovenop zijn eigen prijs.

Kan ik er marketingberichten en bots mee versturen?

Ja, binnen de regels van Meta: marketingsjablonen zijn een berichtcategorie met een eigen prijs, en een bot is gewoon software die dezelfde API gebruikt, met dezelfde regels voor venster en sjablonen.

«WhatsApp API bericht versturen» komt in de praktijk neer op twee soorten aanroepen: een bericht in vrije vorm binnen het venster, of een sjabloonbericht daarbuiten. Het tijdstip van het laatste bericht van de klant bepaalt welke van de twee mogelijk is.

Hoe koppelt NeuroCRM de WhatsApp Business API?

NeuroCRM kent twee manieren om WhatsApp te koppelen. Een uitgebreidere vergelijking van beide leest u in WhatsApp-CRM: officiële API vs QR-gateways. Dit artikel behandelt de API-kant in detail.

De Cloud API handmatig koppelen

Onder Instellingen → Integraties kiest u WhatsApp Business Cloud API en vult u vier velden in:

  1. Telefoonnummer ID uit het scherm API Setup van Meta.
  2. Permanente toegangstoken (systeemgebruiker), aangemaakt in Bedrijfsinstellingen → Systeemgebruikers.
  3. App Secret, waarmee de handtekening van binnenkomende webhooks wordt gecontroleerd.
  4. WhatsApp Business Account ID (WABA ID).

Klik daarna op «Verifiëren en verbinden». NeuroCRM toont een Callback URL en een Verificatietoken; die plakt u allebei in uw Meta-app onder WhatsApp → Configuratie → Webhooks, waarna u zich abonneert op het veld messages. U kunt meerdere nummers toevoegen.

Eén knop die alles regelt, is er niet. De Meta-app, de systeemgebruiker en het token maakt u zelf aan, dus de eerste koppeling kost wat tijd. Richt de kant van Meta in voordat u begint.

Wat medewerkers zien

Elk WhatsApp-gesprek komt in dezelfde inbox als uw andere kanalen, met een contactkaart. NeuroCRM meet de 24 uur vanaf het nieuwste echte WhatsApp-bericht van de klant en beschouwt het venster vijf minuten eerder als gesloten.

Is het venster dicht, dan verstuurt NeuroCRM in plaats van uw tekst een goedgekeurd sjabloon: het sjabloon dat u kiest, het standaardsjabloon van de werkruimte of een goedgekeurd sjabloon zonder variabelen of media. Uw concept blijft in het invoerveld staan tot de klant antwoordt. Is er geen goedgekeurd sjabloon, dan wordt het versturen geweigerd, en een tweede sjabloon gaat vóór een antwoord van de klant alleen de deur uit als u het opnieuw uit de lijst kiest.

Regels, automatiseringen en AI

  • Automatiseringen. Buiten het venster verstuurt een automatisering niets en kiest ze ook geen sjabloon: de stap wordt als niet verzonden gemarkeerd. Bij gebeurtenissen rond een deal gaat het bericht naar het oudste gesprek van het contact, via welk kanaal ook.
  • Verkoopsequenties. Een WhatsApp-stap verstuurt het goedgekeurde sjabloon dat u in die stap opgeeft.
  • AI-antwoorden. Het Neuro Contact Center is een betaalde uitbreiding: $200 per maand plus $0,50 per geslaagde dialoog, met uw eigen AI-sleutel tegen 0% toeslag of via NeuroCRM met +20%. Buiten het venster van 24 uur antwoordt het niet en verstuurt het ook geen sjabloon. Afspraken plant het niet zelf in.

Het alternatief: GREEN-API

GREEN-API is een onofficiële gateway. U koppelt een persoonlijk nummer met een QR-code in de console van GREEN-API en vult daarna idInstance en apiTokenInstance in NeuroCRM in. De eigen toelichting bij de koppeling zegt dat hij geschikt is voor «gevallen waarin de officiële WhatsApp Business API niet beschikbaar is». Het is geen platform van Meta, dus de regels voor sjablonen en het venster hierboven gelden er niet voor.

Wat doet NeuroCRM niet met de WhatsApp Business API?

  • Geen koppeling met één klik. De Meta-gegevens voert u handmatig in; de procedure Embedded Signup van Meta wordt niet als knop aangeboden.
  • Geen coexistence. Een nummer dat tegelijk in de WhatsApp Business-app en via de API wordt gebruikt, werkt niet via NeuroCRM.
  • De berichtkosten van Meta zitten niet in de prijs per gebruiker en worden niet door NeuroCRM bepaald; Meta factureert het account dat u koppelt.
  • Geen automatische keuze van een sjabloon door automatiseringen of de AI buiten het venster van 24 uur.

Wat kost WhatsApp in NeuroCRM?

Een gebruiker kost $13 per maand, of $10,40 bij jaarlijkse betaling; een gratis abonnement is er niet. De proefperiode van 14 dagen bevat alles, met een onbeperkt aantal gebruikers, en daarna wordt de werkruimte alleen-lezen. Zie de tarieven. Het Neuro Contact Center is de aparte uitbreiding van hierboven. De berichtkosten van Meta vormen een derde post, die Meta zelf factureert.

Wilt u systemen vergelijken, kijk dan bij de vergelijkingen van NeuroCRM en de gids met Kommo-alternatieven. Hoe WhatsApp naast uw andere kanalen werkt, leest u bij de gedeelde inbox.

Checklist: voordat u koppelt

  1. Kies een nummer dat van u is en waarop u een verificatie-sms of -telefoontje kunt ontvangen. Staat het al in WhatsApp, plan dan in dat u het daar eerst verwijdert.
  2. Maak het Meta-bedrijfsportfolio aan, de app met de use case WhatsApp en een systeemgebruiker met een permanent token.
  3. Kies de weergavenaam.
  4. Voeg aan de kant van Meta een betaalmethode toe, anders worden serviceberichten boven het gratis tegoed niet afgeleverd.
  5. Dien minstens één utility-sjabloon in bij WhatsApp Manager en wacht op de goedkeuring van Meta voordat u live gaat.
  6. Noteer uw Telefoonnummer ID en WABA ID uit het scherm API Setup.
  7. Koppel in NeuroCRM, kopieer de Callback URL en het verificatietoken naar Meta en abonneer u op messages.
  8. Stuur uzelf een bericht, beantwoord het, wacht tot het venster dicht is en test een sjabloon.

Veelgestelde vragen

Is de WhatsApp Business API gratis?

Niet helemaal. Meta rekent per afgeleverd bericht, behalve voor berichten van klanten, de eerste 1.000 serviceberichten per nummer per maand en berichten in een gratis toegangsvenster.

Wat is het verschil tussen de WhatsApp API en de Cloud API?

Bij een nieuwe inrichting zijn ze in de praktijk hetzelfde: de Cloud API is de versie die Meta host en documenteert, en die gebruikt de koppeling WhatsApp Business Cloud API van NeuroCRM ook.

Kan ik het nummer van mijn WhatsApp Business-app voor de API gebruiken?

Volgens Meta moet een nummer dat al met WhatsApp wordt gebruikt, eerst uit WhatsApp worden verwijderd voordat u het registreert. Via NeuroCRM werkt één nummer tegelijk in de app en via de API (coexistence) niet.

Waarom is mijn bericht niet bij de klant aangekomen?

Twee veelvoorkomende oorzaken: het venster van 24 uur was gesloten en het bericht was geen sjabloon, of er stond geen betaalmethode op het Meta-account toen de gratis serviceberichten op waren. Bij een gesloten venster verstuurt NeuroCRM uw gewone tekst niet; het stuurt eerst een goedgekeurd sjabloon en bewaart uw tekst in het invoerveld.

Kunnen meerdere mensen antwoorden vanaf één API-nummer?

Ja. Gesprekken van één nummer komen in NeuroCRM in een gedeelde inbox, en u kunt meerdere nummers koppelen.

Bronnen

  • Meta, prijzen van het WhatsApp Business Platform — https://developers.facebook.com/docs/whatsapp/pricing (gecontroleerd op 18 november 2026)
  • Meta, aan de slag met de Cloud API — https://developers.facebook.com/docs/whatsapp/cloud-api/get-started (gecontroleerd op 18 november 2026)
  • Meta, telefoonnummers — https://developers.facebook.com/docs/whatsapp/cloud-api/phone-numbers (gecontroleerd op 18 november 2026)
  • WhatsApp Business-app — https://whatsappbusiness.com/products/business-app/ (gecontroleerd op 18 november 2026)

Zo is dit artikel gemaakt: het NeuroCRM-team heeft het geschreven met hulp van AI; uitspraken over het product zijn gecontroleerd aan de hand van de code en de help van NeuroCRM; de prijzen komen uit de gepubliceerde prijslijst op de datum van bijwerking.