Verbind je Quickchat AI Agent met WhatsApp Business, ook met een nummer dat je al in de WhatsApp Business-app gebruikt. Deze handleiding behandelt de vereisten, het instellen en live gaan met WhatsApp-berichten.
Deze handleiding laat zien hoe je je Quickchat AI Agent met WhatsApp integreert. Het proces bestaat uit 2 eenvoudige stappen:
- Stap 0: vereisten
- Stap 1: WhatsApp verbinden
Heb je problemen met de integratie of hulp nodig? Ga naar Problemen oplossen en veelgestelde vragen of neem contact op.
Optionele hulpmiddelen voor het instellen
Section titled “Optionele hulpmiddelen voor het instellen”-
Controleer de vereisten voor WhatsApp. Vergelijk de opgegeven gegevens over het nummer en de provider met de gedocumenteerde vereisten. Dit opent of verbindt geen WhatsApp-account.
-
Controleer een WhatsApp-servicevenster. Controleer het venster van 24 uur op basis van opgegeven tijdstippen van binnenkomende berichten en antwoorden, inclusief tijdzone-offsets. Dit controleert geen sjablonen, toestemming of accountmachtigingen en stuurt geen bericht.
-
Schat gebruikskosten. Bereken Quickchat AI-modelcredits en een afzonderlijk totaal voor opgegeven kostenposten. Dit zoekt geen providertarieven op, combineert geen credits met geldbedragen en controleert je account niet.
Bekijk de video
Section titled “Bekijk de video”Stap 0: vereisten
Section titled “Stap 0: vereisten”A. Zakelijk telefoonnummer
Section titled “A. Zakelijk telefoonnummer”Bepaal welk telefoonnummer je voor WhatsApp gebruikt. Lees meer in de WhatsApp-documentatie of bekijk de veelgestelde vragen hieronder:
Welk nummer kan ik in de WhatsApp Cloud API gebruiken?
- Je hebt een apart zakelijk telefoonnummer nodig dat sms-berichten of telefoongesprekken 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 persoonlijke WhatsApp (WhatsApp Messenger) wordt gebruikt?
- Nee. Je kunt dit nummer blijven gebruiken voor bellen en sms’en, maar niet in persoonlijke WhatsApp.
- Om het te koppelen, verwijder je het WhatsApp-account op dit nummer, wacht je een paar minuten en koppel je het daarna. Als je het account verwijdert, wordt de chatgeschiedenis gewist, dus maak eerst een back-up van je WhatsApp-chatgeschiedenis. Wil je je chats behouden, koppel dan een ander nummer.
- Geblokkeerde nummers moeten vóór registratie worden gedeblokkeerd.
Kan ik een nummer gebruiken dat al in de WhatsApp Business-app wordt gebruikt?
- Ja (bèta). Je kunt het koppelen en de WhatsApp Business-app op je telefoon blijven gebruiken. Je AI Agent beantwoordt klanten op hetzelfde nummer en je chats blijven in de app. Meta noemt dit Coexistence. Zie De WhatsApp Business-app blijven gebruiken (Coexistence).
- Verwijder je WhatsApp Business-account niet en migreer het nummer niet om het te koppelen.
Kan ik een nieuw telefoonnummer gebruiken?
- Ja. Wil je je huidige nummer niet gebruiken, neem dan een nieuw nummer (fysieke simkaart of virtueel nummer). Je kunt een virtueel telefoonnummer kopen bij diensten zoals Hushed.
B. Bedrijfsgegevens
Section titled “B. Bedrijfsgegevens”Houd deze gegevens bij de hand. Je vult ze tijdens het verbinden met Meta in:
- Bedrijfsnaam
- Bedrijfswebsite
- Bedrijfscategorie
- Bedrijfsbeschrijving
Ook als sommige velden optioneel lijken, vul ze nauwkeurig in. Ontbrekende of onjuiste gegevens kunnen goedkeuring vertragen of tot accountbeperkingen leiden.
Stap 1: WhatsApp verbinden
Section titled “Stap 1: WhatsApp verbinden”Open de Quickchat AI-app → Kanalen → Externe apps → WhatsApp. Kies onder Welk nummer koppel je? de optie die bij je nummer past:
- Een nieuw nummer dat niet op WhatsApp zit: volg de stappen hieronder.
- Een nummer dat al in de WhatsApp Business-app wordt gebruikt: volg De WhatsApp Business-app blijven gebruiken (Coexistence).
- Een nummer dat al in persoonlijke WhatsApp wordt gebruikt: verwijder eerst het WhatsApp-account op dat nummer (dit wist de chatgeschiedenis), wacht een paar minuten en volg daarna de stappen hieronder. Of gebruik een ander nummer.
Klik daarna op WhatsApp koppelen en volg de stappen in het Meta-venster:
Je kunt ook beginnen vanuit ChatGPT, Claude of een andere verbonden AI-app: vraag om een link om deze Agent met WhatsApp te verbinden. De link is 10 minuten geldig, werkt één keer en is alleen bruikbaar voor het Quickchat-account dat hem heeft aangevraagd. Open hem in een browser waarin je op dat account bent ingelogd, volg de Meta-procedure en rond een eventuele account- of nummerkeuze af wanneer Quickchat weer opent. Vraag daarna je AI-app de instellingen te controleren en stuur een echt WhatsApp-bericht om te bevestigen dat het AI-antwoord aankomt. Test elk actief nummer als je er meerdere verbindt. Je keurt Meta-toegang in de browser goed, zonder tokens in de chat te delen.
- Log in op je Meta-account (Facebook).
- Bekijk welke machtigingen je met Quickchat AI deelt (toegang tot het WhatsApp Business-account en het bedrijfsportfolio) en ga verder.
- Vul de juiste bedrijfsgegevens in (bedrijfsportfolio, bedrijfsnaam, website, land enzovoort).
- Maak of selecteer je WhatsApp Business-account.
- Kies een weergavenaam en categorie voor WhatsApp Business.
- Voeg je zakelijke telefoonnummer toe en verifieer het via sms of een oproep, zoals aangegeven.
- Klik op Confirm om Quickchat AI de vereiste toegang te geven.
- Klik op Finish wanneer Meta bevestigt dat het instellen is voltooid. Het venster toont een Quickchat AI-bevestiging dat je WhatsApp-account verbonden is en sluit automatisch.
Wordt het nummer in de WhatsApp Business App gebruikt, kies dan in het Meta-venster ervoor om je bestaande WhatsApp Business App te verbinden en bevestig daarna in de app wanneer daarom wordt gevraagd (bèta).
Geeft Meta Quickchat AI toegang tot meerdere accounts, dan toont het WhatsApp-paneel Kies je WhatsApp Business-account in plaats van direct te verbinden. Kies het account waarop je AI Agent moet antwoorden en klik op Dit account gebruiken. Maak je opnieuw verbinding, dan blijven je huidige WhatsApp-instellingen ongewijzigd totdat je bevestigt.
Terug in de Quickchat AI-app toont het WhatsApp-paneel Installatie afronden totdat een geslaagde uitwisseling op je eigen zakelijke nummer is geverifieerd. Is het paneel na ongeveer 30 seconden niet bijgewerkt, klik dan op het vernieuwingsicoon.
Verbinding met Meta en het ontvangen van een bericht zijn slechts een deel van het instellen. Het paneel toont de volgende stap voor elk ingeschakeld nummer:
- Wacht op je eerste bericht: stuur vanaf een andere telefoon een WhatsApp-bericht naar het getoonde nummer en klik op Vernieuwen. Zorg dat je het zakelijke nummer gebruikt waar je klanten naartoe zullen berichten.
- Wacht op aflevering van het AI-antwoord: Quickchat heeft je bericht ontvangen, maar WhatsApp heeft de aflevering van het AI-antwoord nog niet bevestigd. Controleer of het antwoord op de andere telefoon is aangekomen. Zo niet, controleer dan je AI-credits en eventuele waarschuwingen in het paneel en stuur nog een testbericht.
- AI-antwoord afgeleverd: WhatsApp heeft bevestigd dat het AI-antwoord op een binnenkomend bericht via dit zakelijke nummer is afgeleverd.
- Verificatie vereist aandacht: los de verbindingswaarschuwingen op, houd het gewenste nummer ingeschakeld en stuur een nieuw testbericht.
- Display name: elk nummer lager in het paneel toont de Meta-status van zijn weergavenaam (Goedgekeurd, Wacht op beoordeling, Afgewezen, Verlopen of Geen weergavenaam). Een lopende beoordeling vereist geen actie en duurt meestal enkele dagen. Bij een afgewezen, verlopen of ontbrekende weergavenaam wordt je gevraagd er een in WhatsApp Manager in te dienen.
- Meta test number: +1 555-nummers van Meta en sandboxnummers verifiëren de activering van je zakelijke nummer niet. Voeg je eigen nummer toe in WhatsApp Manager, schakel het in Quickchat in en test dat nummer.
Het paneel toont Live zodra elk ingeschakeld zakelijk nummer een geverifieerde uitwisseling heeft en de verbindingscontroles in orde zijn. Schakel je meerdere zakelijke nummers in, test ze dan allemaal. Een geslaagde uitwisseling met een testnummer, een verstuurd sjabloon of een melding over het berichtentegoed rondt deze controle niet af.
Houd de integratie ingeschakeld tijdens het testen. Stuur vanaf een andere telefoon een bericht naar elk bedoeld zakelijk nummer, bevestig dat het AI-antwoord aankomt en klik op Vernieuwen. Het gesprek hoort ook in de Inbox van de Quickchat AI-app te verschijnen. Een bestaande verbinding kan om een nieuwe testuitwisseling vragen om aflevering te verifiëren. Ze kan berichten blijven ontvangen en beantwoorden terwijl je deze stap afrondt.
Zijn er nog Meta-onboardingstappen open, rond die dan af via Setup guidance in WhatsApp Manager. Quickchat AI mailt de accounteigenaar ook een herinnering als Meta’s instelstappen niet afgerond zijn.
De WhatsApp Business-app blijven gebruiken (Coexistence)
Section titled “De WhatsApp Business-app blijven gebruiken (Coexistence)”Je kunt een nummer koppelen dat al in de WhatsApp Business-app wordt gebruikt en de app op je telefoon blijven gebruiken. Meta noemt dit Coexistence. In Quickchat AI is dit in bèta. Je gebruikt de app zoals voorheen, terwijl je AI Agent klanten op hetzelfde nummer beantwoordt.
Voordat je begint
Section titled “Voordat je begint”- Werk de WhatsApp Business-app op je telefoon bij naar versie 2.24.17 of nieuwer.
- Start het instellen zo mogelijk op een computer en houd de telefoon met de WhatsApp Business-app bij de hand. Je bevestigt de koppeling in de app.
Het nummer koppelen
Section titled “Het nummer koppelen”- Open in de Quickchat AI-app Kanalen → Externe apps → WhatsApp.
- Kies onder Welk nummer koppel je? de optie Een nummer dat al in de WhatsApp Business-app wordt gebruikt. Het paneel toont De WhatsApp Business-app blijven gebruiken (bèta).
- Klik op WhatsApp koppelen.
- Klik in het venster van Meta op Continue. Biedt Meta aan je bestaande WhatsApp Business-app te koppelen, kies dan die optie. Kies anders Enter a new phone number en typ het nummer dat je in de WhatsApp Business-app gebruikt.
- Tik op Connect en daarna op Confirm wanneer de WhatsApp Business-app op je telefoon daarom vraagt.
- Meta kan vragen of je je chatgeschiedenis wilt delen. Dit is optioneel. Quickchat AI importeert geen eerdere chats: de Inbox begint vanaf het moment dat je koppelt en je eerdere chats blijven in de app.
Stuur daarna vanaf een andere telefoon een testbericht, zoals hierboven beschreven, totdat het paneel Live toont.
Hoe antwoorden werken
Section titled “Hoe antwoorden werken”- Berichten van klanten en de antwoorden van je AI Agent verschijnen zowel in de WhatsApp Business-app als in de Inbox van Quickchat AI.
- Als je vanuit de app op een klant reageert, stopt de AI Agent met antwoorden in die chat.
- Is het 4 uur stil geweest in de chat (van niemand berichten), dan start het volgende klantbericht een nieuwe gespreksronde en beantwoordt de AI Agent het weer. Die 4 uur liggen vast en kun je niet wijzigen.
- Je kunt een chat op elk moment teruggeven door hem in de Inbox aan de AI Agent toe te wijzen.
Beperkingen bij deze manier van koppelen
Section titled “Beperkingen bij deze manier van koppelen”Meta past deze beperkingen toe op een nummer dat via Coexistence is gekoppeld:
- Verzendlijsten zijn uitgeschakeld in de WhatsApp Business-app.
- Groepschats worden niet gesynchroniseerd.
- WhatsApp voor Windows wordt niet ondersteund.
- Open je de WhatsApp Business-app op je telefoon ongeveer 14 dagen niet, dan ontkoppelt Meta het nummer.
Vraagt Meta je om het nummer vrij te maken of je WhatsApp Business-account te verwijderen, doe dat dan niet. Mail in plaats daarvan support@quickchat.ai.
Problemen oplossen en veelgestelde vragen
Section titled “Problemen oplossen en veelgestelde vragen”Hoe werkt de prijsstelling van de WhatsApp Business API?
- WhatsApp behandelt antwoorden op door gebruikers gestarte (inkomende) klantvragen als serviceberichten. Hiermee kunnen bedrijven inkomende klantvragen afhandelen, zowel via medewerkers als via een conversationele AI-bot.
- Wanneer een gebruiker een bedrijf een bericht stuurt, opent dat een klantenservicevenster van 24 uur. Daarbinnen kan het bedrijf gratis met serviceberichten reageren. Het venster begint opnieuw bij elk gebruikersbericht.
- Buiten die 24 uur moet je goedgekeurde berichtsjablonen gebruiken (Marketing, Utility, Authentication enzovoort) en per bericht betalen volgens de WhatsApp Business Platform-tarieven.
- Meta categoriseert en factureert de gesprekken. Zorg dat je WhatsApp Business-account een geldige betaalmethode heeft voor door het bedrijf gestarte berichten en sjabloonberichten.
De knop WhatsApp koppelen werkt niet. Ik zie het Meta-venster niet.
- Blokkeert je browser de pop-up, sta pop-ups voor de Quickchat AI-app dan toe en klik op Opnieuw proberen. Je kunt ook op Doorgaan op Meta in dit tabblad klikken om dezelfde procedure zonder pop-up af te ronden.
Quickchat kon de WhatsApp-verbinding niet bevestigen
Quickchat toont deze herstelmelding wanneer het Meta-venster geen resultaat teruggeeft en Quickchat de verbinding nog steeds niet kan verifiëren. Dit bewijst niet dat Meta niets heeft gewijzigd.
- Controleer of je beheerder bent van het Meta-bedrijf dat eigenaar is van het WhatsApp Business-account. Zo niet, vraag een beheerder dan om via diens Facebook-login verbinding te maken.
- Klik op Opnieuw proberen. Stoort een blokkering het Meta-venster, gebruik dan een privévenster met gepauzeerde extensies of klik op Doorgaan op Meta in dit tabblad.
- Is het nummer actief in persoonlijke WhatsApp, verwijder dan het WhatsApp-account op dat nummer (dit wist de chatgeschiedenis), wacht een paar minuten en probeer het opnieuw, of gebruik een ander nummer. Is het actief in de WhatsApp Business-app, dan hoef je niets te verwijderen: koppel opnieuw, kies Een nummer dat al in de WhatsApp Business-app wordt gebruikt en kies in het venster van Meta voor het koppelen van je bestaande WhatsApp Business-app. Zie De WhatsApp Business-app blijven gebruiken (Coexistence).
- Gebruikt het WhatsApp Business-account Aircall, Twilio, 360dialog, MessageBird of een andere provider, voeg Quickchat AI dan als partner toe in Meta Business Settings:
- Open Meta Business Settings en ga naar Accounts → WhatsApp Accounts.
- Selecteer het WhatsApp Business-account, open Partners en klik op Add Partners.
- Voer het Business ID van Quickchat AI in:
270696274483463. - Geef de machtiging Manage WhatsApp accounts, keer terug naar Quickchat AI en vernieuw de status.
Ontkoppel de andere provider alleen als Meta beide partners niet op dat account toestaat. Twijfel je, neem dan contact op met support voordat je een actieve berichtenprovider ontkoppelt.
De nummerverificatie is mislukt.
- Controleer of het nummer sms-berichten of telefoongesprekken kan ontvangen.
- Wordt het nummer in de WhatsApp Business-app gebruikt, koppel het dan via Coexistence en controleer of de app versie 2.24.17 of nieuwer is. Verwijder je WhatsApp Business-account niet en migreer het nummer niet om de fout weg te krijgen.
- Een algemene melding Ineligible of tooltip This number can’t be shared with this app stelt de oorzaak niet vast. Mail support@quickchat.ai met de exacte melding en de stap waarop deze verscheen.
Ik heb het verkeerde account verbonden.
- Opnieuw verbinden behoudt het account dat al verbonden is. Wil je de AI Agent naar een ander WhatsApp Business-account verplaatsen, klik dan op Verbinding verbreken in het WhatsApp-paneel en daarna opnieuw op WhatsApp koppelen. Kies in het Meta-venster het juiste Meta Business-account en WhatsApp-account.
We konden niet bepalen welk WhatsApp Business-account moest worden gekoppeld
- Je Meta-login heeft meerdere WhatsApp Business-accounts met telefoonnummers en Quickchat kon niet bepalen welk account je bedoelde. Mail support@quickchat.ai met het gewenste telefoonnummer. Wij ronden het instellen voor je af.
Berichten verschijnen niet in de Quickchat AI Inbox.
- Controleer of het venster de laatste bevestigingsmelding heeft getoond: “WhatsApp account connected!”.
- Controleer of je het bedoelde WhatsApp-account hebt gekoppeld en de juiste AI Agent geselecteerd is.
- De kaart Wacht op je eerste bericht noemt het nummer waarop je AI Agent antwoordt. Controleer of je precies dat nummer hebt bericht en of het in het paneel aanstaat. Klik daarna op Vernieuwen.
- Stuur je berichten na 24 uur zonder gebruikersbericht, gebruik dan goedgekeurde sjablonen en zorg dat er een betaalmethode is ingesteld in WhatsApp Manager.
De WhatsApp-antwoorden van mijn AI worden niet verstuurd.
Kunnen de AI-antwoorden niet worden afgeleverd, dan toont Quickchat AI de waarschuwing “WhatsApp replies are failing” in het WhatsApp-paneel onder Externe apps en een melding op je dashboard. De meest voorkomende oorzaken en oplossingen:
- Weergavenaam op een Meta-testnummer niet goedgekeurd: Meta houdt antwoorden van een door Meta verstrekt +1 555-nummer tegen totdat de weergavenaam is goedgekeurd. De waarschuwing in het paneel wordt rood en noemt het nummer. Wacht tot de beoordeling is afgerond (meestal enkele dagen). Is de naam afgewezen, dien dan een nieuwe weergavenaam in via WhatsApp Manager en stuur daarna een testbericht. Een weergavenaam die op je eigen nummer nog wordt beoordeeld, blokkeert antwoorden op zichzelf niet; het paneel toont dit als opmerking.
- Verbinding verlopen of ingetrokken: je WhatsApp-verbinding is niet meer geldig. Open het WhatsApp-paneel en klik op Opnieuw verbinden om weer antwoorden te sturen.
- Nummer beperkt: Meta heeft je nummer beperkt vanwege de kwaliteitsbeoordeling of een beleidsprobleem. Controleer de status in WhatsApp Manager om het versturen te herstellen.
- Business-account vergrendeld (fout 131031): Meta blokkeert antwoorden vanuit het WhatsApp Business-account. De afleverfout in de Inbox en het WhatsApp-paneel lichten de beperking toe. Open Business Support Home, selecteer het WhatsApp-account, kies de overtreding en klik op Request Review. Alleen via deze beoordeling heft Meta een accountvergrendeling op. Opnieuw verbinden met Quickchat heft de beperking niet op.
Andere waarschuwingen verdwijnen automatisch zodra een antwoord weer succesvol wordt verstuurd. Een waarschuwing over een accountvergrendeling blijft staan totdat een nieuw echt bezoekersbericht een volledig afgeleverd AI-antwoord krijgt. Meta kan een antwoord namelijk accepteren en het daarna alsnog laten mislukken. Zijn alleen Meta-testnummers (+1 555) actief, dan wist het volgende succesvol verstuurde AI-antwoord de waarschuwing. Support AI kan ook een recente opgeslagen fout over een accountvergrendeling uitleggen, maar historische gegevens bewijzen niet dat het account nog vergrendeld is.
Sjabloonberichten of door het bedrijf gestarte berichten mislukken.
- Controleer of je berichtsjablonen goedgekeurd zijn en je betaalmethode actief is in WhatsApp Manager.
- Nieuwe afzenders beginnen met berichtlimieten die meegroeien met kwaliteit en verificatie. Bereik je de limiet voor door het bedrijf gestarte berichten, bekijk dan Meta’s uitleg over Messaging Limits.
- Controleer bij een beperkte aflevering de berichtlimieten en kwaliteitsbeoordeling in WhatsApp Manager.
Hoe maak ik een eigen WhatsApp-link en een knop “Chat on WhatsApp”?
- Volg deze WhatsApp-handleiding.
- Of download de officiële WhatsApp-knopontwerpen en gebruik een van deze scripts op je pagina:
<!-- WhatsApp inline button --><!-- Update WHATSAPP_PHONE_NUMBER and filename/path as needed --><a aria-label="Chat on WhatsApp" href="https://wa.me/WHATSAPP_PHONE_NUMBER" target="_blank" rel="noopener noreferrer"> <img alt="Chat on WhatsApp" src="WhatsAppButtonGreenLarge.svg" style=" width: 200px; height: auto; cursor: pointer; border-radius: 12px; " /></a>of
<!-- WhatsApp floating button --><!-- Update WHATSAPP_PHONE_NUMBER and filename/path as needed --><a aria-label="Chat on WhatsApp" href="https://wa.me/WHATSAPP_PHONE_NUMBER" target="_blank" rel="noopener noreferrer" style="position: fixed; right: 20px; bottom: 20px; z-index: 9999"> <img alt="Chat on WhatsApp" src="WhatsAppButtonGreenLarge.svg" style=" width: 200px; height: auto; cursor: pointer; border-radius: 12px; box-shadow: rgba(0, 0, 0, 0.5) 0px 5px 15px 0px; transition: all 0.3s ease; " onmouseover="this.style.transform = 'scale(1.05)'" onmouseout="this.style.transform = 'scale(1)'" /></a>Hoe maak ik een eigen WhatsApp-QR-code?
- Ga naar WhatsApp Manager → Phone numbers → selecteer je zakelijke telefoonnummer → Message links → Create Message Link.
- Je kunt de code ook in de mobiele WhatsApp Business-app vinden. Volg deze WhatsApp-handleiding.
Moet ik mijn WhatsApp Business-app-account verwijderen om het instellen te herstellen?
- Nee. Je kunt een nummer uit de WhatsApp Business-app koppelen en de app blijven gebruiken. Zie De WhatsApp Business-app blijven gebruiken (Coexistence).
- Vraagt Meta je om het nummer vrij te maken of je WhatsApp Business-account te verwijderen, doe dat dan niet. Mail in plaats daarvan support@quickchat.ai.
Welke toegang krijgt Quickchat AI tot ons WhatsApp Business-account?
- Beperkte API-toegang, geen eigendom van het account. Je WhatsApp Business-account (WABA) blijft in je eigen Meta Business Manager. Binnen Meta’s WABA Sharing-model bezit jij de onderdelen en wordt Quickchat AI als partner toegevoegd. Je kunt die toegang op elk moment in Business Manager intrekken.
- Zolang de integratie actief is, kunnen we via de Cloud API berichten sturen en ontvangen en berichtgebeurtenissen via webhooks ontvangen.
- We kunnen je account niet sluiten, overdragen of van een andere merkidentiteit voorzien, je facturering niet wijzigen en je beheerders niet verwijderen.
Hulp nodig?
Section titled “Hulp nodig?”Chat met Quickchats Support AI op WhatsApp:
📱 +1 302-405-9992: Begin een chat
Of scan de QR-code:
