Koppel een Botpress-bot aan WhatsApp met Coexistence
Gebruik de WhatsApp-integratie van Botpress in Manual Configuration. Plak het toegangstoken en de Phone Number ID van het gekoppelde nummer, kies een verify token en laat App ID en Client Secret leeg. Stel daarna de webhook-URL van Botpress en dat verify token in als webhook-bestemming van het nummer, en Meta levert elk bericht aan de bot.
Het veld Client Secret van Botpress: als je het leeg laat, wordt de verificatie van de webhook-handtekening overgeslagen.
Webhookvelden waarop de handleiding van Botpress zich abonneert, waaronder berichten en statusupdates van templates.
Het servicevenster voor klanten dat een bericht van een klant opent, en waarbinnen elk servicebericht verstuurd mag worden.
Welke Botpress-configuratie werkt met een Coexistence-nummer?
Manual Configuration. De andere opties koppelen een nummer via de eigen Meta-app van Botpress. Dat is een aparte onboarding van het nummer en geen manier om een nummer te gebruiken dat al gekoppeld is.
Open in de WhatsApp-integratie de keuzelijst Configuration en kies Manual Configuration. Gevraagd worden een Verify Token, een Access Token, een Default Bot Phone Number ID en optioneel een App ID, een Client Secret en een WABA ID.
Het toegangstoken, de Phone Number ID en de WABA ID komen uit de verbinding: het dashboard toont ze en get_api_credentials geeft ze aan een assistent terug. Het verify token is een willekeurige tekenreeks die je zelf kiest. App ID en Client Secret blijven leeg. De handleiding van Botpress presenteert het secret als een veld om in te vullen, maar de integratiedefinitie markeert het als optioneel en meldt dat zonder secret de verificatie van de handtekening wordt overgeslagen. Dat is belangrijk, want Meta ondertekent elke levering met het app secret van de Tech Provider, en geen enkele klant heeft dat.
Hoe krijgt de webhook van Botpress de berichten van Meta?
Via de webhook-bestemming van het nummer. In de handleiding van Botpress plak je de webhook-URL en je verify token in de WhatsApp-configuratie van een Meta-app. Hier heb je geen eigen Meta-app: Meta stuurt de gebeurtenissen van het nummer naar de bestemming die de verbinding aanwijst. Kopieer dus de webhook-URL die Botpress voor de integratie toont en stel die, met hetzelfde verify token, in als bestemming in het dashboard of met set_webhook_destination.
Meta stuurt een verificatie-GET, Botpress beantwoordt die en de levering start. Als Botpress een handmatige configuratie opslaat, controleert het ook het token door aan Graph te vragen welke app het heeft uitgegeven. Een ongeldig of ingetrokken token faalt dus bij het opslaan en niet pas bij het eerste bericht.
De handler van Botpress verwerkt ook smb_message_echoes, de gebeurtenis die Meta stuurt wanneer iemand antwoordt vanuit de WhatsApp Business app. Een antwoord vanaf de telefoon is dus zichtbaar voor de bot en niet onzichtbaar.
| Required? | What to enter | |
|---|---|---|
| Access Token | Required | The connected number's token |
| Default Bot Phone Number ID | Required | The connected number's phone number id |
| Verify Token | Required | Any string, reused in the webhook destination |
| WABA ID | Optional | The connected number's WABA id |
| App ID and Client Secret | Optional | Leave both empty |
Wat moet de bot weten over Coexistence?
Dat er mogelijk al een mens aan het woord is. De WhatsApp Business app blijft werken op het nummer, dus een klant kan binnen dezelfde minuut een antwoord van de telefoon en van de bot krijgen. Bepaal in de flow wat er gebeurt als er een echo binnenkomt: de meeste teams zetten de bot voor dat contact een tijdje op pauze, zodat degene die heeft ingegrepen niet wordt overstemd.
Het tweede punt is timing. Een bot die binnenkomende berichten beantwoordt, werkt binnen het servicevenster van 24 uur, waarin vrije tekst is toegestaan. Een flow die een dag later iets verstuurt, zoals een follow-up of een herinnering, heeft een goedgekeurd template nodig, en vrije tekst levert daar foutcode 131047 op. De handleiding van Botpress abonneert zich precies voor dit soort proactieve berichten op de statusvelden van templates.
En de doorvoer ligt vast op 20 berichten per seconde voor een Coexistence-nummer, ruim boven wat een conversationele bot verstuurt.
Veelgemaakte fouten
- Client Secret invullen met het secret van je eigen Meta-app. De handtekening komt dan nooit overeen en Botpress beantwoordt elke levering met 401.
- De OAuth- of sandbox-optie kiezen in plaats van Manual Configuration. Die koppelen een nummer via de eigen app van Botpress, niet via het nummer dat al gekoppeld is.
- Echo's negeren. Zonder regel voor antwoorden die vanaf de telefoon zijn verstuurd, praat de bot over iemand heen die al heeft ingegrepen.
Koppel het nummer op easycoexistence.com, plak het token en de Phone Number ID in Manual Configuration van Botpress en stel de webhook-URL van Botpress in als bestemming. Vanaf US$ 9 per nummer per maand, dalend naar US$ 1 naarmate er nummers bijkomen, met de eerste 3 dagen gratis.
Veelgestelde vragen
Is het overslaan van de handtekeningcontrole veilig?
De bescherming verschuift naar de URL. Botpress genereert de webhook-URL per integratie, dus houd die privé. Media moeten nog steeds met het token bij Meta worden opgehaald, en dat kan een vervalste gebeurtenis niet nabootsen.
Kan hetzelfde nummer ook n8n voeden?
Een nummer heeft één webhook-bestemming. Wijs die naar één systeem en stuur vandaar door als een tweede systeem de gebeurtenissen nodig heeft.
Heeft Botpress mijn WABA ID nodig?
De definitie markeert het voorlopig als optioneel en meldt dat het in een toekomstige major-versie verplicht wordt. Vul het dus in vanuit de verbinding.
Lopen berichten via EasyCoexistence?
Nee. Meta levert rechtstreeks aan de webhook-URL van Botpress en de inhoud wordt bij ons nooit opgeslagen.
Lees verder
Klaar om te beginnen?
Stel WhatsApp Coexistence in enkele minuten in, niet maanden. De app blijft op je telefoon werken.
Start je gratis proefperiodeGeverifieerd op