Webhooks

Webhook, Vivollo'nun sisteminizin omzuna dokunmasıdır. Kodunuzun durmadan "daha yeni bir şey var mı?" diye sormasını beklemek yerine, bir kez bir URL kaydedersiniz ve Vivollo bir şey olduğu anda — yeni bir mesaj, bir sohbet güncellemesi — oraya bir bildirim gönderir. Olaylara, tam gerçekleştikleri anda tepki vermek istediğiniz her durumda doğru araçtır.

Nasıl çalışır

Fikir basit:

1. Kendi tarafınızda bir uç nokta ayağa kaldırırsınız — bir HTTP isteği alabilen bir URL.
2. Onu Vivollo'da bir webhook olarak kaydeder ve hangi olayları önemsediğinizi seçersiniz.
3. O andan itibaren, bu olaylardan biri her gerçekleştiğinde Vivollo ayrıntıları gerçek zamanlı olarak uç noktanıza gönderir.

Kodunuz da bununla ne gerekiyorsa onu yapar: bir kayıt oluşturur, bir CRM kaydını günceller, bir kanala mesaj atar, bir iş akışını tetikler.

Abone olabileceğiniz olaylar

Vivollo'nun sizi tam olarak hangi olaylar hakkında bilgilendireceğini siz seçersiniz; böylece yalnızca sizin için önemli olanları duyarsınız:

• message.created — bir sohbette yeni bir mesaj gönderildi ya da alındı.
• conversation.updated — bir sohbetin durumu ya da hali değişti (örneğin sonuçlandırıldı veya devredildi).
• session.updated — bir ziyaretçinin oturum ayrıntıları ya da meta verileri değişti.
• user.updated — bir müşterinin iletişim bilgileri değişti.

Her bildirim, ilgili ayrıntıları taşır — mesajı ve sohbetini, müşteriyi, kanalı — böylece sisteminiz harekete geçmek için gereken her şeye sahip olur, hemen geri arayıp daha fazlasını istemesine gerek kalmadan.

Bir tane kurmak

Bir webhook oluştururken şunları sağlarsınız:

• Bir ad — bu webhook'un ne işe yaradığını hatırlamanız için.
• URL — olayları alan, güvenli (https) uç noktanız.
• Olaylar — yukarıdakilerden hangilerine abone olacağınız.
• Özel başlıklar (Custom headers) — isteğe bağlı; isteği kendi tarafınızda doğrulamanın alışılmış yolu (örneğin, uç noktanızın çağrıya güvenmeden önce kontrol ettiği gizli bir anahtar).

Güvenilir teslimat

Ağlar tökezler, uç noktalar ara sıra devre dışı kalır; bu yüzden Vivollo ilk denemede pes etmez — başarısız teslimatlar yeniden denenir ve teslimat günlüklerini inceleyerek neyin, ne zaman gönderildiğini ve uç noktanızın nasıl yanıt verdiğini görebilirsiniz. Bu sayede düzgün çalışmayan bir entegrasyonu ayıklamak kolaylaşır ve olayları sessizce kaçırmadığınızdan emin olursunuz.

Webhook'lar ve API, birlikte

Webhook'lar ve REST API doğal bir ikilidir. Webhook size bir şey olduğunu söyler; API ise bildirimin taşıdığından fazlasına ihtiyaç duyduğunuzda tüm resmi çekmenizi sağlar. Yaygın bir kalıp:

conversation.updated webhook'u tetiklenir → kodunuz API'yi çağırıp sohbetin tamamını çeker → siz de bunu kendi sisteminizde işlersiniz.

Kaç tane olabilir

Kaydedebileceğiniz webhook sayısı planınızın bir parçasıdır; bkz. Planlar ve limitler. Ayrıca unutmayın, her webhook geçerli bir API anahtarı bağlamına ihtiyaç duyar — henüz kurmadıysanız önce onu kurun.