WhatsApp'ı resmi Cloud API ile n8n'e bağlayın

WhatsApp mesajı n8n iş akışına nasıl ulaşır?

Meta, numaraya gönderilen her mesajı HTTP POST olarak belirlediğiniz tek bir URL'ye iletir. Bu URL, entegrasyonun tamamıdır. Bir n8n Webhook node'unu üretim URL'sinde çalıştırın, bunu numaranın webhook hedefi olarak ayarlayın; iş akışı her gelen mesajda çalışır.

payload; göndereni, metni veya medya referansını, zaman damgasını ve mesaj kimliğini taşır. Sonrasında bu, sıradan bir n8n iş akışıdır: içeriğe göre dallanın, müşteriyi bulun, çalıştırdığınız diğer hizmetleri çağırın ve yanıt verilip verilmeyeceğine karar verin.

Bu Coexistence olduğu için aynı mesaj telefondaki WhatsApp Business uygulamasında da görünür. Bir insan yanıtlayabilir. İş akışı insanın gönderdiğini, insan da iş akışının gönderdiğini görür; böylece yanıtlar birbirinin üzerine yazılmaz.

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

İş akışı nasıl yanıt gönderir?

Numaranın phone number id ve access token'ını kullanarak Cloud API'ye bir HTTP Request node'u üzerinden. İkisini panelden veya bir asistanın almasını istiyorsanız MCP bağlayıcısı üzerinden okuyabilirsiniz.

Gönderilecek içerik zamanlamaya bağlıdır ve sorun genellikle burada çıkar. Müşterinin son mesajından sonraki 24 saat içinde serbest metin çalışır ve yanıt, iş akışının oluşturduğu içerik olur. Bu sürenin dışında yalnızca Meta'nın önceden onayladığı bir şablon gönderilebilir. Yalnızca serbest metin gönderen bir iş akışı testte kusursuz görünür, çünkü test her zaman mesajdan birkaç saniye sonra yapılır; ilk gerçek gece senaryosunda ise sessizce durur.

Sağlam yaklaşım bir dallanmadır: son gelen mesajın ne kadar önce geldiğini kontrol edin ve buna göre serbest metin veya şablon seçin.

n8n MCP bağlayıcısını da kullanabilir mi?

Evet ve n8n bu konuda alışılmadık bir üründür. MCP Client Tool node'u uzak bir MCP sunucusuna bağlanır ve OAuth2'yi destekler; sunucumuzun ihtiyacı olan da budur. Böylece iş akışındaki bir AI Agent node'u araçlarımızı doğrudan çağırabilir.

Bunu bilmek önemlidir, çünkü çoğu otomasyon platformu bunu yapamaz. Make ve Zapier kendi MCP sunucularını çalıştırır; ikisi de istemci olarak çalışmadığından üçüncü taraf bir sunucuya ulaşamaz. n8n ulaşabilir.

Bu, iş akışı çalışırken mesaj göndermeye, bir numaranın bağlantı sağlığını kontrol etmeye veya bir şablonun onay durumunu okumaya karar veren bir agent node'u için uygundur. Ancak webhook'un yerini alamaz, çünkü MCP'nin gelen bir mesajla uyandırılma yöntemi yoktur.

Bir iş akışı bu ikisinden hangisini kullanmalı?

İkisini de, farklı amaçlar için kullanmalı; bu bir tercih meselesi değildir.

Her şey webhook ile başlar. Müşteri yazar, Meta Webhook node'unuza iletir ve iş akışı çalışır. Herhangi bir araçta bunun MCP karşılığı yoktur, çünkü protokol içeri çağrı yapılabilen bir yapıdan çok istek ve yanıt mantığıyla çalışır.

MCP Client Tool, sizin çağrıyı kod içine sabitlemeniz gerekmeden iş akışındaki bir agent'ın işlem yapmasını sağlar. İş akışı ne göndereceğini zaten biliyorsa Cloud API'ye karşı bir HTTP Request node'u daha basittir ve hata ihtimali daha düşüktür. Kararı bir agent veriyorsa bağlayıcı, açıklamalarıyla birlikte gelen 11 aracı ve 24 saatlik pencere dahil kurallarını agent'a sunar.

Bu, insanların zaten kullandığı n8n WhatsApp node'larından nasıl farklı?

Karşılaşacağınız n8n WhatsApp kurulumlarının çoğu, bağlı cihaz olarak oturum açan resmi olmayan bir ağ geçidine dayanır. Başlamaları kolaydır ancak numarayı riske atarlar, çünkü bu yöntem WhatsApp'ın koşullarını ihlal eder ve Meta trafiği kütüphaneden çok kullanım biçimine bakarak algılar.

Diğer yaygın yol, Coexistence olmadan resmi API'yi kullanmaktır. Bu çalışır ancak numarayı taşır. WhatsApp Business uygulaması o numarada çalışmayı bırakır ve gün boyunca yanıt veren ekip yeni bir araca geçmek zorunda kalır. Çoğu küçük işletme için bu kabul edilemez; bu nedenle birçoğu en başta resmi olmayan ağ geçitlerine yönelmiştir.

Coexistence, eksik olan birleşimi sunar: resmi API ve telefon çalışmaya devam eder.

Yaygın hatalar

• Webhook hedefi olarak n8n Test URL'sini kullanmak. Düzenleyici kapandığında dinlemeyi bırakır ve mesajlar hiçbir yere iletilmez.
• Meta'nın doğrulama isteğini yanıtlamamak. Meta, herhangi bir ileti göndermeden önce challenge içeren bir GET yollar; bunu geri yansıtmayan bir node hiçbir zaman mesaj alamaz.
• 24 saatlik pencerenin dışında serbest metinle yanıt vermek. İş akışı açısından sessizce başarısız olur ve yalnızca onaylı bir şablon gönderilebilir.

Sık sorulan sorular

Okumaya devam edin