Sorun Giderme

Belirtiler

• Sayfada chat butonu görünmüyor
• Console'da hata yok ama widget yok

Çözümler

• Widget ID'nin doğru olduğunu kontrol edin. Dashboard → Widget sayfasından kopyalayın.
• Script'in </body> etiketinden önce olduğundan emin olun.
• Ad blocker veya güvenlik uzantılarını devre dışı bırakın.
• OnsraSettings nesnesi window.OnsraSettings olarak tanımlanmış mı kontrol edin.

  console.log(window.OnsraSettings);

Belirtiler

• Mesaj yazılıyor ama gönderilemiyor
• "Bağlantı hatası" mesajı görünüyor

Çözümler

• Network sekmesinde WebSocket bağlantısını kontrol edin. wss://api.onsrachat.com adresine bağlantı sağlanmalıdır.
• Site'nizde Content Security Policy (CSP) varsa aşağıdaki domainleri izin verin:

  Content-Security-Policy:
    connect-src 'self' wss://api.onsrachat.com https://api.onsrachat.com;
    script-src 'self' https://widget.onsrachat.com;
    frame-src https://widget.onsrachat.com;

Belirtiler

• Konuşmalar "Anonim" olarak görünüyor
• Giriş yapmış kullanıcılar tanınmıyor

Çözümler

• OnsraSettings'in sayfa yüklenmeden önce tanımlandığından emin olun.
• Visitor objesinin doğru formatta olduğunu kontrol edin:

  window.OnsraSettings = {
    widgetId: "YOUR_WIDGET_ID",
    visitor: {
      name: "Kullanıcı Adı",   // string
      email: "user@email.com", // geçerli email
      userId: "123",           // string
    }
  };

Belirtiler

• Mobil cihazlarda widget ekranı kapatıyor
• iOS'ta keyboard açılınca widget kayıyor

Çözümler

• Viewport meta tag'ının sayfada olduğundan emin olun:

  <meta name="viewport" content="width=device-width, initial-scale=1">

• Widget pozisyonunu bottom-right olarak kullanmanızı öneririz.