WhatsApp koppelen

Met de WhatsApp-koppeling komt elk WhatsApp-bericht van een klant als ticket in je Inbox, naast je e-mail. Je antwoordt vanuit het ticket en de klant krijgt het antwoord gewoon in WhatsApp.

Teamdock werkt met de WhatsApp Business Cloud API van Meta. Je hebt daarvoor een Meta-ontwikkelaarsaccount met een WhatsApp Business-app en een telefoonnummer dat aan die app gekoppeld is.

Wat je nodig hebt uit Meta

Veld in Teamdock	Waar je het vindt
Verify token	Een zelfgekozen geheime tekst. Je vult dezelfde tekst in bij Meta als je de webhook instelt.
Access token	Het token van je WhatsApp Business-app in Meta (bij voorkeur een permanent token van een systeemgebruiker). Nodig om te kunnen antwoorden.
Phone number ID	Het ID van je WhatsApp-telefoonnummer in de WhatsApp-instellingen van je Meta-app. Dit is niet het telefoonnummer zelf.

Instellen

Ga naar Instellingen → Berichten → WhatsApp.
Vul het Verify token, het Access token en het Phone number ID in.
Klik bovenaan op Opslaan.
Stel in je Meta-app de webhook in voor WhatsApp. Gebruik als callback-URL https://<jouwnaam>.teamdock.ai/api/tickets/webhooks/whatsapp (met de naam van je eigen workspace) en als verify token dezelfde tekst als in stap 2. Abonneer de webhook op messages.
Neem contact op met Teamdock-support om de koppeling af te ronden. Teamdock controleert of elk binnenkomend bericht echt van Meta komt, en daarvoor moet het App secret van je Meta-app aan onze kant worden ingesteld.

Bovenaan de pagina zie je de status:

Verify token ontbreekt: er is nog niets ingesteld.
Ontvangen klaar: Teamdock kan berichten ontvangen, maar er is nog geen access token om te antwoorden.
Ontvangen en verzenden: alles staat klaar.

Testen

Vul onder WhatsApp testnummer een nummer in met landcode en zonder plus of nullen ervoor (bijv. 31612345678), pas eventueel het Testbericht aan en klik Verstuur. Komt het bericht aan, dan werkt verzenden.

Werken met WhatsApp-tickets

WhatsApp-tickets staan in dezelfde Inbox als e-mail. Kies bij Kanaal voor WhatsApp om alleen die te zien. Bij de afzender zie je het telefoonnummer van de klant. Antwoorden werkt hetzelfde als bij e-mail; zie Werken met tickets.

Problemen oplossen

Meta kan de webhook niet verifiëren. Controleer of het verify token in Meta precies gelijk is aan dat in Teamdock, en of je eerst op Opslaan hebt geklikt.
Berichten komen niet binnen. Controleer of de webhook in Meta is geabonneerd op messages, en of de koppeling door support is afgerond (stap 5).
Antwoorden komt niet aan. Controleer het Access token en het Phone number ID, en of het laatste bericht van de klant minder dan 24 uur oud is.