Sorun Giderme

Bir webhook başarısız olduğunda, HTTP durum kodu neyin yanlış gittiğini söyler. İşte en yaygın hatalar ve nasıl düzeltileceği. Zaman Aşımı (408), uç noktanızın yapılandırılmış zaman aşımı süresinden daha uzun sürede yanıt verdiği anlamına gelir — webhook yapılandırmanızda zaman aşımı ayarını artırın. Hız Sınırı (429), alıcı servisin isteklerinizi kısıtladığı anlamına gelir — Chattlebot'un isteği artan gecikmelerle otomatik olarak yeniden denemesi için üstel geri çekilme ile yeniden denemeyi etkinleştirin. Sunucu Hatası (500-504), alıcı uç noktada bir sorun olduğunu gösterir — uç noktanızın sağlığını, günlüklerini ve servisin bir kesinti yaşayıp yaşamadığını kontrol edin. Geçersiz İstek (400), genellikle payload'unuzun API'nin beklediği formatla eşleşmediği anlamına gelir — JSON sözdizimini doğrulayın, eksik zorunlu alanları kontrol edin ve değişken adlarının doğru olduğundan emin olun. Kimlik Doğrulama Hatası (401/403), kimlik bilgilerinizin yanlış, süresi dolmuş veya jetonun doğru izinlere sahip olmadığı anlamına gelir — kimlik doğrulama ayarlarınızı doğrulayın ve gerekirse jetonları yenileyin. Ağ Hatası, Chattlebot'un URL'nize hiç ulaşamadığı anlamına gelir — URL'nin doğru olduğunu, sunucunun herkese açık olduğunu ve HTTPS kullandığınızı doğrulayın. Sağlık panonuzdaki en yüksek sayıya sahip hataya bakarak başlayın — bunu düzeltmek en büyük etkiyi sağlayacaktır.

Üstel geri çekilme ile yeniden deneme, webhook'larınızın geçici hatalardan otomatik olarak kurtulmasına yardımcı olur. Etkinleştirildiğinde, Chattlebot başarısız istekleri artan gecikmelerle yeniden dener: ilk hatadan 1 saniye sonra, ikinciden 2 saniye sonra ve üçüncüden 4 saniye sonra. Bu geri çekilme kalıbı, zorlanmakta olan bir uç noktayı bunaltmayı önlerken kurtulması için şans verir. Yeniden denenebilir durum kodları: 408 (Zaman Aşımı), 429 (Hız Sınırı), 500, 502, 503 ve 504 (Sunucu Hataları). Bunların hepsi, sorunun muhtemelen geçici olması nedeniyle yeniden denemenin başarılı olabileceği durumlardır. 400 (Geçersiz İstek), 401 (Yetkisiz), 403 (Yasak) ve 404 (Bulunamadı) gibi yeniden denenemez kodlar yeniden DENENmez çünkü kendi kendine düzelmeyecek bir yapılandırma sorununu gösterirler — payload'u, kimlik bilgilerini veya URL'yi düzeltmeniz gerekir. Webhook ayarlarınızda maksimum deneme sayısını 1'den 5'e kadar ayarlayabilirsiniz. Her deneme yürütme geçmişinde ayrı olarak kaydedilir, böylece hangi denemenin başarılı olduğunu ve hangilerinin başarısız olduğunu tam olarak görebilirsiniz.

Zaman aşımı ayarı, Chattlebot'un uç noktanızın yanıt vermesi için ne kadar süre bekleyeceğini kontrol eder. Varsayılan 10 saniyedir ve 5 ile 60 saniye arasında herhangi bir yere ayarlayabilirsiniz. Ne zaman azaltılır (5-8s): Slack webhook'ları, e-posta tetikleyicileri veya temel veri kaydı gibi basit bildirim uç noktaları için daha kısa zaman aşımları kullanın — bunlar neredeyse anında yanıt vermelidir ve uzun zaman aşımı yalnızca hata algılamayı geciktirir. Ne zaman varsayılanı kullanılır (10s): 10 saniyelik varsayılan, çoğu CRM API'si, veritabanı işlemleri ve standart webhook alıcıları için iyi çalışır. Ne zaman artırılır (15-30s): AI/ML API'leri (OpenAI veya zenginleştirme servisleri gibi), veritabanı araması yapan uç noktalar veya yanıt vermeden önce veri işleyen API'ler için daha uzun zaman aşımları kullanın. Ne zaman maksimum kullanılır (30-60s): En yüksek zaman aşımı değerlerini toplu işlemler, dosya işleme veya ekstra zamana ihtiyaç duyduğunu bildiğiniz yavaş üçüncü taraf servisleri için ayırın. AI çağrılabilir webhook'lar için zaman aşımlarını makul tutun — AI canlı sohbet sırasında yanıtı bekler, bu nedenle 10 saniyenin üzerindeki her şey kullanıcıya yavaş hissedilecektir.

