AI Çağrılabilir Webhook'lar

AI çağrılabilir webhook'lar chatbotunuza bir araç kutusu verir. Bir müşteri gerçek zamanlı veri gerektiren bir şey sorduğunda — ürün mevcudiyeti, randevu müsaitliği veya fiyatlandırma gibi — AI araç kutusundan doğru aracı seçer ve yanıtı anında alır. Olaylarda (müşteri adayı yakalama gibi) tetiklenen normal webhook'ların aksine, AI çağrılabilir webhook'lar konuşma sırasında AI'ın kendisi tarafından tetiklenir. Her birine bir ad, ne yaptığının açıklaması ve ihtiyaç duyduğu parametreleri vererek araçları tanımlarsınız. AI bu açıklamaları okur ve konuşma bağlamına göre her aracı ne zaman çağıracağına karar verir. Örneğin, bir 'check_inventory' aracı oluşturursanız ve kullanıcı 'Mavi spor ayakkabının 42 numarası var mı?' diye sorarsa, AI envanter verisine ihtiyaç duyduğunu fark eder, webhook'unuzu ürün adı ve beden ile çağırır ve yanıtı kullanarak müşteriye yanıt verir — hepsi gerçek zamanlı, aynı sohbet mesajı içinde.

İşte kurulumdan yürütmeye kadar tam akış: İlk olarak, AI-callable etkin webhook'lar oluşturarak, her birine bir araç adı, açıklama ve parametreler vererek araçlarınızı tanımlarsınız. Bir sohbet oturumu başladığında, AI tüm mevcut AI-callable webhook'ları araç olarak yükler. Kullanıcı bir soru sorar — örneğin 'Mavi spor ayakkabının 42 numarası var mı?'. AI, araçlarından herhangi birinin soruyu yanıtlamaya yardımcı olup olamayacağını değerlendirir. Evet ise, doğru aracı seçer (bu durumda 'check_inventory'). AI gerekli parametreleri konuşma bağlamından toplar — 'mavi spor ayakkabı' ürün_adı ve '42' beden olarak çıkarılır. Webhook tetiklenir, bu parametrelerle uç noktanıza HTTP isteği gönderir. API'niz JSON yanıtı döndürür (ör. available: true, price: 899,99 TL). AI yanıtı alır ve doğal dilde bir yanıt oluşturur: 'Evet! 42 numara mavi spor ayakkabı mevcut ve fiyatı 899,99 TL.' Tüm süreç saniyeler içinde, konuşma akışı içinde sorunsuzca gerçekleşir.

Bir webhook'u AI-callable yapmak için, webhook ayarlarındaki 'AI-Callable' düğmesini etkinleştirin. Bu, üç alanlı AI yapılandırma bölümünü ortaya çıkarır. Araç Adı: yalnızca küçük harfler ve alt çizgiler kullanan kısa, açıklayıcı bir tanımlayıcı (ör. 'check_inventory', 'get_appointments', 'track_order'). Maksimum 50 karakter. Bu, AI'ın aracı tanımlamak için kullandığı dahili addır. AI için Açıklama: AI'a bu aracı ne zaman ve nasıl kullanacağını söyleyen doğal dilde bir açıklama. Bu en önemli alandır — bir insan asistanına talimat veriyormuş gibi yazın. Aracın ne yaptığını, ne zaman çağrılacağını ve hangi parametrelerin toplanacağını ekleyin. Parametreler: AI'ın konuşmadan toplaması gereken giriş parametrelerini tanımlayın. Her parametrenin bir adı, türü (String, Number veya Boolean), zorunlu olup olmadığı ve açıklaması vardır. AI, konuşmadan hangi değerleri çıkaracağını anlamak için açıklamaları kullanır. Örneğin, 'Müşterinin sorduğu ürünün adı' açıklamasına sahip bir 'product_name' parametresi, AI'ın doğru değeri çıkarmasına yardımcı olur.

AI için yazdığınız açıklama, aracınızın ne kadar iyi çalıştığının en önemli faktörüdür. 'Bu webhook envanteri kontrol eder' gibi belirsiz bir açıklama, AI'a ne zaman çağırılacağı veya neyin çıkarılacağı konusunda rehberlik sağlamaz. İyi bir açıklama üç konuda spesifiktir: aracın ne yaptığı, ne zaman çağrılacağı ve hangi parametrelerin toplanacağı. İyi örnek: 'Mağazamızda ürün mevcudiyetini ve fiyatlandırmayı kontrol edin. Müşteri stok, envanter, bir ürünümüzün olup olmadığı veya ürün mevcudiyeti hakkında sorduğunda çağırın. product_name parametresi gerektirir — müşterinin bahsettiğinden çıkarın.' Bu, AI'a aracın tam olarak ne yaptığını (mevcudiyet ve fiyatlandırmayı kontrol eder), tetikleyici ifadeleri (stok, envanter, bir ürünümüzün olup olmadığı) listeler ve parametre toplamayı yönlendirir (müşterinin bahsettiğinden çıkar). Diğer ipuçları: kullanıcıların nasıl sorabileceğinin yaygın varyasyonlarını ekleyin (ör. 'Sizde ... var mı?', '... stokta mı?', '... ne kadar?'). Yanlış tetiklemeleri önlemek için aracın ne YAPMADIĞINI belirtin. Parametreler isteğe bağlıysa, ne zaman dahil edileceğini açıklayın.

Parametreler, AI'ın webhook'u çağırmadan önce konuşmadan toplaması gereken bilgileri tanımlar. Her parametrenin dört alanı vardır: Ad (istekte gönderilen JSON anahtarı, ör. 'product_name'), Tür (metin değerleri için String, sayısal değerler için Number, doğru/yanlış bayrakları için Boolean), Zorunlu (AI'ın çağırmadan önce bunu toplaması gerekip gerekmediği) ve Açıklama (AI'ın hangi değeri çıkaracağını anlamasına yardımcı olur). String parametreleri en yaygındır — adlar, kimlikler, açıklamalar ve herhangi bir metin girişi için kullanılır. Number parametreleri miktarlar, fiyatlar ve sayısal kimlikler için kullanılır. Boolean parametreleri 'include_details' veya 'check_all_sizes' gibi bayraklar için kullanışlıdır. Bir parametre zorunlu olarak işaretlendiğinde, konuşmada zaten mevcut değilse AI kullanıcıdan bilgiyi ister. Örneğin, 'product_name' zorunluysa ve kullanıcı 'Stokta ne var?' derse, AI webhook'u çağırmadan önce 'Hangi ürünle ilgileniyorsunuz?' diye soracaktır. İsteğe bağlı parametreler, AI bağlamdan çıkarabilirse gönderilir, ancak onlar olmadan da webhook tetiklenir.

Yanıt filtreleme, AI'ın webhook yanıtından hangi verileri göreceğini kontrol etmenizi sağlar. Bu üç nedenden dolayı önemlidir: gizlilik (dahili kimlikler veya maliyetler gibi hassas alanları gizleyin), alaka düzeyi (yalnızca kullanıcının sorgusuna uyan sonuçları gösterin) ve token verimliliği (AI'ın işlediği veri miktarını azaltın, bu da yanıt hızını ve doğruluğunu artırır). Bir filtre yapılandırmak için ayarlayın: hedef değişken (yanıttaki filtrelenecek dizi alanı, ör. 'products'), koşullar ('in_stock equals true' veya 'price less_than 100' gibi bir veya daha fazla kural) ve isteğe bağlı limit (maksimum sonuç sayısı). Koşullar AND mantığı kullanır — bir öğenin dahil edilmesi için tüm koşulların eşleşmesi gerekir. Mevcut operatörler: equals, not_equals, contains, not_contains, greater_than, less_than, greater_than_or_equal ve less_than_or_equal. Örneğin, 'in_stock' equals 'true' ile 5 limitli bir ürün kataloğu yanıtını filtrelemek, AI'ın tüm katalog yerine yalnızca 5 stokta olan ürünü göreceği anlamına gelir.

AI çağrılabilir webhook'ların kötüye kullanımı önlemek ve güvenilir performans sağlamak için hız limitleri vardır. Limitler: oturum başına 10 çağrı (sohbet konuşması başına) ve saat başına 50 çağrı (webhook başına). Bir limite ulaşıldığında, AI oturumun veya saatin geri kalanı için o aracı çağırmayı durdurur ve ya elindeki bilgilerle yanıt verir ya da kullanıcıya o anda kontrol edemediğini bildirir. Bu limitler tipik konuşmalar için yeterlidir ancak bilmekte fayda var. AI çağrılabilir webhook'lar için en iyi uygulamalar: API yanıt sürelerinizi 5 saniyenin altında tutun — AI yanıtı bekler ve uzun gecikmeler sohbette doğal olmayan hissedilir. Net, spesifik araç açıklamaları yazın — bu, güvenilir araç seçiminin bir numaralı faktörüdür. Yalnızca teknik test senaryoları değil, gerçek konuşma soruları ile test edin. AI çağrı başarı oranlarını ve yanıt sürelerini izlemek için webhook'unuzun sağlık panosunu izleyin. Veriyi yalın tutmak için yanıt filtreleme kullanın — daha küçük yanıtlar daha hızlı AI işleme ve daha doğru yanıtlar anlamına gelir. Yalnızca zorunlu parametrelerle başlayın, temel akış çalıştıktan sonra isteğe bağlı olanları ekleyin.