Met de WhatsApp Business-app kom je als merk een eind: een geverifieerd profiel, snelle antwoorden en eenvoudige afwezigheidsberichten. Alles daarbuiten vraagt om de API. Met de WhatsApp Business API kan een merk berichten op schaal versturen, WhatsApp koppelen aan andere systemen, chatbots draaien en berichten opnemen in marketing of support in plaats van ze los te beheren. Voor merken die WhatsApp serieus nemen als kanaal is de API geen optionele infrastructuur. Het is de basis waarop al het andere mogelijk wordt.
Wat de WhatsApp Business API is en wat het mogelijk maakt
Als je begrijpt wat de API echt biedt, en wat niet, voorkom je de veelgemaakte fout om hem te zien als een toverknop die alle problemen met opschalen van WhatsApp vanzelf oplost.
De API of de WhatsApp Business-app
De WhatsApp Business-app is een mobiele app voor kleine bedrijven. Ze is gratis, werkt op één apparaat, ondersteunt één gebruiker tegelijk en heeft geen koppelmogelijkheden met externe systemen. De WhatsApp Business API is een set programmeerbare interfaces waarmee softwaresystemen WhatsApp-berichten kunnen versturen en ontvangen. Het is geen app. Er is geen gebruikersinterface. Je krijgt er toegang toe door zelf een directe koppeling te bouwen of door een platform van een derde partij te gebruiken dat die al heeft gebouwd. De API ondersteunt meerdere gebruikers, schaalt naar grote berichtenvolumes, koppelt met andere softwaresystemen en maakt automatisering mogelijk die de app niet kan. Daar staan kosten en technische complexiteit tegenover: de API is niet gratis en vraagt meer opzet dan een app downloaden.
Wat de API mogelijk maakt
Dit kan met toegang tot de WhatsApp Business API:
- Uitgaande berichten op schaal versturen naar contacten die toestemming hebben gegeven, inclusief meldingen in de stijl van een verzendlijst en gepersonaliseerde reeksen
- Chatbots en geautomatiseerde gespreksflows draaien die zonder mens op inkomende berichten reageren
- WhatsApp koppelen met CRM-, helpdesk-, e-commerce- en marketingautomatiseringsplatforms
- Meerdere medewerkers laten werken vanuit één gedeeld WhatsApp-nummer via een gekoppelde inbox
- Berichtsjablonen gebruiken voor gesprekken die het bedrijf zelf start
- Bezorg-, lees- en reactiestatus per contact volgen voor analyse en rapportage
Berichtsjablonen: de toegang tot uitgaande berichten
Een van de belangrijkste begrippen om te begrijpen in de API is het berichtsjabloon. Als een bedrijf een gesprek begint met een klant die de afgelopen 24 uur geen bericht heeft gestuurd, moet dat bericht een vooraf goedgekeurd sjabloon gebruiken. Sjablonen worden ter beoordeling bij WhatsApp ingediend, meestal binnen 24 tot 48 uur goedgekeurd en moeten voldoen aan het contentbeleid van WhatsApp. Sjablonen kunnen plaatshouders voor personalisatie bevatten (de naam van de klant, een ordernummer, een datum), maar de kernstructuur van het bericht moet vast blijven. Zodra een klant antwoordt, begint een venster van 24 uur waarin het bedrijf berichten in vrije vorm kan sturen zonder beperkingen van sjablonen.
Het gespreksvenster van 24 uur
Het systeem van gespreksvensters bij WhatsApp is essentieel om te begrijpen hoe berichten via de API werken. Elke keer dat een klant een bericht stuurt, opent een venster van 24 uur waarin het merk vrij kan antwoorden in elk berichtformaat. Als de klant binnen 24 uur na het laatste bericht van het merk niet reageert, sluit het venster en moet het merk een sjabloon gebruiken om opnieuw te beginnen. Dit vensterssysteem is bedacht om te voorkomen dat merken WhatsApp gebruiken als onbeperkt uitgaand marketingkanaal. Het bepaalt hoe je automatiseringsflows ontwerpt: het doel van veel geautomatiseerde antwoorden is een reactie van de klant uitlokken, zodat het venster openblijft voor een gesprek in vrije vorm.
Prijzen op basis van gesprekken
De WhatsApp Business API hanteert een prijsmodel op basis van gesprekken. Een gesprek is een berichtensessie van 24 uur tussen een merk en een klant. Er zijn verschillende gesprekscategorieën met verschillende prijzen: marketinggesprekken (berichten die het merk start voor aanbiedingen), transactiegesprekken (transactionele berichten zoals orderupdates), authenticatiegesprekken (eenmalige wachtwoorden en verificatie) en servicegesprekken (supportgesprekken die de klant start). De prijs verschilt per categorie en per land van het telefoonnummer van de klant. Als je dit prijsmodel kent voordat je automatisering bouwt, voorkom je onverwachte kosten als campagnes of supportvolumes groeien.
Toegang krijgen tot de WhatsApp Business API
Je vraagt API-toegang niet rechtstreeks aan bij WhatsApp. Je krijgt hem via een netwerk van goedgekeurde WhatsApp Business Solution Providers, of via de directe Cloud API van Meta voor technisch onderlegde teams.
WhatsApp Business Solution Providers
Een WhatsApp Business Solution Provider is een externe partij die door Meta is goedgekeurd om toegang tot de WhatsApp Business API te bieden. Zij beheren de technische infrastructuur en de nalevingseisen en bieden vaak een platformlaag bovenop de API waarmee je hem zonder diepe technische kennis kunt gebruiken. Een Solution Provider kiezen betekent een platform kiezen: de interface, prijzen en functies van de provider bepalen alles wat het merk met WhatsApp kan doen. Let bij de keuze van een provider op:
- Prijsstructuur: per bericht, per gesprek of een vast bedrag per maand
- Mogelijkheden van het platform: dekt de interface de benodigde toepassingen (chatbots, inbox voor meerdere medewerkers, CRM-koppeling)?
- Hulp bij de start: hoeveel hulp is er tijdens het opzetten en verifiëren?
- Uptime en betrouwbaarheid: welke SLA's biedt de provider voor het bezorgen van berichten?
- Beheer van sjablonen: hoe makkelijk is het om berichtsjablonen te maken, in te dienen en te beheren?
Meta Cloud API: de optie voor directe toegang
Meta biedt directe API-toegang via zijn Cloud API. Daarmee heb je geen externe provider nodig, maar je hebt wel technische middelen nodig om de koppeling te beheren. Voor merken met ontwikkelcapaciteit biedt de Cloud API meer controle en lagere kosten per bericht dan via een provider. Voor merken zonder technische middelen is een providerplatform de praktische keuze. Het verificatie- en opzetproces is voor beide routes vergelijkbaar: een Facebook Business Manager-account, een geverifieerd bedrijf, een eigen telefoonnummer en een compleet WhatsApp Business-profiel.
Eisen aan telefoonnummers en nummerportering
Het telefoonnummer voor de WhatsApp Business API moet speciaal voor dat doel zijn. Het kan geen bestaand nummer van een persoonlijke WhatsApp of van de Business-app zijn zonder een migratieproces, en tijdens de migratie gaat de berichtgeschiedenis van het nummer verloren. Het nummer moet tijdens het opzetten een verificatie-sms of belbericht kunnen ontvangen. Merken die een bestaand nummer willen gebruiken dat klanten al kennen, kunnen het overzetten naar de API, maar daarbij is het nummer tijdelijk offline. Plan deze overgang zorgvuldig, zodat bestaande klantgesprekken niet worden verstoord.
Het proces van bedrijfsverificatie
Voordat je API-toegang krijgt, moet het bedrijf worden geverifieerd via Facebook Business Manager. Daarvoor dien je bedrijfsdocumenten in (inschrijving, belastingnummer of iets vergelijkbaars) en wacht je tot Meta de aanvraag beoordeelt en goedkeurt. Verificatie kan van een paar dagen tot enkele weken duren, afhankelijk van het type bedrijf en de aangeleverde documenten. Geverifieerde bedrijven krijgen ook toegang tot het vinkje voor WhatsApp Business-verificatie, maar dat staat los van API-toegang en heeft een eigen aanvraagproces. Begin vroeg in het traject van API-invoering met verificatie, zodat het geen bottleneck wordt.
Goedkeuring van de weergavenaam
De weergavenaam die klanten in WhatsApp zien als ze een bericht ontvangen, moet door Meta worden goedgekeurd. Hij moet het bedrijf duidelijk weergeven en voldoen aan de richtlijnen van WhatsApp voor namen. Weergavenamen die niet overeenkomen met de bedrijfsinschrijving, algemene termen bevatten of het contentbeleid schenden, worden afgewezen en moeten opnieuw worden ingediend. De goedkeuring van de weergavenaam hoort bij de eerste opzet en moet zijn geregeld voordat het account volledig kan worden geactiveerd. Als je de juiste bedrijfsnaam en de bijbehorende documenten bij de start van het opzetten klaar hebt, voorkom je vertraging in deze fase.
Toepassingen van automatisering en hoe je ze bouwt
De API maakt veel scenario's voor automatisering mogelijk. De waardevolste voor de meeste merken vallen in drie categorieën: uitgaande meldingsreeksen, automatische antwoorden op inkomende berichten en hybride flows die beide combineren.
Uitgaande meldingsreeksen
De API is goed geschikt voor geautomatiseerde uitgaande berichten die worden gestart door specifieke gebeurtenissen in gekoppelde systemen. Veelvoorkomende uitgaande reeksen met veel waarde zijn:
- Orderbevestigingen en verzendupdates, gestart door gebeurtenissen op het e-commerceplatform
- Afspraakherinneringen, 24 uur en 2 uur voor het geplande tijdstip
- Berichten over achtergelaten winkelwagens aan contacten met toestemming die zonder aankoop vertrokken
- Reeksen om contacten terug te halen die een bepaalde periode inactief zijn geweest
- Opvolging na een aankoop met het verzoek om een review of een aanbod van gerelateerde producten
Voor elk daarvan heb je een berichtsjabloon nodig voor het eerste uitgaande bericht, een trigger van een gekoppeld systeem en een plan voor de reacties die de melding oplevert.
Automatische antwoorden op inkomende berichten
Automatisering voor inkomende berichten handelt berichten af die klanten uit zichzelf sturen. Een klant die "volg mijn bestelling" of "wat zijn jullie openingstijden" stuurt, kan direct een automatisch antwoord krijgen zonder dat een medewerker erbij betrokken hoeft te zijn. Effectieve automatisering voor inkomende berichten werkt met herkenning van trefwoorden, gestructureerde menuflows of een combinatie van beide. Herkenning van trefwoorden reageert op specifieke woorden of zinnen met een vooraf bepaald antwoord. Menuflows geven de klant een aantal opties en vertakken het gesprek op basis van zijn keuze. Een combinatie van beide levert een robuustere ervaring op die meer soorten invoer van klanten aankan.
Hybride flows: automatisering met overdracht aan een mens
De meest effectieve WhatsApp-automatisering combineert automatische afhandeling voor vastgelegde scenario's met een nette overdracht aan een medewerker als het gesprek dat vraagt. Een klant die een bericht stuurt over de orderstatus, krijgt een automatische opzoeking en antwoord. Een klant die daarna opvolgt met een klacht over de bezorging, wordt doorgestuurd naar een medewerker. De overdracht moet naadloos zijn: de medewerker krijgt de volledige gespreksgeschiedenis en context voordat hij overneemt, zodat de klant zich niet hoeft te herhalen. Het zorgvuldig ontwerpen van de trigger voor overdracht, wanneer precies de bot een stap terug doet en de mens overneemt, is net zo belangrijk als het ontwerpen van de geautomatiseerde flows zelf.
Personalisatie in geautomatiseerde berichten
Automatisering via de API ondersteunt personalisatie op schaal. Berichtsjablonen hebben variabele velden: de voornaam van de klant, een ordernummer, een specifiek product, een datum, een locatie. Deze variabelen worden bij het verzenden gevuld uit het gekoppelde systeem, zodat een orderupdate zegt "Hoi Sarah, je bestelling #12847 is verzonden" in plaats van een algemene melding. Personalisatie verhoogt het aantal geopende berichten en reacties bij geautomatiseerde berichten, omdat het bericht relevant lijkt voor de ontvanger en niet naar iedereen is gestuurd. Zelfs eenvoudige personalisatie, zoals de voornaam en een specifieke verwijzing naar recente activiteit van de klant, laat geautomatiseerde berichten aanzienlijk menselijker voelen.
Limieten en planning van doorvoer
De WhatsApp Business API heeft limieten voor hoeveel berichten per seconde en per dag kunnen worden verstuurd. Die limieten schalen mee met de kwaliteitsbeoordeling en het niveau van het account. Nieuwe accounts beginnen met lagere limieten en kunnen die na verloop van tijd verhogen door hoge berichtkwaliteit en weinig blokkades te houden. Als je de benodigde doorvoer voor automatiseringscampagnes plant voordat je ze bouwt, voorkom je dat een campagne klaarstaat maar het account het volume niet binnen de gewenste tijd kan bezorgen. Verzendingen met een groot volume, zoals een commercieel bericht aan een grote lijst, plan je beter zo dat de bezorging over tijd wordt gespreid in plaats van alle berichten tegelijk te proberen te versturen.
Regels, kosten en gespreksvensters beheren
WhatsApp-automatisering op schaal draaien brengt doorlopende verplichtingen rond regels, keuzes over kostenbeheer en operationele bewaking mee die er op de kleinere schaal van de Business-app niet zijn.
Eisen voor toestemming en naleving
Het beleid van WhatsApp eist uitdrukkelijke toestemming van contacten voordat ze berichten kunnen ontvangen die het bedrijf zelf start. De toestemming moet specifiek voor WhatsApp zijn: een algemeen vinkje voor marketingtoestemming dekt WhatsApp-berichten niet automatisch. Op de plekken waar je toestemming vraagt, moet duidelijk staan dat de klant akkoord gaat met het ontvangen van WhatsApp-berichten van het merk en welke soorten berichten ze krijgen. Toestemming vastleggen is zowel een eis van WhatsApp als in veel markten een wettelijke verplichting. Contacten die niet uitdrukkelijk toestemming voor WhatsApp-berichten hebben gegeven, mag je niet toevoegen aan verzendlijsten of benaderen met uitgaande reeksen.
Kwaliteitsbeoordeling en de gevolgen ervan
WhatsApp geeft elk zakelijk account een kwaliteitsbeoordeling op basis van hoe klanten op berichten reageren: het aantal blokkades, meldingen en afmeldingen telt allemaal mee. Een lage kwaliteitsbeoordeling leidt tot lagere limieten voor berichten, wat geplande campagnes kan verstoren. Een steeds lage beoordeling kan ertoe leiden dat het account wordt gemarkeerd of beperkt. Een hoge kwaliteitsbeoordeling houd je vast door relevante, nuttige berichten te sturen naar contacten met toestemming, verzoeken om afmelding direct uit te voeren en berichten niet zo vaak te sturen dat contacten het nummer uit ergernis blokkeren. De kwaliteitsbeoordeling is een signaal in realtime van of de WhatsApp-communicatie van het merk aan de verwachtingen van klanten voldoet.
Gesprekscategorieën en kosten beheren
Omdat verschillende gesprekscategorieën verschillende prijzen hebben, is het beheren van hoe gesprekken worden ingedeeld en hoeveel er per maand plaatsvinden een legitieme manier om kosten te beheersen. De grootste hefboom is het aandeel servicegesprekken (die de klant start) te vergroten ten opzichte van marketinggesprekken (die het merk start), omdat servicegesprekken meestal goedkoper zijn of in sommige markten gratis. Snel antwoorden op berichten van klanten, zodat het venster van 24 uur openblijft, verkleint de behoefte aan nieuwe contactpogingen met sjablonen. Als je elke maand het aantal gesprekken per categorie volgt en vergelijkt met de vorige periode, zie je of de kosten evenredig meegroeien met de bedrijfsactiviteit of sneller.
Sjablonen beheren op schaal
Naarmate het API-gebruik groeit, groeit het aantal gebruikte sjablonen mee. Sjablonen voor verschillende campagnes, talen, klantsegmenten en soorten berichten stapelen zich snel op. Zonder beheerproces raken sjablonen verouderd, dubbel of worden ze verkeerd gebruikt. Met een sjablonenbibliotheek met duidelijke eigenaren, vervaldata voor sjablonen met een tijdslimiet en een evaluatieronde voor sjablonen die verwijzen naar prijzen of beleid, voorkom je het operationele risico dat je op schaal verouderde content verstuurt. Als een sjabloon niet meer nodig is, houdt pauzeren of verwijderen de bibliotheek schoon en voorkomt het verwarring bij het maken van nieuwe sjablonen.
De prestaties van automatisering over tijd bewaken
Geautomatiseerde flows staan niet stil. Klantgedrag verandert, bedrijfsinformatie verandert en de effectiviteit van specifieke berichten verandert met de tijd. Als je de belangrijkste meetwaarden van elke geautomatiseerde flow elke maand bekijkt, zie je waar flows werken en waar ze achteruitgaan:
- Bezorgpercentage: het deel van de verzonden berichten dat met succes is bezorgd
- Leespercentage: het deel van de bezorgde berichten dat is geopend
- Reactiepercentage: het deel van de berichten dat een reactie van de klant opleverde
- Afmeldpercentage: het deel van de contacten dat het nummer blokkeerde of meldde na een bericht
- Percentage opgeschaald: hoe vaak geautomatiseerde flows doorzetten naar een mens zonder af te ronden
We gebruiken nu de WhatsApp Business-app. Wanneer weten we dat het tijd is om over te stappen naar de API?
Het duidelijkste signaal is dat de beperkingen van de app je actief tegenhouden iets nuttigs te doen. Specifieke aanleidingen zijn: je hebt meer dan één medewerker nodig om inkomende gesprekken af te handelen, je wilt WhatsApp koppelen aan een CRM of e-commerceplatform, je moet geautomatiseerde meldingen op schaal versturen (orderupdates, herinneringen, reeksen) of je wilt chatbotflows draaien. Als je alles via de app beheert zonder dat die beperkingen problemen geven, is de app nog steeds het juiste hulpmiddel. Stap over naar de API als de beperkingen van de app je klanten of efficiëntie kosten.
Wat kost toegang tot de WhatsApp Business API?
De prijs heeft twee lagen. Eerst de eigen kosten van WhatsApp op basis van gesprekken, die verschillen per gesprekscategorie en het land van de klant. Daarnaast de platformkosten van de Solution Provider, die apart worden gerekend en sterk verschillen per provider. Sommige providers rekenen per bericht, sommige per gesprek en sommige een vast bedrag per maand. Je krijgt alleen een goede kostenraming door je verwachte gespreksvolume per categorie en land te schatten en het totaal te vergelijken met de prijzen van providers. Reken voor de eerste maanden een marge in, terwijl je leert hoe jouw mix van gesprekken zich in de praktijk gedraagt.
Onze berichtsjablonen worden steeds afgewezen. Wat zijn de meest voorkomende redenen?
De meest voorkomende redenen voor afwijzing zijn: het sjabloon is te commercieel van toon (WhatsApp beperkt marketingtaal in bepaalde sjablooncategorieën), de inhoud bevat beperkte onderwerpen (financiële producten, alcohol, gokken en farmaceutische producten hebben specifieke regels), het sjabloon mist een verplichte afmeldoptie of de inhoud past niet bij de opgegeven categorie. Lees de reden van afwijzing goed voordat je aanpast: opnieuw indienen zonder het specifieke probleem op te lossen leidt tot weer een afwijzing en vertraagt het traject. Als de reden onduidelijk is, lees dan eerst het contentbeleid van WhatsApp voor sjablonen voordat je iets wijzigt.
Wat gebeurt er als onze kwaliteitsbeoordeling daalt?
Een lage kwaliteitsbeoordeling leidt eerst tot lagere dagelijkse limieten voor berichten, waardoor je mogelijk niet het geplande aantal berichten kunt versturen. Als de beoordeling blijft dalen, kan het account worden gemarkeerd en worden de mogelijkheden voor berichten verder beperkt. WhatsApp geeft waarschuwingen voordat beperkingen ingaan, zodat je tijd hebt om de oorzaak te vinden en aan te pakken. De meest voorkomende oorzaken van een lagere kwaliteitsbeoordeling zijn veel blokkades, veel meldingen of berichten aan contacten die geen toestemming hebben gegeven. Deze oorzaken snel aanpakken is effectiever dan afwachten of de beoordeling vanzelf herstelt.
Kunnen we ons bestaande nummer van de WhatsApp Business-app naar de API migreren zonder onze contactgeschiedenis te verliezen?
Je kunt een bestaand nummer naar de API migreren, maar de berichtgeschiedenis in de app wordt niet overgezet. Het nummer zelf gaat mee en je contacten kunnen het nog steeds berichten sturen, maar de gespreksgeschiedenis die je in de app ziet, blijft op het apparaat staan en is niet toegankelijk via de API. Als het belangrijk is om oude gesprekken te bewaren, exporteer ze dan uit de app vóór de migratie. Het nummer is tijdens de migratie tijdelijk niet beschikbaar, dus als je dit in een rustige periode plant, beperk je de verstoring.
We willen een groot commercieel bericht naar onze WhatsApp-lijst sturen. Hoe beheren we het volume zonder limieten te raken?
Plan het bericht zo dat het in batches over meerdere uren wordt verstuurd, in plaats van alles tegelijk te bezorgen. Nieuwe API-accounts hebben lagere limieten die na verloop van tijd stijgen naarmate het account een kwaliteitsverleden opbouwt. Als het account nieuw is, liggen de limieten mogelijk lager dan het volume van de campagne vraagt. Controleer vóór het plannen de huidige dagelijkse limiet voor berichten van het account en segmenteer de lijst, zodat de contacten met de hoogste prioriteit het bericht in de eerste batch krijgen. Volg bezorging en blokkades tijdens het versturen en pauzeer als het aantal blokkades boven het normale niveau komt, omdat dat de kwaliteitsbeoordeling beïnvloedt.