Bazen HTTP 200 durum kodu gerçekten başarı anlamına gelmez. Bazı API'ler 200 OK döndürür ancak yanıt gövdesinde hata içerir, örneğin {"status": "error", "message": "Duplicate entry"}. Başarı koşulu olmadan, HTTP durumu 200 olduğu için Chattlebot bunu başarılı bir yürütme olarak işaretler. Bu durumları yakalamak için iki alanla bir başarı koşulu yapılandırın: kontrol etmek istediğiniz alanı işaret eden JSONPath ifadesi (ör. $.status) ve bu alanın içermesi gereken beklenen değer (ör. "success"). Başarı koşulu yapılandırıldığında, Chattlebot hem HTTP durum kodunu HEM DE yanıt gövdesini kontrol eder. Yürütme yalnızca HTTP durumu başarı aralığında (200-299) VE JSONPath alanı beklenen değerle eşleştiğinde başarılı olarak işaretlenir. Bu, sonraki adımların webhook'un gerçekten başarılı olmasına bağlı olduğu iş akışı webhook'ları ve yanlış başarının AI'ın kullanıcılara yanlış veri sunmasına yol açabileceği AI çağrılabilir webhook'lar için özellikle önemlidir.

İşte en sık sorulan webhook sorularının yanıtları. 'Testte çalışıyor ama gerçek müşteri adaylarında çalışmıyor' — En yaygın neden, tetikleyici ayarlarının doğru yapılandırılmamış olmasıdır. Müşteri Adayı Yakalama tetikleyicisinin etkinleştirildiğini ve aciliyet filtresinin çok kısıtlayıcı olmadığını (ör. çoğu müşteri adayı Orta gelirken yalnızca Yüksek) kontrol edin. Test modu örnek veri kullanır ve tetikleyici ayarlarından bağımsız olarak her zaman tetiklenir. 'Yinelenen çağrılar alıyorum' — Bu, aynı webhook'ta hem Müşteri Adayı Yakalama hem de AI-Callable tetikleyicileri etkinleştirildiğinde olur. Tek bir konuşma ikisini de tetikleyebilir — müşteri adayı yakalama ziyaretçi bilgi gönderdiğinde tetiklenir ve AI aracı aynı sohbet sırasında AI'ın veriye ihtiyaç duyması durumunda tetiklenir. Çözüm: yinelenen çağrıları zarif bir şekilde ele alan idempotent uç noktalar kullanın veya alıcı sisteminizde upsert mantığı kullanın. 'Payload'daki değişkenler boş' — Değişken adlarınızı Payload Referansı rehberine göre çapraz kontrol edin. Değişkenler büyük/küçük harf duyarlıdır ve tam formatı kullanmalıdır: {{lead.email}}, {{Lead.Email}} veya {{lead_email}} değil. Ayrıca verinin gerçekten var olduğunu doğrulayın — örneğin, ziyaretçi telefon numarası vermediyse {{lead.phone}} boş olacaktır. 'Zapier webhook'u çalışmayı durdurdu' — Önce Zapier panelinizdeki Zap'ın duraklatılıp duraklatılmadığını kontrol edin — Zapier, bir süredir tetiklenmemiş veya tekrarlanan hatalar olan Zap'ları otomatik olarak duraklatır. Ayrıca webhook URL'sinin değişmediğini doğrulayın (tetikleyiciyi yeniden oluşturursanız Zapier yeni bir URL üretir).

Destek ile iletişime geçmeden önce, ihtiyacınız olan bilgileri toplamak için bu hata ayıklama kontrol listesini izleyin. Adım 1: Sağlık panosunu kontrol edin — sorunun kapsamını anlamak için son 24 saat ve 7 gündeki başarı oranlarına ve hata eğilimlerine bakın. Adım 2: Yürütme günlüklerini gözden geçirin — belirli başarısız yürütmeyi bulun ve zaman damgası, durum kodu, tetikleyici türü ve yanıt gövdesini not edin. Adım 3: Hata dökümünü kontrol edin — hatanızın hangi hata kategorisine düştüğünü belirleyin ve önerilen düzeltmeyi deneyin. Adım 4: Önerileri izledikten sonra sorun devam ederse, üç bilgiyle destek ile iletişime geçin: webhook kimliğiniz (webhook ayarlarında bulunur), son başarısız yürütmeden hata durum kodu ve yanıt gövdesi, ve hatanın zaman damgası. Bu, destek ekibimize hızlı bir şekilde araştırma yapması için gereken her şeyi verir. Desteğe panelinizdeki yardım menüsünden veya support@chattlebot.com adresine e-posta göndererek ulaşabilirsiniz.