Özel Webhook'lar

Özel webhook'lar, kendi API'nize, dahili bir servise veya Zapier, n8n ya da Make şablonları tarafından kapsanmayan bir platforma bağlanmanız gerektiğinde kullanılır. Özel webhook'larla HTTP isteğinin her yönü üzerinde tam kontrole sahipsiniz: URL, yöntem, başlıklar, payload formatı ve kimlik doğrulama. Yaygın kullanım alanları arasında müşteri adaylarını kendi backend API'nize gönderme, sektöre özel CRM'lerle entegrasyon, self-hosted araçlara bağlanma veya HTTP isteklerini kabul eden herhangi bir REST API'yi çağırma yer alır.

Chattlebot panelinizde botunuzun Eylemler sayfasına gidin ve 'Özel Webhook'lar' → 'Webhook Ekle' düğmesine tıklayın. Şablon seçiciden 'Özel Webhook' şablonunu seçin. Bu, tüm ayarların kilidi açık bir boş tuval sağlar. Webhook'unuz için açıklayıcı bir ad girin ve uç nokta URL'nizi yapıştırın — bu, veri göndermek istediğiniz API veya servisin URL'sidir. API'niz gerektiriyorsa URL sorgu parametreleri içerebilir.

API'nizin beklediği HTTP yöntemini seçin. POST en yaygın seçimdir — müşteri adayı verilerini istek gövdesinde gönderir. GET, veri almanız gerektiğinde kullanılır (payload sorgu parametreleri olarak gönderilir). PUT tüm kaynağı değiştirir — CRM'inizdeki tam kayıt güncellemeleri için kullanışlıdır. PATCH kısmi güncelleme yapar — yalnızca eklediğiniz alanlar değiştirilir. DELETE bir kaynağı kaldırır — webhook'lar için nadiren kullanılır ancak temizlik iş akışları için mevcuttur. Emin değilseniz POST neredeyse her zaman doğru seçimdir.

API'niz kimlik doğrulama gerektiriyorsa, açılır menüden uygun türü seçin. Chattlebot dört kimlik doğrulama yöntemini destekler: Yok — kimlik bilgisi gönderilmez (Zapier catch hook'ları gibi URL tabanlı güvenliğe dayanan uç noktalar için). Basic — kullanıcı adı ve şifreyi Base64 olarak kodlanmış Authorization başlığında gönderir. Bearer Token — bir jetonu Authorization başlığında 'Bearer {jetonunuz}' olarak gönderir (OAuth2 APIleri ve JWT tabanlı servisler için yaygın). API Key — özel bir başlık (X-API-Key gibi) anahtar değerinizle gönderir (üçüncü taraf API platformları için yaygın). Her tür için ayrıntılı kurulum talimatları Kimlik Doğrulama rehberine bakın.

Payload şablonu, her webhook isteğiyle gönderilen JSON gövdesini tanımlar. Varsayılan şablon tüm mevcut müşteri adayı ve konuşma değişkenlerini içerir, ancak API'nizin beklediği formata uyacak şekilde değiştirebilirsiniz. Dinamik değerler eklemek için {{değişken}} sözdizimini kullanın — örneğin {{lead.email}} müşteri adayının e-posta adresini ekler. Değişkenleri özel JSON yapıları içinde iç içe yerleştirebilir, alanları yeniden adlandırabilir, statik değerler ekleyebilir ve ihtiyacınız olmayan alanları kaldırabilirsiniz. Yaygın değişkenler lead.email, lead.name, lead.phone, lead.urgency, lead.category, lead.sentiment, conversation.summary ve bot.name'dir. Kullanılabilir değişkenlerin tam listesi için Payload Referansı rehberine bakın.

Özel başlıklar, webhook isteğinizle ek meta veriler eklemenizi sağlar. Content-Type varsayılan olarak 'application/json' olarak ayarlanır. API'niz gerektirdiğinde özel başlıklar ekleyin — yaygın örnekler arasında API sürümleme başlıkları (X-API-Version gibi), içerik müzakere başlıkları, izleme başlıkları (isteğin Chattlebot'tan geldiğini belirlemek için X-Source gibi) veya istek izleme için korelasyon kimlikleri yer alır. Yeni bir başlık eklemek için 'Başlık Ekle' tıklayın ve ad-değer çifti girin. Başlık değerlerinde de değişkenler ({{...}}) kullanılabilir.

Yanıt eşleme, API yanıtından belirli değerleri çıkarmanıza ve bunları iş akışlarında veya AI'ın referans alabileceği veriler olarak kullanmanıza olanak tanır. Yanıttaki belirli bir alanı hedeflemek için bir JSONPath ifadesi ($.id veya $.data.status gibi) ve çıkarılan değeri saklamak için bir değişken adı belirleyerek bir eşleme ekleyin. Ayrıca alan yanıtta eksik olduğunda kullanılacak bir varsayılan değer ayarlayabilirsiniz. Bu, iş akışlarında webhook'ları zincirlerken özellikle kullanışlıdır — çıkarılan değerler sonraki adımlarda 'webhook_' önekiyle değişken olarak kullanılabilir hale gelir. Gelişmiş JSONPath örnekleri ve kalıpları için Yanıt Eşleme rehberine bakın.

Uç noktanıza örnek veri göndermek için 'Test Webhook Gönder' düğmesine tıklayın. Test sonuçları HTTP durum kodunu, yanıt gövdesini ve yürütme süresini gösterecek. Şunları doğrulayın: bağlantı başarılı (200 OK veya API'nizin beklenen başarı kodu), kimlik doğrulama kabul edildi (401 veya 403 hatası yok), yanıt formatı beklediğiniz gibi ve yanıt eşlemeleri yapılandırdığınız alanları doğru şekilde çıkarıyor. Her şey iyi görünüyorsa, düğmeyi kullanarak webhook'u etkinleştirin. Özel webhook'unuz artık aktif ve yapılandırdığınız tetikleyicilere göre çalışacak. Devam eden başarı oranlarını ve hataları izlemek için webhook'un sağlık panosunu izleyin.