AccediInizia la prova gratuita
Meta Tech Provider

Agente AI WhatsApp in n8n, con la risposta scritta dal tuo workflow

Un passaggio di automazione invia con POST il messaggio del cliente, firmato e con fino a 10 messaggi recenti della chat, a un nodo Webhook di n8n. Un nodo AI Agent scrive la risposta, un nodo Respond to Webhook restituisce {"reply": "..."} entro 20 secondi, e quel testo viene inviato dal numero WhatsApp Business, che continua a funzionare nell'app. Gli agenti più lenti ricevono direttamente il webhook di Meta e rispondono tramite la Graph API.

easyCoexistence collega il numero WhatsApp Business che già usi nell'app alla Cloud API di Meta tramite Coexistence ed esegue le automazioni su di esso.

20 s

Quanto attende lo step Call my webhook la risposta del tuo workflow prima di fallire.

10

Gli ultimi messaggi della chat inviati nel campo history, dal più vecchio, terminando con il messaggio che ha avviato l'esecuzione.

4,096

Caratteri di una risposta inviata come un unico testo WhatsApp; ciò che eccede viene tagliato.

6 hours

Intervallo minimo tra due email di errore per la stessa automazione quando uno step webhook fallisce.

2 modules

Cosa consente n8n Cloud in un nodo Code, crypto e moment; n8n self-hosted abilita crypto con NODE_FUNCTION_ALLOW_BUILTIN.

24 hours

Finestra di assistenza clienti dopo l'ultimo messaggio del cliente; dopo, Meta accetta solo messaggi template.

Come arriva un messaggio WhatsApp a un agente AI in n8n?

Tramite un'automazione sul numero. Il numero deve ricevere i suoi messaggi tramite easyCoexistence (la modalità «Through easyCoexistence»), così Meta li consegna qui; un'automazione con trigger l'arrivo di un messaggio e step Call my webhook invia con POST il messaggio al tuo URL Production di n8n. Il workflow risponde nella stessa risposta HTTP, e il testo restituito arriva al cliente come messaggio WhatsApp dal tuo numero.

Prima di chiamare n8n, l'esecuzione ha già superato i controlli. Una consegna ripetuta da Meta non avvia una seconda esecuzione, una risposta scritta nell'app mette in pausa l'automazione su quella chat (4 ore per impostazione predefinita) e la risposta parte solo entro 24 ore dall'ultimo messaggio del cliente. Il tuo workflow decide solo cosa dire.

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

Cosa invia easyCoexistence al nodo Webhook di n8n?

Un POST JSON con User-Agent easyCoexistence-automations/1, X-EC-Event impostato su automation.step e un header X-EC-Signature. message contiene il testo del cliente, oppure un segnaposto come [image] con la didascalia per i media; una nota vocale arriva come [voice message] seguito dalle sue parole quando è salvata una chiave OpenAI o OpenRouter. history contiene fino a 10 messaggi recenti della chat, dal più vecchio, ciascuno con una direction: in per il cliente, out per la risposta di un'automazione ed echo per una persona che scrive dal telefono. Copre i messaggi conservati per il periodo di conservazione dell'account (30, 90 o 365 giorni, 90 di default) e solo quelli arrivati mentre i messaggi del numero passavano da easyCoexistence.

Un test dal pannello Try it dell'editor invia lo stesso POST con dry_run impostato su true, una history vuota, il contatto di esempio 15550000000 chiamato Test customer e un id messaggio che inizia con test_. Nessuno riceve nulla, ma il workflow viene davvero eseguito, quindi evita effetti collaterali come la creazione di ordini quando dry_run è 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" }
  ]
}

Come si verifica la firma in n8n?

Aggiungi un nodo Code subito dopo il nodo Webhook. X-EC-Signature ha il formato t=<secondi unix>,v1=<hex>, dove v1 è un HMAC-SHA256 di t, di un punto e del corpo, con chiave il Signing secret dell'automazione. Per copiarlo, apri l'automazione salvata e seleziona il suo step Call my webhook. Ogni automazione ha un proprio secret, e gli strumenti MCP non lo restituiscono mai, quindi un'automazione creata dalla tua AI richiede comunque questa copia dalla dashboard. Un pulsante New secret lo sostituisce e il vecchio smette di funzionare subito, e solo il titolare dell'account può vederlo, non un membro del team invitato.

Rifiuta un t con uno scarto superiore a 5 minuti rispetto al tuo orologio, confronta in tempo costante e lancia un'eccezione in caso di esito negativo: il workflow si interrompe prima di Respond to Webhook, n8n risponde 500 e non viene inviato nulla. n8n Cloud consente il modulo crypto nei nodi Code; n8n self-hosted richiede NODE_FUNCTION_ALLOW_BUILTIN=crypto. Anche il nodo Crypto con azione Hmac e un nodo IF funziona, anche se un confronto IF non è a tempo costante.

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...

Come configuri il nodo AI Agent e la risposta?

Passa al nodo AI Agent il testo del cliente come messaggio utente e tutto il resto nel messaggio di sistema: chi è l'azienda, i fatti che può citare, il tono e la chat recente dalla history, così una domanda di follow-up ha senso. Collega il modello di chat che preferisci, insieme a strumenti come un tool HTTP Request che cerca un ordine.

Concludi con un nodo Respond to Webhook che risponde in JSON e inserisce il testo dell'agente in un campo chiamato reply. easyCoexistence taglia gli spazi, ignora una risposta vuota o non testuale e invia il resto come un unico testo WhatsApp fino a 4.096 caratteri, quindi chiedi al modello frasi semplici invece di markdown.

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() }} }

