Kirjaudu sisäänAloita ilmainen kokeilu
Meta Tech Provider

WhatsApp AI -agentti n8n:ssä, vastauksen kirjoittaa työnkulkusi

Automaatiovaihe lähettää asiakkaan viestin POST-pyyntönä allekirjoitettuna ja mukana enintään 10 viimeisintä chatin viestiä n8n:n Webhook-solmuun. AI Agent -solmu kirjoittaa vastauksen, Respond to Webhook -solmu palauttaa {"reply": "..."} 20 sekunnin kuluessa, ja teksti lähetetään WhatsApp Business -numerosta, joka toimii edelleen sovelluksessa. Hitaammat agentit saavat Metan webhookin suoraan ja vastaavat Graph API:n kautta.

easyCoexistence yhdistää jo sovelluksessa käyttämäsi WhatsApp Business -numeron Metan Cloud API:in kautta Coexistencen avulla ja ajaa sillä automaatioita.

20 s

Kuinka kauan vaihe “Call my webhook” odottaa työnkulkusi vastausta ennen kuin vaihe epäonnistuu.

10

Viimeisimmät chatin viestit, jotka lähetetään history-kentässä vanhimmasta uusimpaan. Viimeisenä on viesti, joka käynnisti suorituksen.

4,096

Vastauksen merkkimäärä, joka lähetetään yhtenä WhatsApp-tekstinä; tätä pidemmät katkaistaan.

6 hours

Lyhin väli kahden virhesähköpostin välillä samalle automaatiolle, kun webhook-vaihe epäonnistuu.

2 modules

Mitä n8n Cloud sallii Code-solmussa: crypto ja moment. Itse isännöity n8n ottaa cryptoin käyttöön muuttujalla NODE_FUNCTION_ALLOW_BUILTIN.

24 hours

Asiakaspalveluikkuna asiakkaan viimeisimmästä viestistä; sen jälkeen Meta hyväksyy vain viestipohjiin perustuvat viestit.

Miten WhatsApp-viesti päätyy n8n:n AI-agentille?

Automaation kautta numerossa. Numeron täytyy vastaanottaa viestinsä easyCoexistence-palvelun kautta (tila “Through easyCoexistence”), jotta Meta toimittaa ne tänne. Automaatio, jonka laukaisin on “A message arrives” ja vaihe “Call my webhook”, lähettää POST-pyynnön viestistä n8n:n Production URL -osoitteeseen. Työnkulku vastaa samassa HTTP-vastauksessa, ja palautettu teksti lähetetään asiakkaalle WhatsApp-viestinä numerostasi.

Ennen kuin n8n kutsutaan, suoritus on jo läpäissyt suojaukset. Meta-toisto ei käynnistä toista suoritusta. Sovelluksesta kirjoittamasi vastaus keskeyttää automaation kyseisessä chatissa (oletuksena 4 tunniksi), ja vastaus lähtee vain 24 tunnin sisällä asiakkaan viimeisimmästä viestistä. Työnkulkusi päättää vain, mitä sanotaan.

1Customer writesTo the number you keep in the WhatsApp Business app
2Call my webhookSigned POST with the message and recent chat
3n8n AI AgentWebhook node, signature check, AI Agent node
4Respond to Webhook{"reply": "..."} within 20 seconds
5Reply sentAlso shown in the app's chat thread

Mitä easyCoexistence lähettää n8n:n Webhook-solmulle?

JSON-POST-pyyntö, jonka User-Agent on easyCoexistence-automations/1, X-EC-Event on automation.step ja mukana on X-EC-Signature-otsikko. message sisältää asiakkaan tekstin tai paikkamerkin, kuten [image] kuvatekstin kanssa median tapauksessa; äänimuistio tulee muodossa [voice message], jota seuraavat sen sanat, kun OpenAI- tai OpenRouter-avain on tallennettu. history sisältää enintään 10 viimeisintä chatin viestiä vanhimmasta uusimpaan, ja jokaisella on suunta: in asiakkaalle, out automaation vastaukselle ja echo henkilölle, joka kirjoittaa puhelimesta. Se kattaa tilin säilytysajan mukaisesti tallennetut viestit (30, 90 tai 365 päivää, oletuksena 90) ja vain ne, jotka saapuivat, kun numeron viestit tulivat easyCoexistence-palvelun kautta.

Testi editorin “Try it” -paneelista lähettää saman POST-pyynnön, jossa dry_run on true, history on tyhjä, esimerkkikontakti 15550000000 on nimeltään Test customer ja viestin tunnus alkaa test_. Kenellekään ei lähde mitään, mutta työnkulku oikeasti suoritetaan, joten ohita sivuvaikutukset, kuten tilausten luonti, kun dry_run on true.

