Sık Karşılaşılan Hatalar

Bu rehber, Conviro kullanırken karşılaşabileceğiniz en sık hataları ve bunları nasıl çözeceğinizi anlatır.

HTTP 401 -- Unauthorized

Anlamı: API anahtarınız veya oturum token'ınız geçersiz ya da süresi dolmuş.

Nedenler ve Çözümler:

• API anahtarı hatalı -- anahtarı Dashboard -> Settings -> API Keys bölümünden kontrol edin
• API anahtarı iptal edilmiş -- yeni bir anahtar oluşturun ve entegrasyonunuzu güncelleyin
• Oturum süresi dolmuş -- panelden çıkış yapıp yeniden giriş yapın
• Authorization başlığı eksik -- API isteğinizde Authorization: Bearer sk_your_key bulunduğundan emin olun

HTTP 403 -- Forbidden

Anlamı: Bu kaynağa erişim izniniz yok.

Nedenler ve Çözümler:

• Alan adı izinli değil -- web sitenizin alan adını Dashboard -> Assistants -> Your Bot -> Channels -> Allowed Domains bölümüne ekleyin
• Plan limitine ulaşıldı -- mevcut planınızda bulunmayan bir özelliği kullanmaya çalışıyorsunuz (örneğin Starter planında WhatsApp)
• Rol kısıtlaması -- ekip rolünüz (Agent) bu işlem için yetkili olmayabilir; bir Admin veya Owner ile görüşün
• Bot pasif -- botu Dashboard -> Assistants bölümünden etkinleştirin

HTTP 404 -- Not Found

Anlamı: İstenen kaynak mevcut değil.

Nedenler ve Çözümler:

• Yanlış endpoint -- doğru URL'ler için /developers adresindeki API dokümantasyonuna bakın
• Silinmiş kaynak -- chatbot, oturum veya kişi silinmiş
• Kimlikte yazım hatası -- istek URL'nizdeki kaynak kimliğini kontrol edin

HTTP 429 -- Too Many Requests (Hız Sınırlaması)

Anlamı: Planınıza ait API hız sınırını aştınız.

Nedenler ve Çözümler:

• Yanıttaki hız sınırı başlıklarını kontrol edin:

X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset

• İstek sıklığını azaltın -- gecikme ekleyin veya işlemleri toplu hale getirin
• Planınızı yükseltin -- üst planlarda hız sınırları daha yüksektir
• Yanıtları önbelleğe alın -- aynı isteği tekrar tekrar göndermekten kaçının

Plana göre hız sınırları:

CORS Hataları

Anlamı: Tarayıcı, kaynaklar arası (cross-origin) bir isteği engelliyor.

Belirti: Tarayıcı konsolunda Access to XMLHttpRequest has been blocked by CORS policy gibi bir hata görürsünüz.

Nedenler ve Çözümler:

• Widget alan adı izinli değil -- alan adınızı Allowed Domains listesine ekleyin
• Karışık içerik -- widget HTTPS üzerinden yükleniyorsa sitenizin de HTTPS (HTTP değil) kullandığından emin olun
• Proxy veya CDN etkisi -- CDN'inizin CORS başlıklarını kaldırıp kaldırmadığını kontrol edin

Webhook Teslimat Hataları

Anlamı: Conviro bir webhook gönderdi ancak sunucunuz 2xx durum koduyla yanıt vermedi.

Nedenler ve Çözümler:

• Sunucu kapalı -- webhook endpoint'inizin çalıştığından ve erişilebilir olduğundan emin olun
• Zaman aşımı -- Conviro yanıt için 10 saniye bekler. Endpoint'inizin hızlı yanıt verdiğinden emin olun
• SSL sertifikası sorunu -- endpoint'inizin geçerli bir SSL sertifikası olmalıdır (kendinden imzalı sertifikalar kabul edilmez)
• Güvenlik duvarı engeli -- Conviro'nun IP aralığını güvenlik duvarınızda izin listesine ekleyin
• Yanlış URL -- webhook URL'sini Dashboard -> Settings -> Webhooks bölümünden doğrulayın

Yeniden deneme politikası: Conviro, başarısız webhook'ları artan bekleme süreleriyle 3 kez yeniden dener (1 dakika, 5 dakika, 30 dakika). 3 başarısız denemeden sonra webhook başarısız olarak işaretlenir ve size bir e-posta bildirimi gönderilir.

Webhook teslimat kayıtlarını Dashboard -> Settings -> Webhooks -> Delivery Log bölümünden kontrol edin.

Mesaj Limitine Ulaşıldı

Anlamı: Aylık mesaj hakkınızın tamamını kullandınız.

Nedenler ve Çözümler:

• Free/Starter -- konuşmalar bir sonraki faturalandırma dönemine kadar duraklatılır. Daha fazla mesaj için üst bir plana geçin.
• Pro/Growth -- ek mesaj paketlerinin otomatik olarak satın alınması için Dashboard -> Settings -> Billing bölümünden aşım faturalandırmasını etkinleştirin.
• Kullanımı kontrol edin -- tüketiminizi Dashboard -> AI Usage bölümünden izleyin.

Genel İpuçları

• İstemci tarafındaki hatalar için her zaman tarayıcı konsolunu (F12) kontrol edin.
• API hatalarında yanıt gövdesini inceleyin -- genellikle açıklayıcı bir hata mesajı içerir.
• Devam eden bir arıza veya bakım olup olmadığını görmek için Conviro durum sayfasını kontrol edin.
• Sorunu çözemiyorsanız hata ayrıntıları, istek kimliği (varsa) ve tekrar üretme adımlarıyla birlikte [email protected] adresine yazın.