Conectați WhatsApp la n8n prin Cloud API oficial

Cum ajunge un mesaj WhatsApp într-un workflow n8n?

Meta livrează fiecare mesaj trimis către număr la un singur URL indicat de dumneavoastră, printr-un HTTP POST. Acest URL reprezintă întreaga integrare. Plasați un nod n8n Webhook la un URL de producție, setați-l ca destinație webhook pentru număr, iar workflow-ul rulează la fiecare mesaj primit.

Payload-ul conține expeditorul, textul sau referința media, un timestamp și ID-ul mesajului. De aici, este un workflow n8n obișnuit: ramificați după conținut, căutați clientul, apelați orice alt serviciu folosiți și decideți dacă răspundeți.

Deoarece este vorba despre Coexistence, același mesaj se află și în aplicația WhatsApp Business de pe telefon. Un om poate răspunde. Workflow-ul vede ce a trimis omul, iar omul vede ce a trimis workflow-ul, astfel încât răspunsurile nu se suprapun.

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

Cum trimite workflow-ul un răspuns?

Cu un nod HTTP Request către Cloud API, folosind phone number id și access token ale numărului. Ambele pot fi citite din dashboard sau prin conectorul MCP, dacă preferați ca un asistent să le preia.

Ce trebuie trimis depinde de moment, iar aici apar cele mai multe probleme. În primele 24 de ore de la ultimul mesaj al clientului, textul liber funcționează, iar răspunsul este compus de workflow. După acest interval, va fi trimis doar un template aprobat deja de Meta. Un workflow care trimite numai text liber pare perfect la testare, deoarece testarea are loc mereu la câteva secunde după un mesaj, apoi eșuează la primul caz real de peste noapte.

Structura robustă este o ramificație: verificați cât timp a trecut de la ultimul mesaj primit și alegeți text liber sau un template.

Poate n8n să folosească și conectorul MCP?

Da, iar n8n este neobișnuit în această privință. Nodul MCP Client Tool se conectează la un server MCP la distanță și acceptă OAuth2, de care are nevoie soluția noastră, astfel încât un nod AI Agent dintr-un workflow poate apela direct instrumentele noastre.

Este important de știut, deoarece majoritatea platformelor de automatizare nu pot face acest lucru. Make și Zapier rulează fiecare propriile servere MCP și niciuna nu acționează ca client, deci niciuna nu poate ajunge la un server terț. n8n poate.

Este util pentru partea de acțiune: un nod agent care decide să trimită un mesaj, să verifice starea unui număr sau să citească statusul aprobării unui template în timp ce rulează un workflow. Nu poate înlocui webhook-ul, deoarece MCP nu are cum să fie activat de un mesaj primit.

Pe care dintre cele două ar trebui să îl folosească un workflow?

Pe ambele, pentru părți diferite, iar împărțirea nu ține de preferință.

Webhook-ul este modul în care începe orice acțiune. Un client scrie, Meta livrează mesajul către nodul dumneavoastră Webhook, iar workflow-ul rulează. Nu există un echivalent MCP pentru acest lucru în niciun instrument, deoarece protocolul funcționează prin cerere și răspuns, nu printr-un apel primit.

MCP Client Tool permite unui agent din workflow să acționeze fără să codificați manual apelul. Dacă workflow-ul știe deja exact ce trebuie trimis, un nod HTTP Request către Cloud API este mai simplu și lasă mai puține lucruri să meargă prost. Dacă decide un agent, conectorul îi oferă cele unsprezece instrumente și regulile din descrierile lor, inclusiv intervalul de 24 de ore.

Ce diferențiază această soluție de nodurile WhatsApp n8n folosite deja?

Majoritatea configurărilor WhatsApp pentru n8n întâlnite în practică folosesc un gateway neoficial care se autentifică drept dispozitiv asociat. Sunt ușor de pornit, dar pun numărul în pericol, deoarece mecanismul încalcă termenii WhatsApp, iar Meta detectează tiparul traficului, nu biblioteca folosită.

Cealaltă rută frecventă este API-ul oficial fără Coexistence. Funcționează, dar migrează numărul. Aplicația WhatsApp Business încetează să funcționeze pe acesta, iar echipa care răspundea toată ziua trebuie să treacă într-un instrument nou. Pentru majoritatea firmelor mici, acest lucru nu este acceptabil, motiv pentru care atât de multe au ajuns inițial la gateway-uri neoficiale.

Coexistence este combinația care lipsea: API oficial, iar telefonul continuă să funcționeze.

Greșeli frecvente

• Folosirea unui URL de test n8n ca destinație webhook. Acesta încetează să asculte când editorul se închide, iar mesajele nu mai sunt livrate nicăieri.
• Nerăspunderea la cererea de verificare Meta. Meta trimite un GET cu o provocare înainte să livreze ceva, iar un nod care nu o retransmite nu va primi niciun mesaj.
• Răspunsul cu text liber după intervalul de 24 de ore. Din perspectiva workflow-ului, acesta eșuează fără un indiciu, iar numai un template aprobat este trimis.

Întrebări frecvente

Continuați să citiți