Kendi yapay zekâ ajanınızı WhatsApp'a getirin: herhangi bir çerçeveyi (LangGraph, ADK, özel) webhook uç noktasıyla bağlayın

Neredeyse her yapay zekâ ajanını yeniden yazmadan WhatsApp’a bağlayabilirsiniz. LangGraph, Google ADK, CrewAI veya kendi kodunuzla geliştirdiğiniz ajanı bir HTTPS uç noktasının arkasında çalıştırın, ardından MonoChat’te Özel sağlayıcıyla bir AI Harness olarak ekleyin: bir uç nokta URL’si ve paylaşılan bir gizli anahtar. Bir akışa AI Agent düğümü yerleştirin, WhatsApp numaranızı bağlayın; ajanınız müşterileri WhatsApp’ta ve MonoChat’in bağladığı diğer tüm kanallarda, etrafında ortak bir gelen kutusu ve insana devirle yanıtlasın.

Bu rehber, zaten bir ajanı olan veya nasıl çalıştığı üzerinde tam kontrol isteyen ekipler içindir. Kendi ajanınızı getirmenin ne zaman mantıklı olduğunu, uç noktanızın nelerden sorumlu olduğunu, MonoChat’teki kurulumu ve üretimde önem taşıyan ayrıntıları kapsar.

Neden kendi ajanınızı getirmelisiniz?

Çoğu müşteri mesajlaşma platformu tek bir yerleşik yapay zekâ ajanıyla gelir. Şu noktaya kadar bu kolaydır:

• Ajanınız zaten geliştirilmiş. Geliştiricileriniz aylarını bir LangGraph grafiğine veya değerlendirmeleri ve testleriyle bir ADK çoklu ajan kurulumuna harcadı. Onu bir satıcının bot oluşturucusunda yeniden yapmak o emeği çöpe atmaktır.
• Kendi mantığınıza ihtiyacınız var. Fiyat kuralları, uygunluk kontrolleri, uyumluluk adımları veya yalnızca kodunuzun ulaşabildiği iç sistemler.
• Çerçeveyi sizin seçmenizi istiyorsunuz. Çerçeveler hızla değişir. Bugün LangGraph; seneye başka bir şey olabilir. Kanallarınızın ve gelen kutunuzun onunla birlikte değişmesi gerekmemeli.
• Veri sizde kalmalı. Bazı kuruluşlar ajanın akıl yürütmesinin ve araç çağrılarının kendi altyapılarında çalışmasını ister.

MonoChat’in Agent Harness yapısı bunun için geliştirildi: kendi ajan çerçevenizi getirin ve etrafındaki her şeyi (kanalları, gelen kutusunu, insanları) tek bir yerde tutun.

Özel harness nasıl çalışır?

Bunu bir iş bölümü olarak düşünün.

MonoChat konuşma katmanını yönetir:

• WhatsApp, Instagram, Messenger, TikTok, Telegram, web sohbeti, SMS ve sesli kanala resmi bağlantılar (MonoChat resmi bir Meta Business Partner’dır).
• Ajanın ne zaman çağrılacağına AI Agent düğümü aracılığıyla karar veren akış.
• Bir kişinin tüm geçmişle devralabildiği ortak ekip gelen kutusu.

Uç noktanız ajanı yönetir:

• Konuşmayı MonoChat’ten almak.
• Ajanınızı çalıştırmak: akıl yürütmesi, araçları, belleği.
• Ajanın yanıtını döndürmek.

İkisinin arasında bir paylaşılan gizli anahtar durur; her iki tarafın bildiği bu değer sayesinde uç noktanız bir isteğin MonoChat hesabınızdan geldiğini doğrulayabilir. MonoChat, uç noktanızın uygulayacağı kesin istek ve yanıt biçimini tanımlar; henüz elinizde yoksa bizimle görüşün, geliştiricilerinizle paylaşalım.

Uç noktanız neler yapmalı?

Hangi çerçeveyi kullanırsanız kullanın, üretime hazır bir ajan uç noktasının birkaç görevi vardır.

Her isteği doğrulayın

Her çağrıda paylaşılan gizli anahtarı kontrol edin ve eşleşmeyen her şeyi reddedin. Anahtarı kodda değil, sır yöneticinizde veya ortam değişkenlerinde saklayın ve ifşa olursa değiştirin.

Her konuşmayı ayrı tutun

Müşteriler paralel yazar. Ajanınızın durumunun, belleğinin ve tüm çalışma dosyalarının tek bir konuşmaya özgü olduğundan emin olun; böylece bir müşterinin bilgileri asla bir başkasının yanıtına sızmaz.

Sohbet boyutunda mesajlarla yanıt verin

Web uygulamaları için geliştirilen ajanlar uzun, biçimlendirilmiş yanıtlar yazmaya eğilimlidir. WhatsApp telefonda okunur. Ajanınızdan kısa mesajlar isteyin, her seferinde tek soru sorsun ve yanıtlarda yoğun Markdown kullanmasın.

Sessizce değil, açıkça başarısız olun

Bir araç zaman aşımına uğrarsa veya model sağlayıcınız hata döndürürse yarım kalmış bir yanıt yerine net bir hata döndürün. Öngörülebilir bir hata, akışın doğru şeyi yapmasını sağlar; örneğin konuşmayı bir kişiye devretmesini.

