Sorun giderme ve kontrol listesi

Araçlar

• Geliştirici araçları → Ağ: loader.js, core.<hash>.js, WebSocket bağlantısı (“Mesajlar” veya “Çerçeveler” sekmesi init, init_ok, error gösterir) ya da HTTP yedeğinin istekleri (h/auf, …/sse, …/tx).
• Tanılamayı açın: Yükleyici etiketine data-rc-debug="true" veya konsola localStorage.setItem('rc_debug','1') ekleyip yeniden yükleyin.
• Konsol: ReactiveChat('getSession'), ReactiveChat('getEndpoint'), ReactiveChat('isOpen'), ReactiveChat.version.

Sohbet düğmesi görünmüyor

• Site anahtarı eksik veya geçersiz. Yükleyici bu durumda sessizce durur. Çalıştırılan etiketteki data-rc-site-key değerini kontrol edin (A–Z a–z 0–9 _ - karakterlerinden 8–64 karakter); etiket yöneticileri ve uygulama çatısı yardımcıları bazen öznitelikleri düşürür.
• Script etiketinde type="module": Yükleyici bu durumda kendi etiketini bulamaz. Klasik betik olarak yerleştirin.
• data-rc-hide-launcher="true" veya hesabınızda “Yalnızca kendi bağlantılarınızla (sohbet simgesi yok)” ayarlı.
• Kodda marka rengi yok: Geçerli data-rc-brand rengi olmadan düğme yalnızca bağlantı kurulduktan sonra görünür. Kodu hesabınızdan yeniden kopyalayın.
• Proje duraklatılmış veya site anahtarı bilinmiyor: Sunucu unknown_site_key yanıtı verir (kapanış 4002); widget bu sekmede on dakika yeniden denemez.
• Çekirdek yüklenmiyor: Konsolda [reactive.chat] core.js … görünür. Çoğu zaman script-src veya reklam engelleyici adresi engeller; Özel alan adı bölümüne bakın.

Sohbet düğmesi var ama mesaj ulaşmıyor

• Kendiniz barındırdığınız loader.js için data-rc-ws-url yok: Widget sohbet sunucusunu sizin alan adınızda arar. Ağ sekmesinde wss://ws.<your-domain>/rc_wss/ adresine sonuçsuz bağlantı denemeleri görünür. Çözüm: data-rc-ws-url="wss://ws.reactive.chat/rc_wss/".
• origin_denied, kapanış 1008: Sayfanın alan adı İzin verilen kaynaklar altında eksiktir. Sohbet alt alan adını değil, web sitesinin alan adını girin.
• CSP engelliyor: Konsol bir CSP mesajı gösterir; ilgili adres wss://… veya https://…/rc_wss/h/auf. Her iki biçimi de connect-src içine ekleyin.
• WebSocket olmadan şirket ağı: İki başarısız denemeden sonra widget HTTP yedeğine geçer. O da çalışmıyorsa istekleri 30 saniyeden önce sonlandıran veya yanıtları arabelleğe alan proxy’leri kontrol edin (Taşıma).
• Kötüye kullanım koruması engeli (kapanış 1008 blocked): Geçerli proxy anahtarı olmayan kendi proxy’nizin arkasında sık görülür; çünkü tüm ziyaretçiler aynı adrese sahip olur.
• Mesaj çok uzun: Widget plan sınırını (1.000 veya 4.000 karakter) aşan metinleri göndermez.

Oturum açmış kullanıcı anonim sayılıyor

error çerçevesi, detail.reason ile auth_failed içerir:

• no_hash – identify içinde userHash eksik.
• no_secret – projede gizli anahtar ayarlanmamış.
• bad_exp – exp saniye yerine milisaniye cinsinden veya tam sayı değil.
• expired – sayfa uzun süredir açık veya sunucu saati yanlış; sayfa yüklenirken özeti yeniden hesaplayın.
• exp_too_far – 24 saatten fazla ileride.
• bad_hash – gizli anahtar, sıra (userId + "." + exp) veya karakter kümesi eşleşmiyor; gizli anahtar çözümlenmiş baytlar değil, dize olarak anahtarın kendisidir. E-posta adresi varsa tam ilettiğiniz biçimde imzalanmalıdır.

