Widget entegrasyonu ve kullanımı için yaygın sorunlar ve çözümler.
Sorun mu yaşıyorsunuz? Doğru yerdesiniz. Bu kılavuz, widget'ı entegre ederken geliştiricilerin karşılaştığı en yaygın sorunları ve adım adım çözümleri kapsar. Çoğu sorun sadece birkaç dakikada çözülebilir.
🔍 Hızlı Hata Ayıklama İpucu
Sorun gidermeden önce tarayıcınızın Geliştirici Konsolunu (F12) açın. Çoğu widget hatası, soruna doğrudan işaret eden net mesajlar konsolda görüntülenecektir.
Widget sayfanızda hiç görünmüyorsa, lütfen bu sorun giderme adımlarını sırayla izleyin:
Hata: "Widget yapılandırılmamış" (her bir eksik data-* niteliği hakkında detaylarla)
Bu hata mesajını kontrol etmek için tarayıcı konsolunu kontrol edin.
Bütün gerekli data niteliklerinin script etiketinde mevcut olduğundan emin olun:
<script src="https://widget.companin.tech/widget.js" data-widget-key="YOUR_WIDGET_KEY" data-locale="en"></script>Hata: "Kimlik doğrulama gerekli" veya "Geçersiz kimlik bilgileri"
Widget, API ile kimlik doğrulamasını gerçekleştiremiyor. Bu genellikle kimlik bilgileri yanlış veya süresi dolmuş olduğunda olur.
Kimlik doğrulama sorunları genellikle düzeltmesi kolaydır. Bu kontrolleri yapın:
client_id'nin OAuth uygulamanızda doğru olduğundan emin olun - Hataları önlemek için doğrudan kontrol panelinizden kopyalayınHala takıldınız mı? Kontrol panelinizde yeni bir OAuth uygulaması oluşturmayı deneyin. Bazen sıfırdan başlamak, belirsiz yapılandırma sorunlarını çözer.
Hata: "Köken izin verilmedi" veya widget token isteği reddedildi
Bir iframe içinde gömüldüğünde ve ana alan OAuth izin verilen kökenler listesinde yoksa yaygındır.
Doğrulama ipucu: Token isteği başlıkları için tarayıcı ağ sekmesini kontrol edin ve X-Embed-Origin'i OAuth allowed_origins girişinizle karşılaştırın.
Buton konumlandırma sorunu
Widget yükleniyor ama buton görünüm alanının dışında.
position: fixed ile CSS çakışmalarını kontrol edinoverflow: hidden olmadığından emin olunEğer yapılandırmada hide_on_mobile etkinleştirildiyse, widget mobil cihazlarda gizlenecektir. Bu ayarı devre dışı bırakın veya mobil kırılma noktasını ayarlayın.
Görsel problemler yaygındır ve genellikle kolayca düzeltilebilir. Widget, sayfanızdan görsel olarak izole edilmek üzere tasarlanmıştır, ancak bazen çakışmalar meydana gelebilir.
Renk sorunlarını teşhis etmek için bu adımları izleyin:
Hata ayıklama ipucu: Widget'ı tarayıcınızda açın ve hangi CSS değerlerinin gerçekten uygulandığını doğrulamak için öğeyi denetle aracını kullanın. Bu, renklerinizin yüklenip yüklenmediğini veya geçersiz kılınıp kılınmadığını gösterecektir.
Widget doğru bir şekilde yüklendiğinde ancak özellikler beklenildiği gibi çalışmadığında, bu çözümler yardımcı olacaktır.
Ağ hatası, zaman aşımı veya oturum süresi dolmuş
Kullanıcı bir mesaj yazar ve gönder butonuna tıklar, ancak hiçbir şey olmaz veya bir hata görünür. Başarısız istekler için tarayıcı ağ sekmesini kontrol edin (ağ sekmesinde kırmızı olarak görünmelidir).
Mesaj gönderme sorunları genellikle ağ bağlantısı veya süresi dolmuş oturumlarla ilgilidir. Sistematik olarak teşhis edin:
Hızlı test: Mesajlar gizli bir pencerede çalışıyorsa ancak normal tarayıcınızda çalışmıyorsa, sorun muhtemelen tarayıcı uzantıları veya önbelleğe alınmış kimlik bilgileri ile ilgilidir.
Widget, modern tarayıcı özelliklerini gerektirir:
Minimum desteklenen tarayıcılar: Chrome 60+, Firefox 55+, Safari 12+, Edge 79+
Bu kılavuzun ötesinde ek yardıma ihtiyaç duyduğunuzda, bu araçlar ve kaynaklar sorunları teşhis etmenize veya destek almanıza yardımcı olacaktır.
Tarayıcı konsolunuzda ayrıntılı günlükleme görmek için hata ayıklama modunu etkinleştirin. Bu, widget'ın her adımda ne yaptığını anlamanızı sağlar:
<script src="https://widget.companin.tech/widget.js" data-widget-key="YOUR_WIDGET_KEY" data-dev="true"></script>Hala sorun mu yaşıyorsunuz?
Bizim yapılandırma kılavuzumuzu kontrol edin veya tarayıcı konsol günlükleriniz ve yapılandırma detaylarınızla destekle iletişime geçin.