Yhdistä WhatsApp n8n:ään virallisella Cloud API -rajapinnalla

Miten WhatsApp-viesti päätyy n8n-työnkulkuun?

Meta toimittaa jokaiseen numeroon lähetetyn viestin yhteen nimeämääsi URL-osoitteeseen HTTP POST -pyyntönä. Tämä URL-osoite on koko integraatio. Lisää n8n Webhook -solmu tuotantokäyttöön tarkoitettuun URL-osoitteeseen, määritä se numeron webhookin kohteeksi, ja työnkulku käynnistyy jokaisesta saapuvasta viestistä.

Payload sisältää lähettäjän, tekstin tai mediasisällön viitteen, aikaleiman ja viestin tunnisteen. Sen jälkeen kyseessä on tavallinen n8n-työnkulku: haarauta sisällön perusteella, hae asiakkaan tiedot, kutsu muita käyttämiäsi palveluja ja päätä, vastataanko.

Koska kyseessä on Coexistence, sama viesti näkyy myös puhelimen WhatsApp Business -sovelluksessa. Ihminen voi vastata siihen. Työnkulku näkee ihmisen lähettämän vastauksen, ja ihminen näkee työnkulun lähettämän vastauksen, joten vastaukset eivät mene päällekkäin.

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

Miten työnkulku lähettää vastauksen?

Käytä HTTP Request -solmua Cloud API -rajapinnan kanssa sekä numeron puhelinnumeron tunnistetta ja käyttöoikeustokenia. Molemmat löytyvät hallintapaneelista tai MCP-liittimen kautta, jos haluat avustajan hakevan ne.

Lähetettävä sisältö riippuu ajoituksesta, ja juuri tämä kohta aiheuttaa ongelmia. Asiakkaan viimeisestä viestistä alkavien 24 tunnin aikana vapaa teksti toimii, ja vastaus on työnkulun muodostama. Tämän ajan jälkeen läpi pääsee vain Metan jo hyväksymä viestipohja. Vain vapaata tekstiä lähettävä työnkulku näyttää testeissä toimivalta, koska testit tehdään aina sekunteja viestin jälkeen. Ensimmäinen todellinen yötilanne kuitenkin pysäyttää sen.

Kestävä ratkaisu on haara: tarkista, kuinka kauan viimeisestä saapuvasta viestistä on kulunut, ja valitse sen mukaan vapaa teksti tai viestipohja.

Voiko n8n käyttää myös MCP-liitintä?

Kyllä, ja tässä n8n poikkeaa muista. Sen MCP Client Tool -solmu muodostaa yhteyden etäkäytössä olevaan MCP-palvelimeen ja tukee OAuth2:ta, jota omamme tarvitsee. Näin työnkulun AI Agent -solmu voi kutsua työkalujamme suoraan.

Tämä on hyvä tietää, koska useimmat automaatioalustat eivät pysty siihen. Make ja Zapier käyttävät kumpikin omia MCP-palvelimiaan, eivätkä ne toimi asiakkaina, joten kumpikaan ei voi käyttää kolmannen osapuolen palvelinta. n8n voi.

MCP sopii toimivaan osuuteen: agenttisolmu voi päättää lähettää viestin, tarkistaa numeron kunnon tai lukea viestipohjan hyväksynnän tilan työnkulun aikana. Se ei kuitenkaan voi korvata webhookia, koska MCP ei pysty heräämään saapuvasta viestistä.

Kumpaa näistä työnkulun pitäisi käyttää?

Molempia eri tehtäviin. Kyse ei ole mieltymyksestä.

Webhook käynnistää kaiken. Asiakas kirjoittaa, Meta toimittaa viestin Webhook-solmuusi ja työnkulku käynnistyy. Millään työkalulla ei ole tälle MCP-vastinetta, koska protokolla perustuu pyyntöön ja vastaukseen eikä siihen, että siihen voitaisiin kutsua.

MCP Client Tool on tarkoitettu työnkulun sisällä toimivalle agentille, joka voi suorittaa toiminnon ilman, että kutsu kovakoodataan. Jos työnkulku tietää jo tarkalleen, mitä lähettää, HTTP Request -solmu Cloud API -rajapintaa vasten on yksinkertaisempi ja siinä on vähemmän rikkoutumiskohtia. Jos päätöksen tekee agentti, liitin antaa sille 11 työkalua ja niiden kuvauksissa määritellyt säännöt, mukaan lukien 24 tunnin aikaikkunan.

Miten tämä eroaa n8n:n WhatsApp-solmuista, joita jo käytetään?

Useimmat luonnossa näkemäsi n8n:n WhatsApp-asennukset perustuvat epäviralliseen yhdyskäytävään, joka kirjautuu sisään linkitettynä laitteena. Ne on helppo ottaa käyttöön, mutta numero joutuu vaaraan, koska mekanismi rikkoo WhatsAppin ehtoja ja Meta tunnistaa liikennemallin eikä kirjastoa.

Toinen yleinen vaihtoehto on virallinen API ilman Coexistencea. Se toimii, mutta siirtää numeron. WhatsApp Business -sovellus lakkaa toimimasta siinä, ja koko päivän vastannut tiimi joutuu siirtymään uuteen työkaluun. Useimmille pienyrityksille tämä ei käy, minkä vuoksi niin moni päätyi alun perin epävirallisiin yhdyskäytäviin.

Coexistence yhdistää puuttuneet osat: virallinen API ja puhelin toimii edelleen.

Yleiset virheet

• n8n:n Test URL -osoitteen käyttäminen webhookin kohteena. Se lakkaa kuuntelemasta editorin sulkeutuessa, joten viestit päätyvät tyhjyyteen.
• Metan vahvistuspyyntöön vastaamatta jättäminen. Meta lähettää GET-pyynnön ja haasteen ennen toimituksia, eikä viestejä saavu, jos solmu ei palauta haastetta.
• Vapaalla tekstillä vastaaminen 24 tunnin aikaikkunan jälkeen. Työnkulun näkökulmasta se epäonnistuu hiljaisesti, ja vain hyväksytty viestipohja pääsee läpi.

Usein kysytyt kysymykset

Lue lisää