CONVIRO
Engineering

Webhook Nedir? Yazılımcı Olmayanlar İçin Chatbot'unuzu Diğer Araçlara Bağlama Rehberi

Webhook, bir uygulamanın bir şey olduğu anda başka bir uygulamaya gönderdiği otomatik bir mesajdır. Chatbot webhook'larının nasıl çalıştığını, API'den farkını ve nasıl güvenli…

Conviro
15 Eylül 20267 dk okuma
Webhook Nedir? Yazılımcı Olmayanlar İçin Chatbot'unuzu Diğer Araçlara Bağlama Rehberi
Şu dillerde mevcut:DEENESETFRITLTNLPLPTTR
Bu yazıda

Peki, webhook nedir? Webhook, bir uygulamanın bir şey olduğu anda, örneğin chatbot'unuz yeni bir potansiyel müşteri yakaladığında, başka bir uygulamaya gönderdiği otomatik bir mesajdır. Diğer araçlarınız birkaç dakikada bir "Yeni bir şey var mı?" diye sormak zorunda kalmaz; chatbot onlara hemen haber verir.

Bunu, her saat başı posta kutunuza kadar yürümekle kapı zili arasındaki fark gibi düşünün. Kapı zili yalnızca gerçekten kapıda biri olduğunda çalar.

Aşağıda chatbot webhook'larının nasıl çalıştığını, API ile nasıl karşılaştırıldığını, hangi olayların gönderilmeye değer olduğunu ve webhook'ları nasıl güvende tutacağınızı bulabilirsiniz.

Öne çıkanlar

  • Webhook, bir olay gerçekleştiğinde verileri başka bir sisteme iter; API ise genellikle veri çekmek için sizin çağırdığınız bir şeydir.
  • Faydalı chatbot webhook'ları yeni bir potansiyel müşteri, bir insana devir veya kapanan bir konuşma gibi iş olaylarında tetiklenir.
  • HMAC imzaları bir mesajın gerçek olduğunu kanıtlar; yeniden denemeler ise kısa bir kesintinin veri kaybına yol açmamasını sağlar.

Sade bir dille webhook nedir?

Bir webhook'un üç parçası vardır:

  1. Olay (event): Kaynak uygulamada bir şey olur; örneğin bir ziyaretçi sohbette e-posta adresini bırakır.
  2. URL: Alıcı sistemin adresidir ve genellikle uç nokta (endpoint) olarak adlandırılır. Bu adresi kaynak uygulamanın ayarlarına yapıştırırsınız.
  3. Veri paketi (payload): Ne olduğunu açıklayan, genellikle JSON biçimindeki küçük bir veri paketidir.

Olay gerçekleştiğinde kaynak uygulama veri paketini o URL'ye gönderir. Alıcı sistem paketi okur ve işe yarar bir şey yapar: Bir kişi kaydı oluşturur, bir uyarı paylaşır, bir tabloya satır ekler. Kimsenin bir düğmeye basması veya değişiklikleri kontrol eden bir betik yazması gerekmez.

Alıcı tarafı kendiniz kurmak zorunda da değilsiniz. Zapier, Make ve n8n gibi otomasyon platformları birkaç tıklamayla sizin için bir webhook URL'si oluşturabilir; yazılımcı olmayanların webhook kullanabilmesinin nedeni de budur.

Webhook ve API: Farkı nedir?

İnsanlar bu ikisini çoğu zaman rakip gibi görür; oysa birlikte çalışırlar. API (uygulama programlama arayüzü), verileri okumak veya değiştirmek için kapısını çaldığınız, bir uygulamaya açılan kapılar bütünüdür. Webhook ise bir şey olduğunda uygulamanın sizin kapınızı çalmasıdır.

Webhook olmadan yeni olaylardan haberdar olmanın tek yolu sorgulamadır (polling): API'ye bir şeyin değişip değişmediğini tekrar tekrar sormak.

