Collega WhatsApp a n8n tramite la Cloud API ufficiale

Come arriva un messaggio WhatsApp a un flusso n8n?

Meta consegna ogni messaggio inviato al numero a un singolo URL da te indicato, tramite HTTP POST. Quell'URL è l'intera integrazione. Inserisci un nodo n8n Webhook su un URL di produzione, impostalo come destinazione del webhook del numero e il flusso verrà eseguito per ogni messaggio in arrivo.

Il payload contiene il mittente, il testo o il riferimento al contenuto multimediale, un timestamp e l'id del messaggio. Da lì è un normale flusso n8n: diramare in base al contenuto, cercare il cliente, chiamare gli altri servizi che usi e decidere se rispondere.

Poiché si tratta di Coexistence, lo stesso messaggio rimane anche nell'app WhatsApp Business sul telefono. Una persona può rispondere. Il flusso vede ciò che la persona ha inviato e la persona vede ciò che il flusso ha inviato, quindi nessuno dei due sovrascrive la risposta dell'altro.

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

Come invia una risposta il flusso?

Con un nodo HTTP Request verso la Cloud API, usando il phone number id e l'access token del numero. Entrambi sono leggibili dalla dashboard o tramite il connettore MCP, se preferisci che sia un assistente a recuperarli.

Cosa inviare dipende dalla tempistica, ed è qui che molti si confondono. Entro 24 ore dall'ultimo messaggio del cliente, il testo libero funziona e la risposta sarà quella composta dal flusso. Fuori da quella finestra, passerà solo un template già approvato da Meta. Un flusso che invia sempre e solo testo libero sembra perfetto nei test, perché i test avvengono sempre pochi secondi dopo un messaggio, poi smette di funzionare al primo caso reale durante la notte.

La struttura più affidabile è una diramazione: controlla quanto tempo è passato dall'ultimo messaggio in arrivo e scegli di conseguenza testo libero o un template.

n8n può usare anche il connettore MCP?

Sì, e n8n è particolare sotto questo aspetto. Il suo nodo MCP Client Tool si collega a un server MCP remoto e supporta OAuth2, che è ciò di cui ha bisogno il nostro, quindi un nodo AI Agent in un flusso può chiamare direttamente i nostri strumenti.

È utile saperlo perché la maggior parte delle piattaforme di automazione non può farlo. Make e Zapier eseguono entrambi server MCP propri e nessuno dei due agisce da client, quindi nessuno può raggiungere un server di terze parti. n8n può farlo.

È adatto alla parte operativa: un nodo agent che decide di inviare un messaggio, controllare lo stato di un numero o leggere lo stato di approvazione di un template mentre il flusso è in esecuzione. Non può però sostituire il webhook, perché MCP non ha modo di essere attivato da un messaggio in arrivo.

Quale dei due dovrebbe usare un flusso?

Entrambi, per parti diverse, e la separazione non dipende da una preferenza.

Il webhook è il punto di avvio. Un cliente scrive, Meta consegna il messaggio al tuo nodo Webhook e il flusso viene eseguito. Non esiste un equivalente MCP per questo in alcuno strumento, perché il protocollo prevede richiesta e risposta, invece di poter essere chiamato dall'esterno.

MCP Client Tool serve a un agent all'interno del flusso per agire senza codificare manualmente la chiamata. Se il flusso sa già esattamente cosa inviare, un nodo HTTP Request verso la Cloud API è più semplice e offre meno possibilità di errore. Se decide un agent, il connettore gli fornisce gli undici strumenti e le regole associate alle relative descrizioni, inclusa la finestra di 24 ore.

Cosa lo rende diverso dai nodi WhatsApp n8n già disponibili?

La maggior parte delle configurazioni WhatsApp per n8n che trovi in circolazione usa un gateway non ufficiale che accede come dispositivo collegato. Sono facili da avviare, ma mettono a rischio il numero, perché questo meccanismo viola i termini di WhatsApp e Meta rileva il modello di traffico, non la libreria usata.

L'altra strada comune è l'API ufficiale senza Coexistence: funziona, ma migra il numero. L'app WhatsApp Business smette di funzionare e il team che rispondeva durante tutta la giornata deve passare a un nuovo strumento. Per molte piccole aziende è inaccettabile, ed è per questo che tante sono finite sui gateway non ufficiali.

Coexistence è la combinazione che mancava: API ufficiale e telefono ancora operativo.

Errori comuni

• Usare un URL di test n8n come destinazione del webhook. Smette di ascoltare quando chiudi l'editor, quindi i messaggi non vengono consegnati a nulla.
• Non rispondere alla richiesta di verifica di Meta. Meta invia un GET con una challenge prima di consegnare qualsiasi cosa e un nodo che non la restituisce non riceverà mai messaggi.
• Rispondere con testo libero fuori dalla finestra di 24 ore. Dal punto di vista del flusso l'errore è silenzioso e passa solo un template approvato.

Domande frequenti

Continua a leggere