Deze handleiding laat zien hoe je je Quickchat AI Agent integreert met WhatsApp. Het proces is verdeeld in 2 eenvoudige stappen:
- Stap 0 - Vereisten
- Stap 1 - WhatsApp koppelen
Als je problemen hebt met de integratie of hulp nodig hebt, ga dan naar de sectie Probleemoplossing en FAQ’s of neem contact met ons op.
Bekijk de video
Stap 0 - Vereisten
A. Zakelijk telefoonnummer
Bepaal welk telefoonnummer je voor WhatsApp gebruikt. Je kunt meer lezen in de WhatsApp-documentatie of de FAQ’s hieronder volgen:
Welk nummer kan worden gebruikt in WhatsApp Cloud API?
- Je moet een speciaal zakelijk telefoonnummer gebruiken dat sms’jes of spraakoproepen kan ontvangen voor verificatie.
- Het nummer moet geldig zijn, van jou zijn en een land- en netnummer hebben.
Kan ik een nummer gebruiken dat al in WhatsApp Messenger wordt gebruikt?
- Nee. Je kunt dit nummer blijven gebruiken voor oproepen en sms’jes, maar niet in WhatsApp Messenger.
- Als het nummer al in WhatsApp Messenger wordt gebruikt, verwijder het dan eerst. Vergeet niet een back-up van je WhatsApp-chatgeschiedenis te maken.
- Geblokkeerde nummers moeten worden gedeblokkeerd voordat je ze registreert.
Kan ik een nummer gebruiken dat al door WhatsApp Business App wordt gebruikt?
- Ja. Als je nummer momenteel in de WhatsApp Business App wordt gebruikt, kun je het mogelijk onboarden naar de Cloud API zonder het app-account te verwijderen. Lees meer over Coexistence-onboarding in de Meta-documentatie.
Kan ik een nieuw telefoonnummer gebruiken?
- Ja, als je je huidige nummer liever niet gebruikt, neem dan een nieuw nummer (fysieke simkaart of virtueel nummer). Je kunt een virtueel telefoonnummer kopen bij diensten zoals Hushed.
B. Bedrijfsgegevens
Houd deze gegevens klaar (je voert ze in tijdens de Meta-integratiestroom):
- Bedrijfsnaam
- Bedrijfswebsite
- Bedrijfscategorie
- Bedrijfsbeschrijving
Ook als sommige velden optioneel lijken, vul ze nauwkeurig in. Ontbrekende of onjuiste informatie kan goedkeuring vertragen of accountbeperkingen veroorzaken.
Stap 1 - WhatsApp koppelen
Sinds onze laatste update koppel je met één klik. Er is geen aparte tweede stap meer: Meta’s eigen Embedded Signup-wizard begeleidt je bij het maken van een nieuw WhatsApp Business Account en nummer, of bij het kiezen van een account dat je al hebt, en Quickchat AI doet de rest.
Open de Quickchat AI App → External Apps → WhatsApp → klik op de knop Connect WhatsApp en volg de Meta-pop-up:
- Log in op je Meta (Facebook)-account.
- Bekijk de machtigingen die je met Quickchat AI deelt (toegang tot WhatsApp Business-account en toegang tot Business-portfolio) en ga verder.
- Geef nauwkeurige bedrijfsgegevens op (Business Portfolio, Business Name, Business Website, Country, enz.).
- Maak of selecteer je WhatsApp Business Account.
- Kies een WhatsApp Business-weergavenaam en -categorie.
- Voeg je zakelijke telefoonnummer toe en verifieer het via sms/spraak zoals gevraagd.
- Klik op Confirm om Quickchat AI de vereiste toegang te geven.
- Wanneer Meta bevestigt dat de configuratie is voltooid, klik je op Finish. De pop-up toont een Quickchat AI-bevestiging dat je WhatsApp-account is gekoppeld en sluit automatisch.
Terug in de Quickchat AI App toont het WhatsApp-paneel Connecting your WhatsApp account en wordt dit binnen ongeveer 30 seconden bijgewerkt naar Connected. Als dat niet gebeurt, klik je op Refresh Status in het paneel. Ga anders terug naar Vereisten hierboven om te controleren of je je zakelijke telefoonnummer en gegevens correct hebt opgegeven.
Connected betekent dat Quickchat AI je WhatsApp Business Account kan bereiken. Direct eronder toont het paneel wat er nog nodig is voordat klanten antwoorden krijgen:
Het Connected-paneel vermeldt wat er nog over is: hier het eerste bericht
- Waiting for your first message: stuur vanaf een andere telefoon een WhatsApp-bericht naar het weergegeven nummer en klik daarna op Refresh. Zodra er een bericht is binnengekomen, toont het paneel Messages Received naast Webhook Active en Admin Assigned.
- Display name: elk nummer dat lager in het paneel wordt vermeld, heeft de weergavenaamstatus van Meta (Approved, Pending review, Declined, Expired of No display name). Een lopende beoordeling vereist geen actie van jou en is meestal binnen enkele dagen afgerond. Bij een afgewezen, verlopen of ontbrekende weergavenaam moet je er een indienen in WhatsApp Manager.
- Meta test number: als het actieve nummer een door Meta verstrekt +1 555-nummer is, vermeldt het paneel dat. Deze nummers zijn bedoeld om dingen uit te proberen en kunnen niet naar een ander account worden verplaatst. Voeg je eigen nummer toe in WhatsApp Manager om live te gaan.
Zodra het paneel Messages Received toont, ben je live! 🎉 Klanten kunnen je WhatsApp-nummer berichten sturen en je AI Agent antwoordt automatisch.
Stuur als laatste verificatie van je integratie een tekstbericht naar het WhatsApp-nummer dat je zojuist hebt gekoppeld en klik daarna op Refresh in het paneel. Waiting for your first message verandert in Messages Received, je zou een antwoord van je AI Agent moeten krijgen en het gesprek zou moeten verschijnen in de Inbox van de Quickchat AI App. Als je setupstappen van Meta onafgemaakt laat, stuurt Quickchat AI ook een e-mail naar de accounteigenaar met de resterende stappen als herinnering.
Probleemoplossing en FAQ’s
Hoe werkt de prijsstelling van WhatsApp Business API?
- Antwoorden op door gebruikers gestarte (inkomende) klantvragen worden door WhatsApp behandeld als Service messages. Met deze berichten kunnen bedrijven inkomende klantvragen beheren, via een menselijke agent of een conversational AI-bot.
- Wanneer gebruikers een bedrijf een bericht sturen, opent dit een 24-uursvenster voor klantenservice waarin bedrijven kunnen reageren met serviceberichten, zonder kosten. Dit venster wordt bij elk gebruikersbericht opnieuw ingesteld.
- Buiten 24 uur moet je goedgekeurde Message Templates (Marketing, Utility, Authentication, enz.) gebruiken en per bericht betalen volgens de berichttarieven van WhatsApp Business Platform.
- Gesprekken worden door Meta gecategoriseerd en gefactureerd. Zorg dat je WhatsApp Business Account een geldige betaalmethode heeft voor door het bedrijf geïnitieerde/templateberichten.
De Connect WhatsApp-knop werkt niet. Ik zie de Meta-pop-up niet.
- Als je browser de pop-up blokkeert, toont de app een bericht waarin je wordt gevraagd pop-ups toe te staan. Schakel pop-up- en trackerblockers in je browser uit, vernieuw de website en probeer het opnieuw. Als dat niet helpt, probeer dan een andere browser.
Nummerverificatie is mislukt.
- Zorg dat het nummer sms’jes/spraakoproepen kan ontvangen en niet wordt geblokkeerd door een actief registratiepad waarvan Meta niet toestaat dat het naast elkaar bestaat. Als het nummer in de Business App wordt gebruikt, probeer dan onboarding via Coexistence.
Meta zegt dat mijn setup niet is voltooid, of het paneel toont een waarschuwing.
- Lees eerst de kaart onder Connected: deze noemt het nummer waarop je AI Agent antwoordt en geeft aan of Meta de weergavenaam nog beoordeelt, of het een Meta-testnummer is, of dat het eerste bericht nog niet is binnengekomen. Elke kaart linkt naar de juiste plaats in WhatsApp Manager.
- Als de waarschuwing over de verbinding zelf gaat, klik dan op Reconnect WhatsApp in het paneel. Dit lost de meeste gevallen op.
- Als dat niet werkt, is je nummer mogelijk gekoppeld aan een andere provider (Meta staat slechts één partner per WhatsApp-account tegelijk toe). Volg de instructies op het scherm om Quickchat AI als partner toe te voegen in Meta Business-instellingen en klik daarna op Refresh Status.
Ik heb het verkeerde account gekoppeld.
- Reconnect behoudt het account dat al is gekoppeld. Als je wilt wisselen, klik je op Disconnect in het WhatsApp-paneel, daarna opnieuw op Connect WhatsApp en kies je het juiste Meta Business-account en WhatsApp Account in het venster van Meta.
Berichten verschijnen niet in de Quickchat AI Inbox.
- Controleer of de pop-up de eindbevestiging toonde dat je WhatsApp-account was gekoppeld.
- Controleer nogmaals of je het bedoelde WhatsApp Account hebt gekoppeld en of de juiste AI Agent is geselecteerd.
- De kaart Waiting for your first message noemt het nummer waarop je AI Agent antwoordt. Zorg dat je precies dat nummer hebt bericht en dat het in het paneel is ingeschakeld, en klik daarna op Refresh.
- Als je berichten na 24 uur verstuurt zonder een gebruikersbericht, gebruik dan goedgekeurde templates en zorg dat er een betaalmethode is ingesteld in WhatsApp Manager.
De WhatsApp-antwoorden van mijn AI worden niet verzonden.
- Quickchat AI toont een melding “WhatsApp replies are failing” in het WhatsApp-paneel en een notificatie op je dashboard. Veelvoorkomende oplossingen: voltooi goedkeuring van de weergavenaam in WhatsApp Manager; als de verbinding is verlopen of ingetrokken, klik je op Reconnect; als Meta je nummer heeft beperkt vanwege kwaliteit of beleid, controleer dan de status in WhatsApp Manager. De melding verdwijnt zodra een antwoord weer succesvol wordt verzonden.
Templateberichten of door het bedrijf geïnitieerde berichten mislukken.
- Controleer of je Message Templates goedgekeurd zijn en je betaalmethode actief is in WhatsApp Manager.
- Nieuwe afzenders beginnen met berichtenlimieten die worden opgeschaald op basis van kwaliteit en verificatie. Als je limieten bereikt voor door het bedrijf geïnitieerde berichten, bekijk dan Meta’s richtlijnen voor Messaging Limits.
- Controleer berichtenlimieten en kwaliteitsbeoordeling in WhatsApp Manager als de aflevering wordt beperkt.
Hoe maak ik mijn eigen WhatsApp-link en knop “Chat on WhatsApp”?
Hoe maak ik mijn eigen WhatsApp-QR-code?
- Ga naar WhatsApp Manager → Phone numbers → selecteer je zakelijke telefoonnummer → Message links → Create Message Link.
- Je kunt deze ook vinden in je mobiele WhatsApp Business-app. Volg deze WhatsApp-handleiding.
Hulp nodig?
Chat met de Support AI van Quickchat op WhatsApp:
📱 +1 302-405-9992: Start een chat
Of scan de QR-code:
