Giriş yapınÜcretsiz denemeyi başlatın
Meta Tech Provider

Dify uygulamasıyla WhatsApp mesajlarını yanıtlayın

Numaranın webhook'unu küçük bir alıcıya yönlendirin; örneğin bir n8n iş akışına ya da kendi kodunuzdaki bir route'a. Alıcı her mesajı Dify'ın Send Chat Message API'sine iletir ve yanıtı Cloud API üzerinden geri gönderir. Dify içinde EasyCoexistence MCP sunucusu araç olarak eklenebilir; böylece ajan numara üzerinde doğrudan işlem yapabilir.

JSON only

Dify Webhook Trigger, JSON olmayan bir yanıt gövdesini JSON içine sarar; bu yüzden Meta'nın ham challenge değerini döndüremez.

POST /chat-messages

Dify'ın Service API çağrısı: bir sohbet uygulamasına tek bir kullanıcı mesajı gönderir ve uygulamanın yanıtını döndürür.

OAuth

Dify'ın MCP araçları OAuth kimlik bilgilerini dynamic client registration ile alır; bu varsayılan olarak açıktır.

Meta, WhatsApp mesajlarını doğrudan Dify'a gönderebilir mi?

El sıkışmayı tamamlayacak şekilde hayır. Meta herhangi bir şey iletmeden önce hedefe GET isteği yapar ve hub.challenge değerinin ham yanıt gövdesi olarak geri dönmesini bekler. Dify'ın Webhook Trigger'ı her tetikleyici için tek bir HTTP yöntemini kabul eder ve belgelerine göre JSON olmayan yanıt gövdesi otomatik olarak JSON'a çevrilir; yani OK, bir mesaj nesnesi olarak döner. Challenge değeri hiçbir zaman birebir yansıtılamaz ve Meta teslimata hiç başlamaz.

Bu yüzden önde küçük bir bileşen durur. Bir n8n Webhook düğümü, Python ya da Node'da bir route veya sunucusuz bir fonksiyon GET isteğini yanıtlar, POST'u kabul eder ve metni Dify'a iletir. Webhook URL'sindeki uzun rastgele gizli değer de bu alıcıda doğrulanır; çünkü X-Hub-Signature-256 başlığı Tech Provider'ın uygulama sırrıyla imzalanır ve müşteri tarafından doğrulanamaz.

Alıcı, Dify uygulamasıyla nasıl konuşur?

Dify'ın Service API'sine tek bir çağrıyla: POST /chat-messages, uygulamanın API anahtarıyla kimlik doğrulaması yapılır. Gövde, müşterinin metni olan query ile sizin tanımladığınız bir tanımlayıcı olan user alanını taşır. user olarak gönderenin WhatsApp numarasını kullanın ve Dify'ın döndürdüğü conversation_id değerini saklayın; aynı kişinin sonraki mesajı böylece aynı konuşmayı sürdürür.

response_mode önemlidir. Blocking, yanıt tamamlanınca döner; Dify'ın belgeleri, Dify Cloud'da uzun bir üretimin edge proxy tarafından kesilebileceği konusunda uyarır. Agent uygulamaları yalnızca streaming destekler ve bunlara yapılan blocking istek 400 ile başarısız olur. Akışı okuyup en sonda tek bir WhatsApp mesajı gönderen alıcı sağlam yapıdır.

Yanıt ardından Cloud API metin mesajı olarak aynı numaraya gider; bu, müşterinin mesajının açtığı 24 saatlik pencere içinde ücretsizdir.

1MetaDelivers the message to your receiver
2ReceiverChecks the URL secret, answers 200
3DifyPOST /chat-messages with user = sender
4Cloud APISends the answer to the customer

MCP sunucusu Dify içinde ne ekler?

Bir Dify ajanının, her çağrıyı elle bağlamadan numara üzerinde işlem yapabilmesini. Dify, MCP sunucularına HTTP üzerinden bağlanır ve varsayılan olarak OAuth dynamic client registration ile sunucuya kendini kaydeder; EasyCoexistence MCP sunucusu bunu destekler. Araçlar bölümünden ekleyin, bir kez oturum açın; ajan şu araçları alır: numaraları listeleme, bir numaranın bağlantı sağlığını kontrol etme, mesaj gönderme, onaylı şablon gönderme, şablon durumunu okuma.

Proaktif işler için doğru yer burasıdır: ertesi gün takip eden bir Dify iş akışı send_template kullanmak zorundadır, çünkü pencere dışında serbest metin 131047 kodlu hata döndürür ve araç açıklamaları bunu modele söyler.

MCP'nin yapamadığı şey, müşteri yazdığında Dify'ı uyandırmaktır. Protokol istek ve yanıt temellidir; gelen mesajlar yine webhook ve öndeki alıcı üzerinden gelir.

Yaygın hatalar

  • Dify Webhook Trigger URL'sini webhook hedefi olarak kullanmak. Challenge değeri JSON içine sarılmış döner ve Meta uç noktayı hiçbir zaman doğrulamaz.
  • Dify Agent uygulamasına blocking istek göndermek. Agent uygulamaları yalnızca streaming destekler ve çağrı 400 ile başarısız olur.
  • Her mesajda yeni bir user değeri kullanmak. Dify konuşmaları user'a bağlar; bu yüzden her mesaj, hafızasız yeni bir konuşma başlatır.
Bunu EasyCoexistence'la yapmak

Numarayı easycoexistence.com'da bağlayın, webhook hedefini alıcınıza yönlendirin ve ajanın işlemleri için MCP sunucusunu Dify'a ekleyin. Numara başına aylık US$ 9'dan başlar, numara ekledikçe US$ 1'e düşer; ilk 3 gün ücretsizdir.

Sık sorulan sorular

Dify'ın bir WhatsApp kanalı var mı?

Belgelerinde yok. Bir Dify uygulamasına Service API üzerinden ulaşılır; bu yüzden WhatsApp, o API'yi çağıran bir alıcı üzerinden bağlanır.

n8n alıcı olabilir mi?

Evet. Bir Webhook düğümü mesajı alır, bir HTTP Request düğümü Dify'ı çağırır, ikinci bir HTTP Request düğümü yanıtı Cloud API üzerinden gönderir.

Ekip yine telefondan yanıt verebilir mi?

Evet. Coexistence, numarada WhatsApp Business uygulamasının çalışmasını sürdürür; telefondan gönderilen yanıtlar alıcıya echo olayları olarak ulaşır.

EasyCoexistence konuşmayı görür mü?

Hayır. Meta doğrudan alıcınıza teslim eder ve mesaj içeriği bizim tarafımızda hiç saklanmaz. MCP sunucusu hesap ve numara durumunu okur.

Okumaya devam edin

Başlamaya hazır mısınız?

WhatsApp Coexistence'ı aylar değil, dakikalar içinde kurun. Uygulama telefonda çalışmaya devam eder.

Ücretsiz denemeyi başlatın

Doğrulama tarihi

Dify ile WhatsApp: resmi Cloud API