Een Typebot-flow op WhatsApp draaien met Coexistence

Welke velden in Typebot nemen waarden over van het verbonden nummer?

De WhatsApp-wizard van Typebot, onder het tabblad Share van een bot, vraagt om vier dingen: een app secret, een System User Token, een WhatsApp Business Account ID en een Phone number ID.

Drie daarvan komen rechtstreeks uit de verbinding. Het dashboard toont de WABA-id, de id van het telefoonnummer en het toegangstoken van het nummer, en de tool get_api_credentials geeft dezelfde waarden terug als een assistent ze voor je ophaalt. Plak ze in de bijbehorende velden.

Het app secret laat je leeg. Typebot gebruikt het voor één ding bij binnenkomend verkeer: de header X-Hub-Signature-256 controleren die Meta aan elke levering toevoegt. Bij een nummer dat via een Tech Provider is verbonden, ondertekent Meta met het app secret van de provider, dat nooit wordt gedeeld. Elke waarde die je daar invult, laat Typebot dus elk echt bericht afwijzen. Met een leeg veld slaat Typebot die controle over en accepteert het de levering.

Waar komen de callback-URL en het verify-token van Typebot terecht?

In de webhook-bestemming van het nummer, niet in het dashboard van een Meta-app.

De wizard van Typebot zegt dat je de Callback URL en het Verify Token in de WhatsApp-instellingen van je eigen Meta-app plakt. Bij Coexistence via EasyCoexistence is er geen app van jou bij betrokken: Meta stuurt de gebeurtenissen van het nummer naar de bestemming die op de verbinding is ingesteld. Kopieer dus beide waarden uit de laatste stap van Typebot en stel ze in als bestemming, in het dashboard of met set_webhook_destination.

Daarna stuurt Meta zijn verificatie-GET naar Typebot, antwoordt Typebot met de challenge, en vanaf dat moment bereikt elk bericht aan het nummer de bot. Het verify-token van Typebot is eenmalig: het wordt uit de database van Typebot verwijderd zodra een verificatie slaagt. Stel je de bestemming later opnieuw in, genereer dan eerst een nieuw token door de wizard opnieuw te doorlopen.

Wat doet de bot met het venster van 24 uur?

Typebot antwoordt mensen die zelf hebben geschreven, waardoor bijna elk bericht binnen het servicevenster voor klanten blijft. Meta opent een venster van 24 uur telkens wanneer een klant schrijft, en daarbinnen kan elk type servicebericht zonder template worden verstuurd. Een bot die alleen antwoordt, is dus het makkelijke geval.

De randgevallen zijn flows die wachten. Een Wait-blok, of een sessie die hervat nadat de klant langer dan een dag stil was, probeert een bericht met vrije tekst buiten het venster te sturen, en Meta weigert dat met fout 131047. De time-out voor sessieverloop van Typebot, standaard 4 uur en instelbaar tot 48, bepaalt wanneer een terugkerende klant een nieuwe chat begint, niet of Meta het bericht accepteert.

Omdat dit Coexistence is, ziet het team elk gesprek nog steeds in de WhatsApp Business-app en kan het vanaf de telefoon ingrijpen wanneer de bot niet moet antwoorden.

Veelgemaakte fouten

• Een Meta app secret in Typebot plakken. Leveringen zijn ondertekend met het secret van de Tech Provider, dus Typebot wijst elk bericht af vanwege een ongeldige handtekening.
• Een oud verify-token van Typebot hergebruiken. Het wordt na één geslaagde verificatie verwijderd, dus voor een nieuwe bestemming heb je een vers token uit de wizard nodig.
• De callback-URL delen. Zonder handtekeningcontrole laat alleen de kennis van de URL een verzoek binnen, dus behandel hem als een wachtwoord.

Veelgestelde vragen

Lees verder