WhatsApp-berichten beantwoorden met een Flowise-chatflow

Waarom heeft Flowise iets nodig dat ervoor staat?

Omdat de webhook van Meta en de API van Flowise een andere vorm hebben. Meta verifieert een bestemming met een GET-verzoek dat hub.challenge als kale body moet teruggeven en levert daarna elk bericht als geneste JSON-POST. De Prediction API van Flowise verwacht een POST naar /api/v1/prediction/ gevolgd door de flow-id, met een veld question. Geen van beide past zich aan de ander aan, dus een ontvanger vertaalt.

De ontvanger kan een n8n Webhook-node zijn, een route in Python of Node, of een willekeurige serverless functie. Hij beantwoordt de verificatie-GET, controleert een lang, willekeurig geheim in de webhook-URL, antwoordt meteen met 200 naar Meta en doet daarna het eigenlijke werk. Het geheim in de URL is hier de authenticatie die werkt: Meta ondertekent leveringen met de app secret van de Tech Provider, die nooit wordt gedeeld, dus de header X-Hub-Signature-256 kan aan jouw kant niet worden gevalideerd.

Hoe moet de ontvanger de Prediction API aanroepen?

Met de tekst van de klant als question en het WhatsApp-nummer van de klant als sessie. Flowise accepteert overrideConfig bij elk verzoek, en met een sessionId daarin houden geheugennodes één gesprek per persoon bij in plaats van iedereen in één thread te mengen. Het nummer van de afzender uit de webhook-payload is daarvoor een stabiele, logische sleutel.

Is de chatflow beveiligd met een API-sleutel, dan stuurt de ontvanger die mee als bearer-token. Zet streaming op false, tenzij de ontvanger een stream kan samenvoegen, want WhatsApp levert één afgerond bericht in plaats van één token tegelijk.

Het antwoord gaat als tekstbericht via de Cloud API de deur uit, vanaf hetzelfde nummer. Dat is gratis en toegestaan binnen het venster van 24 uur dat het bericht van de klant heeft geopend. Alles wat de flow later wil sturen, zoals een herinnering, moet een goedgekeurd template zijn.

POST https://your-flowise-host/api/v1/prediction/<flow-id>
Authorization: Bearer <flowise-api-key>
Content-Type: application/json

{
  "question": "do you have anything friday?",
  "streaming": false,
  "overrideConfig": { "sessionId": "14155550188" }
}

Kan een Flowise-agent de EasyCoexistence MCP-server gebruiken?

Nu nog niet. De Custom MCP van Flowise maakt verbinding met een Streamable HTTP-server via een URL en een set headers, meestal een statisch bearer-token in een Flowise-variabele. De EasyCoexistence MCP-server authenticeert met OAuth, met inloggen in de browser en tokens die hij zelf uitgeeft, dus er is geen statische sleutel om in een header te zetten.

De werkbare verdeling is: de flow beslist en de ontvanger verstuurt. De flow geeft de tekst terug die gezegd moet worden, of de naam van een template als de klant langer dan een dag stil is geweest, en de ontvanger doet de Cloud API-aanroep met het token van het nummer. Het token zit dan nooit in Flowise, en de regel van 24 uur wordt in code afgedwongen door te controleren wanneer het contact voor het laatst schreef, in plaats van over te laten aan een model dat het kan vergeten.

Inkomende berichten komen nog steeds alleen binnen via de webhook, hoe het versturen ook is geregeld.

Veelgemaakte fouten

• De sessionId weglaten. Dan deelt elke klant hetzelfde geheugen en kunnen gegevens van de ene persoon opduiken in het antwoord aan een ander.
• Op Flowise wachten voordat je Meta antwoordt. Een trage 200 wordt opnieuw geprobeerd, waardoor hetzelfde bericht twee keer wordt verwerkt.
• De flow een dag later vrije tekst laten sturen. Buiten het venster weigert Meta dat met fout 131047.

Veelgestelde vragen

Lees verder