Webhook (itme) API sorgulama (çekme)
Kim başlatır? Kaynak uygulama, bir olay gerçekleştiğinde Sizin sisteminiz, belirli bir zamanlamayla
Hız Neredeyse gerçek zamanlı Sorgulama aralığınız ne kadarsa o kadar
En uygun kullanım Uyarılar, yeni kayıtları senkronize etme, iş akışlarını başlatma Toplu dışa aktarımlar, raporlar, anlık sorgular
Kurulum Bir URL yapıştırın, olayları seçin Bir betik veya zamanlanmış görev yazın
Başlıca risk Alıcı çalışmıyorsa kaçırılan mesajlar (yeniden denemelerle çözülür) Gecikmeler, boşa giden istekler, istek sınırları

Birçok entegrasyon ikisini birden kullanır. Webhook "123 numaralı konuşma az önce temsilciye devredildi" der; alıcı sistem de daha fazla ayrıntıya ihtiyaç duyarsa API'yi çağırır.

Chatbot webhook'ları: Gönderilmeye değer örnek olaylar

En iyi chatbot webhook'ları, ekibinizin zaten önemsediği anlarla eşleşir. Üç yaygın örnek:

Yeni potansiyel müşteri yakalandı

Bir ziyaretçi iletişim bilgilerini paylaşır ve bir iki nitelendirme sorusunu yanıtlar. Tipik kullanımlar: CRM'de bir kişi kaydı oluşturmak veya güncellemek, satış kanalınızı uyarmak ya da potansiyel müşteriyi (onayıyla) bir ilgi besleme listesine eklemek. Yeni potansiyel müşterilere hızlı yanıt vermek daha fazla satış getirdiği için ekiplerin genellikle ilk kurduğu webhook budur.

Konuşma bir insana devredildi

Asistan konuşmayı bir insanın devralması gerektiğine karar verdi ya da müşteri bir temsilci istedi. Tipik kullanımlar: Nöbetçi temsilciyi bilgilendirmek, help desk'te bir talep (ticket) açmak veya öncelikli bir hesabı işaretlemek. Veri paketi; niyet, etiketler ve iletişim bilgileri gibi chatbot'tan insana devir sürecinizin dayandığı bağlamı taşımalıdır.

Konuşma kapandı

Bir konuşma, yapay zekâ veya bir temsilci tarafından çözülerek sona erdi. Tipik kullanımlar: Raporlama için kaydetmek, bir paneli güncellemek veya bir takip görevi oluşturmak.

Basit bir kural: Yalnızca harekete geçeceğiniz olaylara abone olun. Açtığınız her webhook, izlemeniz gereken bir şey daha demektir.

Webhook güvenliği: İmzalar, yeniden denemeler ve teslimat takibi

Bir webhook URL'si internette yalnızca bir adrestir. Birinin bu adrese sahte "yeni potansiyel müşteri" mesajları göndermesini ne engeller? Peki sunucunuz on dakika boyunca çalışmazsa ne olur? Bu soruları üç güvenlik önlemi yanıtlar.

HMAC imzaları. Gönderen ve alıcı gizli bir anahtarı paylaşır. Gönderen, veri paketinden ve gizli anahtardan bir imza hesaplar ve bunu her istekle birlikte gönderir. Alıcı imzayı yeniden hesaplar ve eşleşmeyen her şeyi reddeder; böylece sahte veya kurcalanmış mesajlar başarısız olur.

Yeniden denemeler. Alıcı teslimatı onaylamazsa gönderen, genellikle denemeler arasındaki süreyi giderek uzatarak daha sonra yeniden dener. Kısa bir kesinti veri kaybı anlamına gelmez.

Devre kesiciler ve teslimat takibi. Bir uç nokta sürekli hata veriyorsa devre kesici (circuit breaker), bozuk bir sunucuya art arda istek göndermek yerine teslimatları bir süreliğine duraklatır. Teslimat kayıtları neyin gönderildiğini ve başarılı olup olmadığını gösterir; böylece tahmin yürütmeden hata ayıklayabilirsiniz.

Alıcı tarafta birkaç alışkanlık sorunların çoğunu önler:

  • Verileri kullanmadan önce imzayı doğrulayın.
  • Hızlıca bir başarı koduyla yanıt verin, ağır işleri ise arka planda yapın.
  • Yinelenen olaylara hazırlıklı olun: Bir yeniden deneme aynı olayı iki kez teslim edebilir; tekrarları atlamak için olay kimliğini (event ID) kullanın.
  • Yalnızca HTTPS uç noktaları kullanın.
  • Yalnızca alıcı aracın ihtiyaç duyduğu kişisel verileri iletin; veriler sohbetten çıktıktan sonra da yapay zekâ chatbot'ları için GDPR (AB Genel Veri Koruma Tüzüğü) kuralları geçerliliğini korur.