POST body of a Call my webhook step
{
  "event": "automation.step",
  "dry_run": false,
  "automation": { "id": "b7e0c3a2-5d1f-4c8e-9a6b-2f4d8e1c7a90", "name": "Send to my system" },
  "run_id": "0d9f6a41-8c2e-4b7a-a315-6e9c2b8d4f17",
  "channel": {
    "type": "whatsapp",
    "connection_id": "3f2a9c1e-7b4d-4e8a-9c2f-1a2b3c4d5e6f",
    "phone": "+1 631-555-0142",
    "phone_number_id": "106540352242922"
  },
  "connection": { "id": "3f2a9c1e-7b4d-4e8a-9c2f-1a2b3c4d5e6f", "phone": "+1 631-555-0142", "phone_number_id": "106540352242922" },
  "contact": { "id": "5511987654321", "wa_id": "5511987654321", "name": "Ana Souza" },
  "message": {
    "id": "wamid.HBgNNTUxMTk4NzY1NDMyMRUCABIYFjNFQjBDNzE4RjQ2QjI5RDkxQTNFAA==",
    "type": "text",
    "text": "Do you have gluten-free bread today?",
    "at": "2026-11-11T14:02:11.000Z"
  },
  "history": [
    { "direction": "in", "text": "Hi! Are you open today?", "at": "2026-11-11T13:58:40.000Z" },
    { "direction": "out", "text": "Hi Ana! Yes, until 8 pm.", "at": "2026-11-11T13:58:45.000Z" },
    { "direction": "in", "text": "Do you have gluten-free bread today?", "at": "2026-11-11T14:02:11.000Z" }
  ]
}

Miten allekirjoitus tarkistetaan n8n:ssä?

Lisää Code-solmu heti Webhook-solmun jälkeen. X-EC-Signature on muotoa t=<unix-sekunnit>,v1=<hex>, missä v1 on HMAC-SHA256 merkkijonosta t, piste ja runko, avaimena automaation Signing secret. Kopioi se avaamalla tallennettu automaatio ja valitsemalla sen “Call my webhook” -vaihe. Jokaisella automaatiolla on oma salaisuutensa, eikä MCP-työkalut palauta sitä koskaan, joten tekoälyn luoma automaatio tarvitsee silti tämän yhden kopioinnin hallintapaneelista. “New secret” -painike korvaa sen, ja vanha lakkaa toimimasta heti. Vain tilin omistaja näkee sen, ei kutsuttu tiimin jäsen.

Hylkää t, joka poikkeaa kellostasi yli 5 minuuttia, vertaa vakioajassa ja heitä virhe epäonnistuessa: työnkulku päättyy virheeseen ennen Respond to Webhook -solmua, n8n vastaa 500-virheellä eikä mitään lähety. n8n Cloud sallii crypto-moduulin Code-solmuissa. Itse isännöity n8n tarvitsee muuttujan NODE_FUNCTION_ALLOW_BUILTIN=crypto. Crypto-solmun Hmac-toiminto IF-solmun kanssa toimii myös, mutta IF-vertailu ei ole vakioaikainen.

n8n Code node: verify X-EC-Signature
// n8n Code node, mode "Run Once for Each Item", placed right after the Webhook node.
// n8n Cloud allows require('crypto'); self-hosted needs NODE_FUNCTION_ALLOW_BUILTIN=crypto.
const crypto = require('crypto');
const SECRET = 'whsec_...'; // the automation's Signing secret, from its editor page

const m = /^t=(\d+),v1=([0-9a-f]{64})$/.exec($json.headers['x-ec-signature'] || '');
if (!m) throw new Error('Missing X-EC-Signature');
if (Math.abs(Date.now() / 1000 - Number(m[1])) > 300) throw new Error('Stale signature');

// The body was signed as compact JSON, which JSON.stringify rebuilds from the parsed body.
const mac = crypto.createHmac('sha256', SECRET).update(`${m[1]}.${JSON.stringify($json.body)}`).digest();
if (!crypto.timingSafeEqual(mac, Buffer.from(m[2], 'hex'))) throw new Error('Bad signature');

return { json: $json.body }; // event, dry_run, contact, message, history...

Miten AI Agent -solmu ja vastaus määritetään?

Anna AI Agent -solmulle asiakkaan teksti käyttäjäviestinä ja kaikki muu järjestelmäviestissä: kuka yritys on, mitä faktoja se saa lainata, sävy ja viimeisin chat historysta, jotta jatkokysymys ymmärretään. Liitä haluamasi chat-malli sekä työkalut, kuten HTTP Request -työkalu, joka hakee tilauksen tiedot.

