Vastaa WhatsApp-viesteihin Flowise-chatflow'lla

Miksi Flowisen eteen tarvitaan jotain?

Koska Metan webhook ja Flowisen API puhuvat eri muodoissa. Meta vahvistaa osoitteen GET-pyynnöllä, jonka on palautettava hub.challenge sellaisenaan vastauksen runkona, ja toimittaa sen jälkeen jokaisen viestin sisäkkäisenä JSON-muotoisena POST-pyyntönä. Flowisen Prediction API -rajapinta odottaa POST-pyyntöä osoitteeseen /api/v1/prediction/ ja sen perään flow'n tunnusta sekä question-kenttää. Kumpikaan ei mukaudu toiseen, joten vastaanotin tekee käännöksen.

Vastaanotin voi olla n8n:n Webhook-solmu, reitti Pythonilla tai Node.js:llä tai mikä tahansa serverless-funktio. Se vastaa vahvistuksen GET-pyyntöön, tarkistaa webhook-osoitteeseen sijoitetun pitkän satunnaisen salaisuuden, vastaa Metalle heti 200 ja tekee vasta sitten varsinaisen työn. Osoitteessa oleva salaisuus on tässä toimiva todennus: Meta allekirjoittaa toimitukset Tech Providerin sovellussalaisuudella, jota ei jaeta kenellekään, joten X-Hub-Signature-256-otsaketta ei voi vahvistaa sinun päässäsi.

Miten vastaanottimen pitäisi kutsua Prediction API -rajapintaa?

Anna asiakkaan teksti question-kenttään ja asiakkaan WhatsApp-numero sessiotunnukseksi. Flowise hyväksyy overrideConfigin jokaisessa pyynnössä, ja sen sisällä oleva sessionId saa muistisolmut pitämään yhden keskustelun per henkilö sen sijaan, että kaikki sekoittuisivat samaan ketjuun. Webhookin payloadissa oleva lähettäjän numero on tähän vakaa ja luonteva avain.

Jos chatflow on suojattu API-avaimella, vastaanotin lähettää sen bearer-tokenina. Aseta streaming arvoon false, ellei vastaanotinta ole rakennettu kokoamaan striimiä, koska WhatsApp toimittaa yhden valmiin viestin eikä yhtä tokenia kerrallaan.

Vastaus lähtee Cloud API:n tekstiviestinä samasta numerosta. Se on ilmaista ja sallittua 24 tunnin ikkunan sisällä, jonka asiakkaan viesti avasi. Kaiken, mitä flow haluaa lähettää myöhemmin, esimerkiksi muistutuksen, on oltava hyväksytty viestipohja.

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" }
}

Voiko Flowise-agentti käyttää EasyCoexistencen MCP-palvelinta?

Ei vielä. Flowisen Custom MCP yhdistää Streamable HTTP -palvelimeen URL-osoitteella ja otsakkeilla, tyypillisesti staattisella bearer-tokenilla, joka on tallennettu Flowisen muuttujaan. EasyCoexistencen MCP-palvelin todentaa OAuthilla, selaimessa tehtävällä kirjautumisella ja itse myöntämillään tokeneilla, joten otsakkeeseen ei ole annettavissa staattista avainta.

Toimiva työnjako on, että flow päättää ja vastaanotin lähettää. Flow palauttaa lähetettävän tekstin tai viestipohjan nimen, kun asiakas on ollut hiljaa yli vuorokauden, ja vastaanotin tekee Cloud API -kutsun numeron tokenilla. Tällöin token ei koskaan ole Flowisen sisällä, ja 24 tunnin sääntö varmistetaan koodissa tarkistamalla, milloin kontakti kirjoitti viimeksi, sen sijaan että se jätettäisiin mallin muistin varaan.

Saapuvat viestit tulevat silti vain webhookin kautta, lähetettiinpä vastaukset miten tahansa.

Yleiset virheet

• sessionId jää pois. Silloin kaikki asiakkaat jakavat yhden muistin, ja yhden henkilön tiedot voivat päätyä toisen vastaukseen.
• Flowisen odottaminen ennen Metalle vastaamista. Hidas 200 yritetään uudelleen, jolloin sama viesti käsitellään kahdesti.
• Flow'n annetaan lähettää vapaata tekstiä vuorokauden päästä. Ikkunan ulkopuolella Meta hylkää sen virheellä 131047.

Usein kysytyt kysymykset

Lue lisää