Vastaa WhatsApp-viesteihin Dify-sovelluksella

Voiko Meta lähettää WhatsApp-viestit suoraan Difylle?

Ei tavalla, joka suorittaa kättelyn loppuun. Ennen kuin Meta toimittaa mitään, se kutsuu kohdetta GET-pyynnöllä ja odottaa hub.challenge-arvoa takaisin vastauksen raakasisältönä. Difyn Webhook Trigger hyväksyy yhden HTTP-metodin triggeriä kohden, ja sen dokumentaation mukaan muu kuin JSON-muotoinen vastaus muunnetaan automaattisesti JSONiksi, joten OK palaa viestiobjektina. Challengea ei voi koskaan palauttaa täsmälleen sellaisenaan, eikä Meta aloita toimitusta.

Siksi eteen tarvitaan jotain pientä. n8n:n Webhook-solmu, Pythonilla tai Nodella tehty reitti tai serverless-funktio vastaa GET-pyyntöön, ottaa vastaan POST-pyynnön ja välittää tekstin Difylle. Samassa vastaanottajassa tarkistetaan myös webhook-URL-osoitteen pitkä satunnainen salaisuus, koska X-Hub-Signature-256-otsake allekirjoitetaan Tech Providerin sovellussalaisuudella, eikä asiakas voi vahvistaa sitä.

Miten vastaanottaja keskustelee Dify-sovelluksen kanssa?

Yhdellä kutsulla Difyn Service API -rajapintaan: POST /chat-messages, todennettuna sovelluksen API-avaimella. Pyynnön rungossa query sisältää asiakkaan tekstin ja user itse määrittelemäsi tunnisteen. Käytä user-arvona lähettäjän WhatsApp-numeroa ja säilytä Difyn palauttama conversation_id, jotta saman henkilön seuraava viesti jatkaa samaa keskustelua.

response_mode on tärkeä. Tila blocking palauttaa vastauksen vasta, kun se on valmis, ja Difyn dokumentaatio varoittaa, että Dify Cloudissa reunaproxy voi katkaista pitkän generoinnin. Agent-sovellukset tukevat vain tilaa streaming, ja blocking-pyyntö epäonnistuu niissä virheellä 400. Vankin ratkaisu on vastaanottaja, joka lukee virran ja lähettää yhden WhatsApp-viestin lopuksi.

Vastaus lähtee sitten Cloud API -rajapinnan tekstiviestinä samaan numeroon, mikä on ilmaista asiakkaan viestin avaamassa 24 tunnin ikkunassa.

Mitä MCP-palvelin tuo Difyn sisällä?

Dify-agentti voi toimia numerolla ilman, että sinun tarvitsee kytkeä jokaista kutsua erikseen. Dify yhdistää MCP-palvelimiin HTTP:n yli ja rekisteröityy oletuksena palvelimelle OAuthin dynaamisella asiakasrekisteröinnillä, jota EasyCoexistencen MCP-palvelin tukee. Lisää se kohdassa Tools, kirjaudu kerran sisään, ja agentti saa työkalut: numeroiden listaus, numeron tilan tarkistus, viestin lähetys, hyväksytyn viestipohjan lähetys ja viestipohjan tilan luku.

Tämä on oikea paikka ennakoivalle työlle: Dify-työnkulun, joka seuraa asiaa seuraavana päivänä, on käytettävä send_template-työkalua, koska vapaa teksti ikkunan ulkopuolella palauttaa virheen 131047, ja työkalujen kuvaukset kertovat tämän mallille.

MCP ei kuitenkaan voi herättää Difyä, kun asiakas kirjoittaa. Protokolla perustuu pyyntöön ja vastaukseen, joten saapuvat viestit tulevat edelleen webhookin ja edessä olevan vastaanottajan kautta.

Yleiset virheet

• Dify Webhook Trigger -URL-osoitteen käyttö webhookin kohteena. Challenge palaa JSONiin paketoituna, eikä Meta vahvista endpointia.
• Blocking-pyynnön lähettäminen Dify Agent -sovellukselle. Agent-sovellukset tukevat vain streamingia, ja kutsu epäonnistuu virheellä 400.
• Uuden user-arvon käyttö jokaiselle viestille. Dify rajaa keskustelut user-arvoon, joten jokainen viesti aloittaa uuden keskustelun ilman muistia.

Usein kysytyt kysymykset

Lue lisää