Webhooks

Olaylar gruplara ayrılır: Contacts, Conversations, Messages, ekibinize Handovers, AI agent, Bookings, Reminders, Orders, Products, Calls, Campaigns, Forms, Account ve channels, ayrıca Workspace settings. Bir grup açın ve tek tek olayları işaretleyin ya da tüm grubu almak için Tümünü seç’a basın. Bir şeyin nerede olduğunu mu bulamıyorsunuz? Arama kutusuna örneğin "booking" veya "tag" yazın. Entagl’ın tam olarak ne göndereceğinin örneğini görmek için herhangi bir olaya dokunun. Bazı olaylarda kaynağın neresi olacağını da seçebilirsiniz; böylece yalnızca AI’ın yaptığı bookings gelir, ekibinizin takvime girdiği olanlar gelmez.

Gelen mesaj ve Giden mesaj her mesaj için tetiklenir. Yoğun bir hesapta bu, günde binlerce olabilir. Bu yüzden Tümünü seç bunları atlar: her birini yanındaki uyarıyla tek tek işaretlemeniz gerekir. Bunları yalnızca diğer taraftaki araç bu kadar yükü kaldırabiliyorsa açın. Sadece bir sohbetin ne zaman başladığını veya bittiğini bilmek istiyorsanız, Konuşma açıldı ve Konuşma kapatıldı çok daha sakindir.

Entagl’dan ne kadar müşteri bilgisinin çıkacağını iki anahtar belirler. Mesaj içeriğini dahil et, müşterilerin yazdıklarını ekler: mesajlar, notlar ve call özetleri. İletişim bilgilerini dahil et, müşterinin adını, telefon numarasını ve email adresini ekler. İkisi de başlangıçta kapalıdır. Yine de bunlar olmadan da tüm olayları alırsınız; ayrıntıların yerinde contact ID olur. Bunları yalnızca workspace sahibi veya bir admin açabilir; yalnızca alan aracın müşteri verisini saklamaya yetkisi varsa açın. HIPAA workspace’inde anahtarlar ne derse desin müşteri verisi asla gönderilmez.

Araçlar ve geliştiriciler, Entagl API üzerinden kendi webhook'larını kaydedebilir ve bunlar Bağlı uygulamalar altında kendiliğinden görünür. Her biri için kaç olayı dinlediğini ve en son ne zaman bir olay aldığını görürsünüz. Son teslimatlar bölümünü açabilir, Duraklat ve Devam et düğmeleriyle yönetebilir ya da Kaldır düğmesiyle kaldırabilirsiniz. Make scenario'larının kendi sayfası vardır: Kanallar → Make.

Entagl’ın göndermeye çalıştığı son 50 olayı görmek için Son teslimatlar’a basın; en yenisi üstte olur. Her biri teslim edilip edilmediğini, aracınızın verdiği yanıtı (200 veya 500 gibi), kaç deneme gerektiğini ve sonraki denemenin ne zaman olacağını gösterir. Bir teslimat kalıcı olarak başarısız olduğunda, sorunu kendi tarafınızda düzeltin ve Yeniden gönder’e basın. Entagl bunu birkaç saniye içinde gönderir.

Aracınız kapalıysa ya da hata yanıtı veriyorsa, Entagl 30 saniye, 2 dakika, 10 dakika, 1 saat, 6 saat ve 24 saat sonra tekrar dener. Bu, bir teslimatın başarısız olarak işaretlenmesine kadar yaklaşık 31 saat demektir. Bağlı bir uygulama 3 gün boyunca aralıksız başarısız olursa, Entagl onu duraklatır ve workspace sahibine bildirim gönderir. Aracı düzeltin, sonra Devam et’a basın. Make bir senaryonun webhook’unun artık var olmadığını bildirirse, Entagl ona hemen gönderimi durdurur.

Her istek, signing secret’ınızla oluşturulmuş bir imzayı X-Entagl-Signature header’ında taşır. Geliştiriciniz bunu isteğin Entagl’dan geldiğini ve yolda kimsenin değiştirmediğini doğrulamak için kullanır.

• Connected apps ve API üzerinden oluşturulan webhooks, t=1767225600,v1=5257a869… gönderir. t kısmı, gönderim zamanını saniye cinsinden gösterir. Her v1, timestamp.body metninin (yani t değeri, bir nokta ve ardından ham request body) HMAC-SHA256 sonucudur ve secret’ınızla oluşturulur. t değeri 5 dakikadan eski olan istekleri reddedin; böylece eski bir istek yeniden oynatılamaz. Secret değişikliğinden hemen sonra iki v1 değeri görebilirsiniz: İkisi de eşleşirse isteği kabul edin.
• Bu sayfada kurduğunuz webhook, ham request body’nin HMAC-SHA256 değeriyle birlikte sha256= gönderir.