Test ve Sağlık

Gerçek trafiğe açmadan önce webhook'unuzu her zaman test edin. Bir test isteği tetiklemek 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: test e-posta adresi, örnek ad, telefon numarası, varsayılan aciliyet ve duygu değerleri, sahte konuşma transkripti ve güncel zaman damgaları. Test sonucu üç önemli bilgi gösterir: HTTP durum kodu (200 başarı demektir), yanıt gövdesi (uç noktanızın döndürdüğü) ve yürütme süresi (isteğin ne kadar sürdüğü). 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. Test başarısız olursa, sorunu teşhis etmenize yardımcı olan hata durum kodunu ve yanıt gövdesini göreceksiniz.

Sağlık panosu, webhook'unuzun nasıl performans gösterdiğine dair gerçek zamanlı bir genel bakış sunar. Webhook listesindeki aktivite simgesine tıklayarak erişin. Pano dört temel metrik gösterir: son 24 saatteki başarı oranı, son 7 gündeki başarı oranı, tüm yürütmelerdeki ortalama yanıt süresi ve toplam yürütme sayısı. 24 saatlik ve 7 günlük başarı oranları hem anlık sorunları hem de uzun vadeli eğilimleri tespit etmenize yardımcı olur. 24 saatlik orandaki ani bir düşüş uç noktanızın çöktüğünü gösterebilirken, 7 gün içindeki kademeli bir düşüş API'niz daha fazla trafik aldıkça artan zaman aşımı sorunlarını düşündürebilir. Ortalama yanıt süresi, uç noktanızın ne kadar hızlı yanıt verdiğini söyler — çoğu kullanım senaryosu için ideal olarak 2 saniyenin altında ve AI çağrılabilir webhook'lar için 5 saniyenin altında (çünkü AI sohbet sırasında yanıtı bekler). Toplam yürütme sayısı hacim hakkında fikir verir — kapasite planlaması ve bir webhook'un ne kadar yoğun kullanıldığını anlamak için kullanışlıdır.

Yürütme günlüğü, her webhook tetiklenmesinin ayrıntılı kaydını gösterir. Listeyi filtreleyebilirsiniz: tüm yürütmeler, yalnızca başarılı veya yalnızca başarısız. Her giriş şunları gösterir: zaman damgası (ne zaman tetiklendi), tetikleyici türü (lead_capture, workflow, ai_tool veya test), HTTP durum kodu, yürütme süresi ve deneme numarası. Deneme numarası özellikle yeniden denemeleri hata ayıklamak için kullanışlıdır — bir webhook ilk denemede başarısız olmuş ancak yeniden denemede başarılı olmuşsa, deneme 1 (başarısız) ve deneme 2 (başarılı) olarak ayrı girişler göreceksiniz. Bu, hataların geçici (yeniden denemede çözülen ağ kesintileri) mi yoksa kalıcı (her seferinde başarısız olan yapılandırma sorunları) mı olduğunu anlamanıza yardımcı olur. Başlıklar, gönderilen payload ve alınan yanıt gövdesi dahil tam istek ve yanıt ayrıntılarını görmek için herhangi bir yürütmeye tıklayın.

Hata dökümü bölümü, tüm hataları eyleme geçirilebilir gruplara ayırır. Zaman aşımı hataları (408), uç noktanızın yanıt vermesinin çok uzun sürdüğü anlamına gelir — webhook yapılandırmanızda zaman aşımı ayarını artırmayı düşünün. Sunucu hataları (500-504), alıcı tarafta bir sorun olduğunu gösterir — uç noktanızın sağlığını ve günlüklerini kontrol edin. Kimlik doğrulama hataları (401/403) gibi istemci hataları, kimlik bilgilerinizin yanlış veya süresi dolmuş olduğu anlamına gelir — kimlik doğrulama ayarlarınızı doğrulayın. Hız sınırı hataları (429), alıcı servisin isteklerinizi kısıtladığı anlamına gelir — bunları zarif bir şekilde ele almak için üstel geri çekilme ile yeniden denemeyi etkinleştirin. Ağ hataları, Chattlebot'un URL'nize ulaşamadığı anlamına gelir — URL'nin doğru olduğunu ve sunucunun herkese açık olduğunu doğrulayın. Her hata kategorisi, seçilen zaman dilimindeki sayısını ve nasıl düzeltileceğine dair eyleme geçirilebilir bir öneri içerir. En büyük etki için önce en yüksek sayıya sahip kategorilere odaklanın.

Bir webhook AI-callable olarak yapılandırıldığında, sağlık panosu özellikle AI araç çağrısı istatistikleri için ek bir bölüm içerir. Bu şunları gösterir: toplam AI çağrıları (AI'ın bu aracı kaç kez çağırdığı), AI'a özel başarı oranı (geçerli veri döndüren AI çağrılarının yüzdesi) ve ortalama AI yanıt süresi (AI çağrılarının ortalama ne kadar sürdüğü). Bu metrikler genel webhook metriklerinden ayrıdır çünkü AI araç çağrılarının farklı performans gereksinimleri vardır — canlı konuşmalar sırasında gerçekleşirler, bu nedenle yanıt süresi doğrudan kullanıcı deneyimini etkiler. İyi bir hedef, AI çağrı yanıt sürelerini 3 saniyenin altında ve başarı oranlarını %95'in üzerinde tutmaktır. AI çağrı başarı oranı %95'in önemli ölçüde altına düşerse, uç nokta sağlığınızı ve yanıt sürelerinizi araştırın. Yavaş veya başarısız AI araçları sohbet deneyimini bozar çünkü AI ya çok uzun bekler ya da kullanıcıya istenen bilgiyi arayamadığını söylemek zorunda kalır.