Cosa succede se il workflow è lento, fallisce o non restituisce nulla?

Ogni esito viene registrato nella scheda Runs dell'automazione con l'output o l'errore dello step, così puoi capire quale di questi casi si è verificato:

  • Nessuna risposta entro 20 secondi: lo step fallisce con Webhook did not answer, non viene inviato nulla e l'esecuzione mostra Failed.
  • Uno stato fuori dal 2xx, redirect inclusi: lo step fallisce con Webhook answered HTTP e il codice.
  • Un 2xx senza una stringa di risposta: l'esecuzione è Done, lo step mostra HTTP 200, nessuna risposta, e il cliente non riceve nulla in automatico.
  • Un'esecuzione fallita ti invia un'email così puoi rispondere tu a quel cliente, al massimo una volta ogni 6 ore per automazione.
  • Una chat cui hai risposto dal telefono durante la pausa (4 ore per impostazione predefinita, da impostare in Advanced) viene saltata come human_active prima che n8n venga chiamato.
  • Più messaggi rapidi avviano più esecuzioni. Un Wait di 1 minuto prima di Call my webhook risponde una sola volta, perché un messaggio più recente che sceglie la stessa automazione sostituisce l'esecuzione in attesa.

Quando n8n deve ricevere direttamente il webhook di Meta?

Quando l'agente impiega più di 20 secondi, quando il workflow deve vedere ogni evento (stati, risposte dal telefono, id dei media), quando invia qualcosa che nessun passo copre, come un Flow o un messaggio di catalogo, o quando l'azienda vuole l'importazione della cronologia di 6 mesi, che va solo a una destinazione diretta salvata entro 24 ore dal collegamento. La modalità diretta disattiva le automazioni per il numero: Meta invia il suo payload direttamente a n8n e easyCoexistence non vede mai i messaggi.

In n8n usa il nodo Webhook semplice, non il nodo WhatsApp Trigger, che si aspetta la tua app Meta e il suo secret. Attiva Allow Multiple HTTP Methods così un unico percorso lungo e casuale riceve l'handshake GET di Meta e i POST, rispondi alla GET con il valore grezzo hub.challenge come testo e salva quell'URL Production con un token di verifica tramite set_webhook_destination. Le risposte poi partono da un nodo HTTP Request verso l'endpoint di invio, e la deduplicazione, la pausa dal telefono e il controllo delle 24 ore diventano compito tuo.

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

Come configurarlo

  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.

Errori comuni

  • Lasciare l'opzione Respond del nodo Webhook su Immediately. n8n risponde subito Workflow got started, l'esecuzione registra HTTP 200, nessuna risposta, e il cliente non riceve nulla. Scegli Using 'Respond to Webhook' Node.
  • Incollare l'URL di test, quello con /webhook-test/. Ascolta solo mentre l'editor attende un evento di test; le automazioni hanno bisogno dell'URL Production di un workflow pubblicato.
  • Verificare con il secret di inoltro del numero. Call my webhook è firmato con il Signing secret dell'automazione; il secret di inoltro firma solo gli eventi inoltrati, quindi i passaggi autentici non superano il controllo.
  • Restituire il testo in un'altra forma. Viene inviato solo un corpo JSON con una stringa di primo livello chiamata reply; {"output": "..."} o un corpo text/plain vengono registrati come no reply.
Farlo con EasyCoexistence

Il suo step Call my webhook passa il messaggio del cliente a n8n e rimanda indietro la risposta, con deduplicazione, pausa quando rispondi dal telefono e controllo delle 24 ore integrati, senza costi extra per esecuzione. Da US$ 9 a US$ 0,75 per numero al mese, in calo man mano che aggiungi numeri, con i primi 3 giorni di prova gratuita.

Domande frequenti

ChatGPT o Claude possono creare questa automazione per me?

Sì. Con il connettore easyCoexistence aggiunto, chiedi un'automazione sul tuo numero che invii i messaggi in arrivo all'URL n8n; l'AI chiama create_automation con uno step call_webhook, poi test_automation. Chiedi di creare l'automazione disattivata finché il test non passa. Il Signing secret non viene restituito tramite MCP, quindi copialo dalla pagina dell'automazione.

Il workflow può inviare immagini, pulsanti o template?

Non tramite il campo reply, che trasporta solo testo. Lascia che sia l'automazione a farlo: passi come Send a picture or file, Ask a question with buttons e Send a template possono stare prima o dopo Call my webhook. Per altri tipi di messaggio, inviali da un nodo HTTP Request verso la Cloud API, con l'endpoint di invio e il token restituiti da get_api_credentials, e non restituire alcun campo reply, così il cliente non riceve due risposte.

Un solo workflow può rispondere a più numeri?

Sì. Punta un'automazione per numero allo stesso URL Production e dirama su channel.phone_number_id o automation.id. Ogni automazione ha un proprio Signing secret, quindi scegli il secret tramite automation.id prima di verificare la firma.

Funziona un n8n self-hosted?

Sì, se il suo URL Production è HTTPS pubblico. easyCoexistence rifiuta http, localhost e indirizzi privati o interni quando salvi l'URL e di nuovo prima di ogni chiamata, e non segue i redirect.

Continua a leggere

Pronto per iniziare?

Configura WhatsApp Coexistence in pochi minuti, non in mesi. L'app continua a funzionare sul telefono.

Inizia la prova gratuita

Verificato il