Embed Destek Widget Kurulumu

Bu sayfa, widget başka bir siteye eklendiğinde çalışmamasının en yaygın sebeplerini ve hızlı kontrolleri toplar.

Kurulum

Widget, farklı bir siteye aşağıdaki script ile eklenir. ROOM_UUID her oda için farklıdır.

<script src="https://bitenta.com/embed/loader.js?room=ROOM_UUID" async></script>

Host sayfanın HTTPS olması ve script URL’inin de HTTPS üzerinden gelmesi önemlidir.

Çalışmıyorsa İlk Kontroller

  • Tarayıcı konsolunda CSP veya Mixed Content hatası var mı?
  • Ağ sekmesinde loader.js 200 dönüyor mu?
  • API çağrıları (api/embed/...) CORS sebebiyle bloklanıyor mu?
  • Kamera/mikrofon izni HTTPS üzerinde isteniyor mu?
  • Adblock/Privacy eklentileri Pusher veya WebSocket’i engelliyor mu?

Script Yüklenmiyor

CSP

Host sitenin Content-Security-Policy ayarı dışarıdan script yüklemeyi engelliyorsa loader.js hiç çalışmaz. Console’da genelde Refused to load the script gibi hata görünür.

Mixed Content

Host site HTTPS iken script HTTP olursa tarayıcı engeller.

API Çağrıları Bloklanıyor (CORS)

Widget, host site farklı origin ise api/embed/... istekleri cross-origin olur. Sunucuda CORS izinleri doğru değilse tarayıcı bloklar.

Tipik hata: CORS policy

Kamera/Mikrofon Açılmıyor

getUserMedia çoğu tarayıcıda secure context ister. Host sayfanın HTTPS olması gerekir (localhost istisna).

Tipik hata: NotAllowedError veya SecurityError

WebSocket / WebRTC Engelleri

Kurumsal ağlar WebSocket’i veya STUN/TURN trafiğini engelleyebilir. Bu durumda sıra güncellemeleri veya görüşme akışı gelmeyebilir.

Kontrol: Ağ sekmesinde WSS bağlantısı kuruluyor mu? ICE adayları toplanıyor mu?