Lopuksi Respond to Webhook -solmu vastaa JSON-muodossa ja asettaa agentin tekstin kenttään nimeltä reply. easyCoexistence poistaa tekstistä reunojen välilyönnit, ohittaa tyhjän tai ei-merkkijonon vastauksen ja lähettää loput yhtenä WhatsApp-tekstinä, enintään 4 096 merkkiä. Pyydä siksi mallilta tavallisia lauseita eikä markdownia.

AI Agent and Respond to Webhook settings
AI Agent node
  Prompt: Define below
  Prompt (User Message): {{ $json.message.text }}
  Options > System Message:
    You answer WhatsApp messages for Bloom Café, 12 Baker St, open Tue to Sun 8:00 to 20:00.
    Reply in 1 to 3 short sentences, in the customer's language, as plain text.
    Never invent prices or stock. If unsure, say a person will reply here soon.
    Recent chat, oldest first:
    {{ $json.history.map(h => (h.direction === 'in' ? 'Customer: ' : 'Business: ') + h.text).join('\n') }}
  Chat Model: your OpenAI, Anthropic or OpenRouter model
  Tools (optional): an HTTP Request tool that looks up orders

Respond to Webhook node
  Respond With: JSON
  Response Body: { "reply": {{ $json.output.toJsonString() }} }

Mitä tapahtuu, kun työnkulku on hidas, epäonnistuu tai ei palauta mitään?

Jokainen lopputulos kirjautuu automaation “Runs”-välilehdelle vaiheen tulosteen tai virheen kanssa, joten näet, mikä näistä tapahtui:

  • Ei vastausta 20 sekunnissa: vaihe epäonnistuu viestillä “Webhook did not answer”, mitään ei lähety ja suoritus näyttää Failed.
  • Tila muu kuin 2xx, uudelleenohjaukset mukaan lukien: vaihe epäonnistuu viestillä “Webhook answered HTTP” ja koodilla.
  • 2xx ilman vastaustekstiä: suoritus on Done, vaihe näyttää HTTP 200 ja ei vastausta, eikä asiakas saa automaattista vastausta.
  • Epäonnistunut suoritus lähettää sinulle sähköpostin, jotta voit vastata asiakkaalle itse. Enintään kerran 6 tunnissa automaatiota kohden.
  • Chatti, johon vastasit puhelimesta keskeytyksen aikana (oletuksena 4 tuntia, asetus kohdassa Advanced), ohitetaan tilalla human_active ennen kuin n8n kutsutaan.
  • Useat nopeat viestit käynnistävät useita suorituksia. 1 minuutin Wait-vaihe ennen “Call my webhook” -vaihetta vastaa kerran, koska uudempi viesti, joka valitsee saman automaation, korvaa odottavan suorituksen.

Milloin n8n:n pitäisi sen sijaan vastaanottaa Metan webhookin suoraan?

Kun agentti tarvitsee yli 20 sekuntia, kun työnkulun pitää nähdä kaikki tapahtumat (tilat, puhelimesta tehdyt vastaukset, median tunnisteet), kun se lähettää jotain, mitä mikään vaihe ei kata, kuten Flow-viestin tai katalogiviestin, tai kun yritys haluaa 6 kuukauden historian tuonnin. Tuonti menee vain suoraan kohteeseen, joka on tallennettu 24 tunnin sisällä yhdistämisestä. Suora tila kytkee automaatiot pois numerolta: Meta lähettää oman sisältönsä suoraan n8n:ään, eikä easyCoexistence näe viestejä lainkaan.

n8n:ssä käytä tavallista Webhook-solmua, älä WhatsApp Trigger -solmua, joka odottaa omaa Meta-sovellustasi ja sen salaisuutta. Ota käyttöön Allow Multiple HTTP Methods, jotta yksi pitkä satunnainen polku ottaa vastaan Metan GET-kättelyn ja POST-pyynnöt. Vastaa GET-pyyntöön raakana tekstinä hub.challenge ja tallenna tuo Production URL vahvistustunnuksen kanssa set_webhook_destination-työkalun kautta. Vastaukset lähetetään sen jälkeen HTTP Request -solmusta lähetys-endpointiin, ja deduplikointi, puhelimen keskeytys ja 24 tunnin tarkistus jäävät sinun vastuullesi.

Call my webhook (Automations on)Direct webhook (automations off)
Who calls n8neasyCoexistence, when the automation matchesMeta, for every event on the number
Time to answer20 seconds, reply in the responseNo limit: send later through the Graph API
AuthenticationX-EC-Signature with the automation's secretA long random secret in the URL path
GuardsDedupe, phone pause and 24-hour check built inYours to write
What n8n can sendText in the reply; the other steps of the automation can send buttons, files and templatesAny Cloud API message type, templates included
History importNot availableIf saved within 24 hours of connecting
Kept by easyCoexistenceMessage text for your retention period (90 days by default), run logs 30 daysNothing