Conviro gerçek zamanlı webhook'ları nasıl yönetir?

Conviro gerçek zamanlı webhook'lar sunar. Olaylar gerçekleştikleri anda uç noktanıza ulaşır; her isteği doğrulayabilmeniz için HMAC ile imzalanır, teslimat başarısız olursa otomatik olarak yeniden denenir ve bir devre kesiciyle korunur. Teslimat takibi neyin gönderildiğini ve ulaşıp ulaşmadığını gösterir.

Bu webhook'ları kendi kodunuza veya kodsuz bir araca yönlendirebilirsiniz: Conviro ayrıca Zapier, Make ve n8n ile bağlantı kurar; verileri istediğiniz anda çekmek için de bearer token kimlik doğrulaması ve kapsamı sınırlandırılmış anahtarlar içeren bir REST API sunar. Bunların tümü Pro ve üzeri planlarda kullanılabilir. Geliştirici belgeleri veri paketlerini ve imza kontrollerini anlatır; otomasyon entegrasyonları sayfası ise kodsuz yolları gösterir.

Sıkça Sorulan Sorular

Basitçe webhook nedir?

Webhook, belirli bir olay gerçekleştiğinde bir uygulamanın başka bir uygulamaya gönderdiği otomatik bildirimdir. Kaynak uygulamaya bir URL verir ve olayları seçersiniz; uygulama da her seferinde o URL'ye küçük bir veri paketi gönderir. Yazılımlar için bir kapı zili gibi çalışır: Alıcı sistem, sürekli kontrol etmek yerine değişikliklerden anında haberdar olur.

Webhook kullanmak için yazılımcıya ihtiyacım var mı?

Her zaman değil. Zapier, Make ve n8n gibi otomasyon platformları sizin için bir webhook URL'si oluşturur ve gelen verileri görsel bir düzenleyicide eylemlerle eşleştirmenizi sağlar. Kendi uç noktanızı kurduğunuzda, imzaları kodla doğruladığınızda veya hazır bağlayıcısı olmayan bir iç sistemi bağladığınızda ise bir yazılımcı işinize yarar.

Webhook, API'den daha mı hızlı?

Yeni olaylardan haberdar olmak için evet. Webhook olaydan birkaç an sonra ulaşır; API sorgulama ise ancak ne sıklıkla kontrol ettiğiniz kadar hızlıdır. Geçmiş veriler veya ek ayrıntılar için doğru araç API'dir. İyi kurgulanmış entegrasyonların çoğu bildirim için webhook'ları, bilgi sorgulamak için API'yi kullanır.

Webhook uç noktam çalışmazsa ne olur?

Bu, gönderene bağlıdır. İyi webhook sistemleri başarısız teslimatları belirli bir süre boyunca yeniden dener; böylece kısa kesintiler veri kaybına yol açmaz. Bazıları da sürekli hata veren bir uç noktaya teslimatı duraklatır. Sağlayıcınızın yeniden deneyip denemediğini kontrol edin ve uç noktanızın aynı olayın iki kez gelmesini güvenle işleyebildiğinden emin olun.

Sonraki adımlar

Bugün harekete geçeceğiniz bir olay seçin; bu genellikle yeni potansiyel müşterilerdir. Ardından bunu ekibinizin zaten çalıştığı araca bağlayın. Bu akış güvenilir şekilde çalışmaya başladığında devirleri ve kapanan konuşmaları ekleyin. Asistanınızı kurmak için Conviro ile ücretsiz başlayın; webhook'ları bağlamaya hazır olduğunuzda Pro plana geçin.

Paylaş:

Yayınlayan

Conviro

Yapay zekâ destekli müşteri desteği, chatbot otomasyonu ve SaaS büyüme stratejileri hakkında içgörüler paylaşıyoruz.

Conviro ile geliştirin

Konuşma iş akışlarını teknoloji altyapınıza bağlayın

Uygulamayı tasarlamadan önce geliştirici kaynaklarını ve entegrasyon kalıplarını inceleyin.

İlgili yazılar

Daha Fazla Yazı