WhatsApp koppelen aan n8n via de officiële Cloud API

Hoe bereikt een WhatsApp-bericht een n8n-workflow?

Meta levert elk bericht dat naar het nummer wordt gestuurd aan één URL die je opgeeft, via een HTTP POST. Die URL vormt de volledige integratie. Plaats een n8n Webhook-node op een productie-URL, stel die in als webhook-bestemming van het nummer en de workflow wordt bij elk inkomend bericht uitgevoerd.

De payload bevat de afzender, de tekst of mediaverwijzing, een tijdstempel en de bericht-id. Daarna is het een gewone n8n-workflow: vertak op basis van de inhoud, zoek de klant op, roep andere systemen aan en bepaal of je antwoordt.

Omdat dit Coexistence is, staat hetzelfde bericht ook in de WhatsApp Business-app op de telefoon. Een medewerker kan antwoorden. De workflow ziet wat de medewerker heeft gestuurd en de medewerker ziet wat de workflow heeft gestuurd, zodat geen van beiden over het antwoord van de ander heen reageert.

{
  "from": "14155550188",
  "id": "wamid.HBgLMTQxNTU1NTAxODgVAgAS",
  "timestamp": "1758412800",
  "type": "text",
  "text": { "body": "do you have anything friday?" }
}

Hoe verstuurt de workflow een antwoord?

Met een HTTP-verzoekknooppunt naar de Cloud API, met de phone number id en access token van het nummer. Beide zijn in het dashboard te vinden, of via de MCP-connector als je ze liever door een assistent laat ophalen.

Wat je verstuurt hangt af van het tijdstip, en juist daar gaat het vaak mis. Binnen 24 uur na het laatste bericht van de klant werkt vrije tekst en is het antwoord wat de workflow heeft samengesteld. Buiten dat venster wordt alleen een template verzonden die Meta al heeft goedgekeurd. Een workflow die uitsluitend vrije tekst verstuurt lijkt tijdens tests perfect, omdat die tests altijd seconden na een bericht plaatsvinden, en valt vervolgens stil bij de eerste echte nachtelijke situatie.

De betrouwbare opzet is een vertakking: controleer hoe lang geleden het laatste inkomende bericht is ontvangen en kies daarna vrije tekst of een template.

Kan n8n ook de MCP-connector gebruiken?

Ja, en daarin is n8n bijzonder. De MCP Client Tool-node maakt verbinding met een externe MCP-server en ondersteunt OAuth2, precies wat onze server nodig heeft. Daardoor kan een AI Agent-node in een workflow onze tools rechtstreeks aanroepen.

Dat is belangrijk, want de meeste automatiseringsplatforms kunnen dit niet. Make en Zapier draaien allebei hun eigen MCP-servers en zijn geen van beide client, waardoor geen van beide een server van derden kan bereiken. n8n kan dat wel.

De connector is geschikt voor het handelende deel: een agent-node die tijdens een workflow besluit een bericht te versturen, de status van een nummer te controleren of de goedkeuringsstatus van een template op te vragen. De webhook kan hij niet vervangen, omdat MCP niet kan worden gewekt door een inkomend bericht.

Welke van de twee moet een workflow gebruiken?

Beide, voor verschillende delen. Dat is geen voorkeur, maar een verdeling van functies.

De webhook is hoe alles begint. Een klant schrijft, Meta levert het bericht aan je Webhook-node en de workflow wordt uitgevoerd. Geen enkele tool heeft een MCP-equivalent hiervoor, omdat het protocol uit verzoek en antwoord bestaat en niet van buitenaf kan worden aangeroepen.

De MCP Client Tool is bedoeld voor een agent binnen die workflow die zelfstandig kan handelen, zonder dat je de aanroep hardcodeert. Als de workflow al precies weet wat hij moet versturen, is een HTTP-verzoekknooppunt naar de Cloud API eenvoudiger en is er minder kans op fouten. Als een agent beslist, geeft de connector hem de elf tools en de regels uit hun beschrijvingen, inclusief het venster van 24 uur.

Wat maakt dit anders dan de n8n WhatsApp-knooppunten die mensen al gebruiken?

De meeste n8n WhatsApp-opstellingen die je in de praktijk ziet, zijn gebouwd op een onofficiële gateway die inlogt als een gekoppeld apparaat. Ze zijn eenvoudig te starten, maar brengen het nummer in gevaar, omdat dit mechanisme de voorwaarden van WhatsApp schendt en Meta het verkeerspatroon detecteert, niet alleen de gebruikte bibliotheek.

De andere veelvoorkomende route is de officiële API zonder Coexistence. Die werkt, maar migreert het nummer. De WhatsApp Business-app werkt er niet meer op en het team dat de hele dag antwoordde, moet naar een nieuwe tool overstappen. Voor de meeste kleine bedrijven is dat geen optie. Daarom kwamen zoveel bedrijven oorspronkelijk bij onofficiële gateways terecht.

Coexistence is de ontbrekende combinatie: officiële API, terwijl de telefoon blijft werken.

Veelgemaakte fouten

• Een n8n Test-URL als webhook-bestemming gebruiken. Die stopt met luisteren zodra de editor sluit, waardoor berichten nergens worden afgeleverd.
• Meta's verificatieverzoek niet beantwoorden. Meta stuurt eerst een GET met een challenge voordat het iets aflevert. Een node die die niet terugstuurt, ontvangt nooit een bericht.
• Buiten het venster van 24 uur met vrije tekst antwoorden. Vanuit de workflow lijkt dit stil te mislukken; alleen een goedgekeurde template wordt dan verzonden.

Veelgestelde vragen

Lees verder