Näin otat sen käyttöön

  1. Turn on automations for the numberOn the number's page, the Automations and incoming messages card shows Automations on or Direct to your server. Click Turn on automations if needed; numbers connected without a webhook URL start with automations on.
  2. Build and publish the workflowWebhook node (POST, Respond: Using 'Respond to Webhook' Node), Code node, AI Agent node, Respond to Webhook node. Publish or activate it and copy the Production URL.
  3. Create the automation, switched OffIn Automations, click New automation and pick Send to my system under Start from an example. Paste the Production URL into Webhook URL, set the switch to Off so it does not answer customers yet, and click Save.
  4. Copy the Signing secret into n8nSelect the Call my webhook step of the saved automation, copy Signing secret and paste it into the Code node.
  5. Test, then switch it OnClick Test, type a sample message in Try it and press Run test: n8n runs with dry_run true and the result shows the reply. When it reads right, switch the automation On and save.

Yleiset virheet

  • Webhook-solmun Respond-asetuksen jättäminen arvoon Immediately. n8n vastaa heti Workflow got started, suoritus kirjaa HTTP 200:n ilman vastausta, eikä asiakas saa mitään. Valitse Using 'Respond to Webhook' Node.
  • Testi-URL:n liittäminen, se jossa on /webhook-test/. Se kuuntelee vain silloin, kun editori odottaa testitapahtumaa. Automaatiot tarvitsevat julkaistun työnkulun Production URL:n.
  • Tarkistaminen numeron forward-salaisuudella. “Call my webhook” allekirjoitetaan automaation omalla Signing secret -salaisuudella. Forward-salaisuus allekirjoittaa vain välitetyt tapahtumat, joten aidot vaiheet epäonnistuvat tarkistuksessa.
  • Tekstin palauttaminen toisessa muodossa. Lähetetään vain JSON-runko, jonka ylätason merkkijono on nimeltään reply. {"output": "..."} tai text/plain-runko kirjataan vastauksettomaksi.
Näin teet tämän EasyCoexistencen avulla

Sen “Call my webhook” -vaihe välittää asiakkaan viestin n8n:lle ja palauttaa vastauksen. Deduplikointi, puhelimesta vastaamisen keskeytys ja 24 tunnin tarkistus ovat sisäänrakennettuina ilman lisämaksua per suoritus. Alkaen US$ 9 per numero kuukaudessa, laskien US$ 0,75:een numeroiden lisääntyessä, ensimmäiset 3 päivää ilmaiseksi.

Usein kysytyt kysymykset

Voiko ChatGPT tai Claude luoda tämän automaation puolestani?

Kyllä. Kun easyCoexistence-konnektori on lisätty, pyydä automaatiota numerollesi, joka lähettää saapuvat viestit n8n:n URL-osoitteeseesi. Tekoäly kutsuu create_automation-työkalua call_webhook-vaiheella ja sitten test_automation-työkalua. Pyydä, että automaatio luodaan pois päältä, kunnes testi menee läpi. Signing secretiä ei palauteta MCP:n kautta, joten kopioi se automaation sivulta.

Voiko työnkulku lähettää kuvia, painikkeita tai viestipohjia?

Ei reply-kentän kautta, joka kuljettaa vain tekstiä. Anna automaation hoitaa se: vaiheet kuten Send a picture or file, Ask a question with buttons ja Send a template voivat olla ennen Call my webhook -vaihetta tai sen jälkeen. Muiden viestityyppien osalta lähetä ne HTTP Request -solmusta Cloud API:in, käyttäen lähetysendpointia ja tokenia, jotka get_api_credentials palauttaa. Älä palauta reply-kenttää, jotta asiakas ei saa kahta vastausta.

Voiko yksi työnkulku vastata useille numeroille?

Kyllä. Osoita jokaisen numeron automaatio samaan Production URL:iin ja haaroita channel.phone_number_id- tai automation.id-kentän mukaan. Jokaisella automaatiolla on oma Signing secret, joten valitse salaisuus automation.id:n perusteella ennen allekirjoituksen tarkistamista.

Toimiiko itse isännöity n8n?

Kyllä, jos sen Production URL on julkinen HTTPS. easyCoexistence hylkää http-, localhost-, yksityiset ja sisäiset osoitteet, kun tallennat URL-osoitteen, ja vielä ennen jokaista kutsua. Se ei myöskään seuraa uudelleenohjauksia.

Lue lisää

Valmis aloittamaan?

Ota WhatsApp Coexistence käyttöön minuuteissa, ei kuukausissa. Sovellus toimii edelleen puhelimessa.

Aloita ilmainen kokeilu

Vahvistettu