Hızlı olun

Müşteriler saniyeler içinde yanıt bekler. Uzun süren işleri mümkün olduğunca yanıt yolunun dışında tutun ve araçlarınızı hızlı veya asenkron yapın.

MonoChat’te adım adım

1. Ajanınızı HTTPS arkasında dağıtın

LangGraph, ADK, CrewAI veya özel ajanınızı kendi sunucunuzda veya bulutunuzda, HTTPS üzerinden erişilebilir şekilde barındırın. MonoChat’in istek ve yanıt biçimini ve paylaşılan anahtar kontrolünü uygulayın.

2. Özel sağlayıcıyla bir AI Harness ekleyin

MonoChat’te bir AI Harness ekleyin, Özel’i seçin ve uç nokta URL’nizi ile paylaşılan gizli anahtarınızı girin. Harness’i bir kez eklersiniz ve istediğiniz kadar akışta kullanabilirsiniz.

3. Bir akışa AI Agent düğümü ekleyin

Gelen konuşmaları karşılayan akışa bir AI Agent düğümü ekleyin ve özel harness’inizi seçin. Çevresindeki akışı, akışların en iyi yaptığı işler için kullanın: karşılama, dile veya konuya göre yönlendirme, çalışma saatleri ve bir kişiye giden yol.

4. Çalıştırma başına bir bütçe belirleyin

Her AI Agent düğümü çalıştırma başına bütçe sınırlarını destekler. Bunları kendi kodunuzda zaten uyguladığınız sınırların yanında bir güvenlik ağı olarak kullanın.

5. WhatsApp’ı ve diğer kanalları bağlayın

WhatsApp Business numaranızı bağlayın, ardından aynı akışı kullandığınız diğer kanallara ekleyin. Kanal başına ek entegrasyon işi yoktur: uç noktanız kanal API’lerini değil, konuşmaları görür.

6. Test edin, sonra yayına alın

Gerçek müşteri mesajlarını akıştan yeniden oynatın. Araç çağrılarını, yanıt sürelerini, üslubu ve devri kontrol edin. Canlı trafiğin ilk günlerini yakından izleyin, ardından ajanın yapmasına izin verilenleri genişletin.

Çerçeve notları

LangGraph. Düğümlerden ve kenarlardan oluşan bir grafik, destek yolculuklarına (ön eleme, sorgulama, çözme, eskalasyon) doğal olarak uyar. Derlenmiş grafiği küçük bir HTTP hizmetine sarın, her istekte konuşmanın durumunu yükleyin ve son mesajı döndürün.

Google ADK. ADK’nın çoklu ajan ağaçları, yani uzman alt ajanlara sahip bir koordinatör, destek, satış ve faturalama ekiplerine iyi karşılık gelir. Kök ajanı uç noktanız üzerinden sunun ve yönlendirmeyi ADK’nın kendi içinde yapmasına izin verin.

CrewAI. Rol tabanlı ajan ekipleri, önce araştırma sonra yanıt gibi net devirlerin olduğu görevlerde iyi çalışır. Sohbet için ekipleri küçük tutun: her ek ajan gecikme ekler.

Kendi kodunuz. Bir model API’si ve birkaç fonksiyonla düz bir döngü çoğu zaman yeterlidir. Tam kontrol sizde kalır; MonoChat kanalları ve gelen kutusunu sağlar.

Devir: akışta karar verin

Hangi konuşmaların bir kişiye gideceğine ve hangi ekibin alacağına akışta karar verin ve ajanınızı, yardımcı olamadığında tahmin yürütmek yerine bunu müşteriye dürüstçe söyleyecek şekilde yazın. Akış daha sonra konuşmayı ortak gelen kutusunda tüm geçmişiyle doğru ekibe devreder. WhatsApp’ın Business Messaging Policy politikası da otomatik yanıtların bir insana net bir yol sunmasını bekler.

Ajanınızı işletmenizin içinde de tutun. 15 Ocak 2026’dan beri WhatsApp genel amaçlı yapay zekâ asistanlarını platformun dışında tutuyor; kendi müşterilerinize hizmet veren ajanlar sorun değil. WhatsApp yapay zekâ chatbot politikası rehberimiz kuralı açıklıyor.

Ne zaman kendinizinkini geliştirmemelisiniz?

Özel bir ajan en esnek seçenektir ve aynı zamanda bakımını sizin yaptığınız seçenektir. Sıfırdan başlıyorsanız, yerleşik bir seçenek barındıracak bir şey olmadan sizi daha hızlı yayına alır:

• MonoChat yapay zekâ modellerinizde MonoChat’in yerleşik harness’i.
• MonoChat içinde çalışan OpenAI Agents SDK (rehber).
• MonoChat’in ajan çalıştırıcısında çalışan Claude Agent SDK veya Pi (Claude rehberi).
• Barındırılan ajanlar: kendi anahtarınızla OpenAI Agents API veya Claude Managed Agents.

Her seçenek aynı AI Agent düğümünü kullandığı için birinden başlayıp daha sonra kanallarınıza veya devrinize dokunmadan kendi ajanınıza geçebilirsiniz. Hepsini Agent Harness sayfasında karşılaştırın.