WhatsApp

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

• 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

Play

Stap 0: vereisten

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 WhatsApp Messenger wordt gebruikt?

• Nee. Je kunt dit nummer blijven gebruiken voor bellen en sms’en, maar niet in WhatsApp Messenger.
• Wordt het nummer al in WhatsApp Messenger gebruikt, verwijder het daar dan eerst. Vergeet niet een back-up van je WhatsApp-chatgeschiedenis te maken.
• Geblokkeerde nummers moeten vóór registratie worden gedeblokkeerd.

Kan ik een nummer gebruiken dat al in de WhatsApp Business App wordt gebruikt?

• De huidige verbindingsprocedure van Quickchat AI biedt geen geverifieerde Coexistence-werkwijze voor een bestaand nummer uit de WhatsApp Business App. Meta beschrijft hoe co-existentie in ondersteunde integraties werkt in de handleiding voor Business App-onboarding.
• Wil je je bestaande nummer, Business App-account en chatgeschiedenis behouden, mail dan support@quickchat.ai voordat je verdergaat. Verwijder of ontkoppel het Business App-account niet en migreer het nummer niet als stap om een probleem op te lossen.

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

Houd deze gegevens bij de hand. Je vult ze tijdens het verbinden met Meta in:

• Bedrijfsnaam
• Bedrijfswebsite
• Bedrijfscategorie
• Bedrijfsbeschrijving

Opgepast

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

Open de Quickchat AI-app → External Apps → WhatsApp → klik op Connect WhatsApp 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.

1. Log in op je Meta-account (Facebook).
2. Bekijk welke machtigingen je met Quickchat AI deelt (toegang tot het WhatsApp Business-account en het bedrijfsportfolio) en ga verder.
3. Vul de juiste bedrijfsgegevens in (bedrijfsportfolio, bedrijfsnaam, website, land enzovoort).
4. Maak of selecteer je WhatsApp Business-account.
5. Kies een weergavenaam en categorie voor WhatsApp Business.
6. Voeg je zakelijke telefoonnummer toe en verifieer het via sms of een oproep, zoals aangegeven.
7. Klik op Confirm om Quickchat AI de vereiste toegang te geven.
8. 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.

Geeft Meta Quickchat AI toegang tot meerdere accounts, dan toont het WhatsApp-paneel Choose your WhatsApp Business Account in plaats van direct te verbinden. Kies het account waarop je AI Agent moet antwoorden en klik op Use this account. Maak je opnieuw verbinding, dan blijven je huidige WhatsApp-instellingen ongewijzigd totdat je bevestigt.

Terug in de Quickchat AI-app toont het WhatsApp-paneel Finish setup 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:

• Waiting for your first message: stuur vanaf een andere telefoon een WhatsApp-bericht naar het getoonde nummer en klik op Refresh. Zorg dat je het zakelijke nummer gebruikt waar je klanten naartoe zullen berichten.
• Waiting for the AI reply to be delivered: 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 reply delivered: WhatsApp heeft bevestigd dat het AI-antwoord op een binnenkomend bericht via dit zakelijke nummer is afgeleverd.
• Verification needs attention: 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 (Approved, Pending review, Declined, Expired of No display name). 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.

Tip

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 Refresh. 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.

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 Connect WhatsApp 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 Try again. Je kunt ook op Continue on Meta in this tab klikken om dezelfde procedure zonder pop-up af te ronden.

Quickchat couldn’t confirm the WhatsApp connection

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.

1. 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.
2. Klik op Try again. Stoort een blokkering het Meta-venster, gebruik dan een privévenster met gepauzeerde extensies of klik op Continue on Meta in this tab.
3. Is het nummer actief in WhatsApp Messenger, verwijder het daar dan eerst of gebruik een ander nummer. Is het actief in de WhatsApp Business App, stop dan hier en mail support@quickchat.ai voordat je verdergaat. De huidige Quickchat AI-procedure biedt geen geverifieerde Coexistence-werkwijze. Verwijder of ontkoppel het Business App-account niet en migreer het nummer niet om deze melding op te lossen.
4. Gebruikt het WhatsApp Business-account Aircall, Twilio, 360dialog, MessageBird of een andere provider, voeg Quickchat AI dan als partner toe in Meta Business Settings:
   1. Open Meta Business Settings en ga naar Accounts → WhatsApp Accounts.
   2. Selecteer het WhatsApp Business-account, open Partners en klik op Add Partners.
   3. Voer het Business ID van Quickchat AI in: 270696274483463.
   4. 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.
• Een algemene melding Ineligible of tooltip This number can’t be shared with this app stelt de oorzaak niet vast en bevestigt niet of aan Meta’s co-existentievereisten is voldaan. Mail support@quickchat.ai met de exacte melding en de stap waarop deze verscheen.
• Wordt het nummer in de WhatsApp Business App gebruikt en wil je dat account en de geschiedenis behouden, neem dan contact op met support voordat je verdergaat. Verwijder of ontkoppel het account niet en migreer het nummer niet om de fout weg te krijgen.

Ik heb het verkeerde account verbonden.

• Reconnect behoudt het account dat al verbonden is. Wil je de AI Agent naar een ander WhatsApp Business-account verplaatsen, klik dan op Disconnect in het WhatsApp-paneel en daarna opnieuw op Connect WhatsApp. Kies in het Meta-venster het juiste Meta Business-account en WhatsApp-account.

We could not tell which WhatsApp Business Account to connect

• 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 Waiting for your first message 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 Refresh.
• 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 External 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 Reconnect 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 ontkoppelen om het instellen te herstellen?

• Nee. Verwijder of ontkoppel je Business App-account niet en migreer het nummer niet om een probleem op te lossen. De huidige verbindingsprocedure van Quickchat AI biedt geen geverifieerde Coexistence-werkwijze die je bestaande app-instellingen en geschiedenis behoudt.
• Mail support@quickchat.ai voordat je een actief Business App-account wijzigt. Meta’s handleiding voor Business App-onboarding beschrijft co-existentie voor ondersteunde integraties, maar bevestigt niet dat dit voor jouw Quickchat AI-configuratie beschikbaar is.

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?

Chat met Quickchats Support AI op WhatsApp:
📱 +1 302-405-9992: Begin een chat

Of scan de QR-code: