Tetikleyiciler ve Olaylar

Müşteri adayı yakalama tetikleyicisi, Chattlebot'ta webhook'ların en yaygın tetiklenme şeklidir. Bir ziyaretçi chatbot aracılığıyla bilgilerini — e-posta, ad, telefon numarası veya diğer yakalanan veriler — gönderdiğinde, Müşteri Adayı Yakalama tetikleyicisi etkin olan tüm webhook'lar otomatik olarak tetiklenir. Bu sıralı değil, eşzamanlı olur — yani müşteri adayı yakalamalarını dinleyen üç webhook'unuz varsa (biri Zapier'a, biri CRM'inize, biri Slack'e), üçü de aynı anda tetiklenir. Yapılandırma basittir: 'Müşteri Adayı Yakalamada Tetikle' düğmesini açın. İsteğe bağlı olarak yalnızca belirli aciliyet seviyeleri — Düşük, Orta veya Yüksek — için tetiklemek üzere bir aciliyet filtresi ayarlayın. Örneğin, tüm müşteri adaylarını CRM'inize göndermeye devam ederken yalnızca yüksek aciliyetli müşteri adayları hakkında Slack kanalınızı bilgilendirebilirsiniz. Aciliyet seviyesi, Chattlebot'un konuşmanın AI analizi tarafından belirlenir.

İş akışı tetikleyicisi, bir otomasyon iş akışında adım olarak webhook'u tetikler. Olaylarda otomatik olarak tetiklenmek yerine, webhook 'execute_webhook:{webhookId}' eylem formatı kullanılarak iş akışınızdaki belirli bir noktada açıkça çağrılır. Bu, webhookun ne zaman çalışacağı ve hangi verileri alacağı üzerinde hassas kontrol sağlar. Bir iş akışında kullanıldığında, yalnızca müşteri adayı verileri değil, önceki iş akışı adımlarında toplanan veya hesaplanan veriler de dahil olmak üzere tüm iş akışı değişkenleri webhook payload şablonunda kullanılabilir. Webhook yürütüldükten sonra, yanıt verileri çıkarılır ve 'webhook_' önekiyle sonraki iş akışı adımlarına sunulur. Örneğin, webhook'unuz 'status' alanıyla JSON yanıtı döndürürse, bir sonraki iş akışı adımı buna 'webhook_status' olarak erişebilir. Bu, iş akışlarını çok adımlı otomasyonlar için güçlü kılar: müşteri adayı yakalayın, verileri webhook ile zenginleştirin, ardından zenginleştirilmiş sonuca göre yönlendirin.

AI araç tetikleyicisi, AI chatbot'un konuşma sırasında gerçek zamanlı veriye ihtiyaç duyduğuna karar verdiğinde tetiklenir. Bu, diğer tetikleyicilerden temelden farklıdır — webhook'un ne zaman çalışacağını siz tanımlamak yerine, AI kullanıcının ne sorduğuna göre karar verir. Bunu etkinleştirmek için webhook'ta 'ai_callable' özelliğini true olarak ayarlayın ve bir araç adı, açıklama ve parametreler yapılandırın. Bir sohbet başladığında, AI tüm mevcut AI-callable webhook'ları araç kutusundaki araçlar olarak yükler. Kullanıcı gerçek zamanlı bilgi gerektiren bir soru sorduğunda — ürün mevcudiyeti, randevu müsaitliği veya sipariş durumu gibi — AI mevcut araçlarını değerlendirir, doğru olanı seçer, gerekli parametreleri konuşma bağlamından toplar ve webhook'u tetikler. Yanıt verileri AI'a geri döner ve AI bunu kullanıcıya doğal dilde yanıt vermek için kullanır. Tam yapılandırma rehberi için, etkili AI açıklamaları yazma, parametreleri tanımlama ve yanıt filtreleme kurma dahil, AI Çağrılabilir Webhook'lar rehberine bakın.

Manuel test tetikleyicisi kurulum ve hata ayıklama içindir — canlıya geçmeden önce her şeyin çalıştığını doğrulamak için isteğe bağlı olarak webhook'u tetiklemenizi sağlar. Bir test isteği göndermek için webhook düzenleyicisindeki 'Test Webhook Gönder' düğmesine tıklayın. Chattlebot gerçek bir müşteri adayı yakalamasını yansıtan örnek veriler oluşturur: bir test e-posta adresi, örnek ad, demo telefon numarası, varsayılan aciliyet ve duygu değerleri, sahte konuşma transkripti ve güncel zaman damgaları. Test sonucu HTTP durum kodunu, yanıt gövdesini ve yürütme süresini gösterir. Yürütme geçmişinde, test tetiklemeleri gerçek tetikleyicilerden kolayca ayırt edebilmeniz için 'triggered_by: test' olarak kaydedilir. Webhook URL'sini değiştirdiğinizde, payload şablonunu düzenlediğinizde, kimlik doğrulama bilgilerini güncellediğinizde veya alıcı uç noktanın düzgün çalıştığını doğrulamak istediğinizde manuel testler kullanın.

Tek bir webhook'ta birden fazla tetikleyici aynı anda etkinleştirilebilir. En yaygın kombinasyon Müşteri Adayı Yakalama + AI-Callable'dır — aynı webhook hem müşteri adayı yakalandığında hem de AI sohbet sırasında veriye ihtiyaç duyduğunda tetiklenir. Ancak tetikleyicileri birleştirmek dikkatli değerlendirme gerektirir. Bir webhook'ta hem müşteri adayı yakalama hem de AI-callable tetikleyicileri etkinleştirildiğinde, uç noktanız aynı müşteri adayının verilerini birden fazla kez alabilir: müşteri adayı yakalama olayından bir kez ve aynı konuşma sırasında bir AI araç çağrısından potansiyel olarak tekrar. Bunu güvenle ele almak için uç noktalarınızı idempotent olarak tasarlayın — yani aynı veriyi iki kez işlemek aynı sonucu üretir. Kör eklemeler yerine upsert mantığı (varsa güncelle, yoksa oluştur) kullanın. Örneğin, CRM uç noktanız müşteri adayının e-postasını benzersiz anahtar olarak kullanıyor ve kişi kaydını upsert ediyorsa, yinelenen çağrılar yinelenen kişiler oluşturmaz. Başka bir yaklaşım, tetikleyici türlerini ayırt etmek ve her birini uygun şekilde ele almak için payload'daki 'triggered_by' alanını kontrol etmektir.