WhatsApp koppelen aan Activepieces met een Coexistence-nummer

Hoe verbind je een Coexistence-nummer met Activepieces?

Maak in Activepieces de WhatsApp Business-verbinding aan met twee waarden: het access token en de WhatsApp Business Account-id. Het EasyCoexistence-dashboard toont beide voor de verbinding, en get_api_credentials geeft ze terug aan een assistent. De instructies van de piece praten over het aanmaken van een Meta-app en een systeemgebruiker, omdat ze ervan uitgaan dat je geen van beide hebt. Hier is het nummer al verbonden, dus plak gewoon de waarden.

Bouw daarna een flow die begint met de trigger New Incoming Message, stel daarop een verify token naar keuze in en publiceer de flow. Kopieer de webhook-URL van de trigger naar de webhookbestemming van het nummer in EasyCoexistence, met hetzelfde verify token. Meta stuurt zijn verificatieverzoek, de trigger beantwoordt het, en elk bericht aan het nummer start een run.

Waarom moet het app secret leeg blijven?

Omdat het secret waarmee deze leveringen worden ondertekend niet van jou is om te plakken. Meta ondertekent elke webhook met het app secret van de app die het abonnement bezit, en bij een nummer dat via EasyCoexistence is verbonden is dat de EasyCoexistence-app, waarvan het secret nooit wordt gedeeld.

De piece behandelt het veld als optioneel. Blijft het leeg, dan accepteren de triggers leveringen zoals ze binnenkomen. Vul je er het secret van een andere app in, dan faalt elke levering op de controle van X-Hub-Signature-256 en wordt ze stilzwijgend genegeerd, wat er precies uitziet alsof berichten niet aankomen.

Het verify token houdt vreemden buiten de handshake. Kies een lange, willekeurige waarde en houd de trigger-URL privé, want dat is het adres dat je flow start.

Wat kan een flow doen zodra er een bericht binnenkomt?

De trigger geeft de flow een afgevlakt bericht: afzender, profielnaam, bericht-id, type, tekst, eventuele media-id, antwoorden op knoppen en lijsten, en de id van het ontvangende telefoonnummer. Vanaf daar is het een gewone Activepieces-flow met de andere pieces, zoals een CRM, een spreadsheet of een AI-stap.

Antwoorden verlopen via dezelfde piece. Send Message verstuurt vrije tekst en levert alleen binnen 24 uur na het laatste bericht van de klant. Send Template Message verstuurt een goedgekeurd template, het enige wat na dat venster nog wordt geleverd. Interactieve knoppen, lijsten, media, locatie en reacties zijn aparte acties.

De eigen instructies van Activepieces merken op dat Meta één callback-URL per app accepteert. Met bestemmingen per nummer is de limiet één URL per nummer, dus een flow die meerdere soorten events moet afhandelen, vertakt je het best binnen één flow.

Bereiken antwoorden die op de telefoon zijn getypt de flow?

Ze bereiken de webhook, maar niet deze trigger. Op een Coexistence-nummer stuurt Meta een echo van elk antwoord dat in de WhatsApp Business-app is getypt naar dezelfde bestemming, onder het veld smb_message_echoes. De trigger New Incoming Message van de piece leest alleen het veld messages en laat al het andere vallen.

Heb je de antwoorden van de telefoon nodig in de flow, begin dan met de generieke Webhook-piece van Activepieces, die elke HTTP-methode accepteert, en beantwoord de verificatie-GET met een stap Return Response op de synchrone URL. Daarna parseer je zelf de ruwe payload, met beide velden erin.

Voor de meeste flows is de trigger van de piece de simpelere keuze: hij reageert op klanten, en de antwoorden van het team blijven zichtbaar in de app op de telefoon.

Veelgemaakte fouten

• Een app secret plakken in de WhatsApp-verbinding. Leveringen zijn ondertekend met het secret van de EasyCoexistence-app, dus elke levering wordt genegeerd.
• De bestemming instellen voordat je de flow publiceert. Meta verifieert meteen en een niet-gepubliceerde flow kan niet antwoorden.
• Verwachten dat de trigger New Incoming Message antwoorden ziet die op de telefoon zijn getypt. Hij leest alleen het veld messages, niet smb_message_echoes.

Veelgestelde vragen

Lees verder