Ayrıntılar: Ziyaretçileri tanımlama.

Müşteri verileri ulaşmıyor

• Kullanıcı oturum açmış olmasına rağmen asistan oturum açmasını istiyor: exp eksik veya süresi dolmuş; exp olmadan müşteri verileri yoktur.
• Hesabınızdaki Bağlantıyı test et nedeni belirtir (http_401, zeitueberschreitung, umleitung, adresse_privat …). İmzalanan dize X-RC-Zeit + "." + raw body değeridir; yeniden kodlanmış JSON’a göre değil, alınan baytlara göre doğrulayın.
• Asistanın yanıtında bir alan eksik: Hesabınızda etkin değildir veya asla alınmayan alanlar listesindedir.

Ayrıntılar: Müşteri verisi uç noktası.

Webhook’lar ulaşmıyor

• Entegrasyon açık mı, olay seçili mi (seçim yok = tümü)? Açtıktan sonra en fazla 15 saniye bekleyin.
• Uç noktanızın yanıtı 10 saniyeden uzun sürüyor veya yönlendirme döndürüyor.
• Uç noktanız bir kez 410 döndürdü; bu entegrasyonu devre dışı bırakır. Yeniden açın.
• İmza eşleşmiyor: Ham gövde ve X-RC-Timestamp + "." + body üzerinden hesaplayın, sha256= ön ekine dikkat edin.
• data içinde içerik eksik: Her olayın taşıdığı alanlar Webhook’lar altında listelenir; seçilmeyen olay hiç ulaşmaz.

Sunucu API’si

• 401 auth_failed: Anahtar iptal edilmiş, hatalı yazılmış veya oluşturan kişi artık yönetici değil.
• 403 insufficient_scope: Kapsam yetersiz; required_scope gerekeni belirtir.
• 429: Dakikada 120 istek aşıldı; Retry-After değerine uyun.
• 415/413: Content-Type: application/json eksik veya gövde 64 KiB’tan büyük.

Gizlilik metni görünmüyor

• Sayfada yükleyici yok veya onay platformu engelliyor: datenschutz.js dosyasını doğrudan yerleştirin.
• Web sitesi projede alan adı olarak girilmemiş veya proje duraklatılmış.
• Öğedeki data-rc-privacy-state="error", başarısız isteği belirtir.

Canlıya geçmeden önce kontrol listesi

1. Web sitesinin tüm alan adları İzin verilen kaynaklar altında girildi.
2. Hesabınızdaki kod, gizlilik sayfası dâhil sohbetin görüneceği tüm sayfalarda değiştirilmeden bulunuyor.
3. CSP: script-src için dağıtım konumu, connect-src için wss:// ve https://, görseller için img-src.
4. Onay: data-rc-consent veya onay platformu (TCF v2 / consented.eu) kontrol edildi; onay verilerek ve verilmeden test edildi.
5. Gizlilik politikası genişletildi (<div data-rc-privacy> veya metin bölümü).
6. Kimlik: exp ile userHash sunucuda hesaplandı, gizli anahtar yalnızca sunucu ortamında, init_ok.identity.verified değeri true.
7. Gizli metin içeren alanlar data-rc-private ile işaretlendi.
8. Özel alan adında: beş kontrol adımının tümü “Tamam”, proxy anahtarı yalnızca proxy yapılandırmasında, /rc_wss/h/ erişim günlüğünde yok.
9. Webhook’lar: imza ve zaman damgası doğrulandı, yinelenenler X-RC-Delivery ile saptanıyor, hızlı 2xx yanıtı.
10. HTTP yedeği data-rc-transport="http" ile bir kez test edildi.
11. Mobil görünüm (480 pikselin altında sohbet tam ekran açılır) ve klavyeyle kullanım kontrol edildi.