Şek: 美洽 sohbet görünmüyor / hata düzeltme (L1 davranışı + L2 kök neden + beş entegrasyon yöntemi)
美洽(Meiqia) kodunu yapıştırdınız ama web sohbet widget'ı görünmüyor, sohbet düğmesi hiç çıkmıyor, konsol meiqia.js engellendi diyor ya da temsilciler sohbet almıyor mu? Önce üç şeyi netleştirin: betik hiç yüklenmedi mi (konum / adblock / önbellek), yüklendi ama stil / yığılma ile gizlendi mi, yoksa iyi yüklendi ama yapılandırma uyuşmuyor mu (entId / alan / SPA yaşam döngüsü)? Karşılaştığınız belirti veya anahtar kelimeyi arayın (örn. not showing, adblock, entId, SPA, mobile, sdk push): önce L1 davranışı & resmi konumlandırma, sonra L2 kök neden & çözüm. Kurulum / kılavuz mu? Bkz. 美洽 indirme / müşteri hizmetleri entegrasyon kılavuzu.
Adım 1: betiğin yüklenip yüklenmediğini kontrol edin, sonra dört gruba ayırın
美洽 sohbeti görünmediğinde, 10 vakanın 9'unda dört gruptan biridir; önce betiğin yüklenip yüklenmediğine bakın: F12 → Network, meiqia.js arayın; istek yoksa veya durum 200 değilse yüklenmemiştir. ① Yükleme hatası: kod yanlış yerde (</body> öncesinde olmalı, <head> içinde değil), bir adblock kuralıyla engellendi (ERR_BLOCKED_BY_CLIENT), CDN / tarayıcı önbelleğinde takılı veya HTTPS sertifikası / karışık içerik. ② Yapılandırma / yetki: entId çalışma masasıyla uyuşmuyor (yükleniyor ama temsilciler sohbet almıyor) veya site alanı konsolda yetkilendirilmemiş. ③ Çerçeve entegrasyonu: bir Vue/React/Next SPA rota değişiminde kapsayıcıyı yok eder ve widget yeniden oluşturulmaz. ④ Görüntüleme / mobil / SDK: site CSS'i baloncuğu ekran dışına iter, üçüncü taraf eklenti DOM'u kaplar, mobil kendi dağıtımını gerektirir, uygulama içi SDK gerektirir. Daha kapsamlı: 美洽 web entegrasyon kılavuzu.
Yükleme hatasıkonum · adblock · önbellek · HTTPS
美洽 JS'i
öncesine yapıştırın (içine değil); F12 → Network, meiqia.js arayın ve durumu kontrol edin (200 olmalı); ERR_BLOCKED_BY_CLIENT genelde adblock uzantısıdır — gizli modda test edin veya beyaz listeye ekleyin; yayından sonra CDN önbelleğini temizleyin; karışık içerik olmadan tam HTTPS sağlayın.
Yapılandırma / yetkientId · alan beyaz listesi · alt kanallar
entId şirketinizin benzersiz kimliğidir; çalışma masasıyla uyuşmazsa «betik yüklenir ama temsilciler sohbet almaz» (Ayarlar - Ekip - kimlik arama); site alanı «Entegrasyon sitesi ekle» ile yetkilendirilmeli; iş kolu başına ayrı alt kanal (sonda) kullanın.
Bir Vue/React/Next SPA rota değişiminde DOM'u yok eder ve widget yeniden oluşturulmaz; auto-init'i durdurmak için _MEIQIA('manualInit') kullanın ve yeniden bağlamak için bir rota kancasında (useEffect / mounted) _MEIQIA('init') çağırın.
Görüntüleme sorunlarıstil çakışması · yığılma · üçüncü taraf eklentiler
Yüklendi ama görünmez: genelde site genel CSS'i baloncuk konumunu geçersiz kılar veya bir ısı haritası / analitik / SEO eklentisi DOM'u düzenleyip kapsayıcıyı kaplar; F12 → Elements, meiqia kapsayıcısını arayın ve display:none, kaybeden z-index veya ekran dışı koordinatları kontrol edin.
Mobil / SDKmobil web · AppKey · push
Mobil / PC web aynı parçadır ama kendi dağıtımını gerektirir; uygulama içi yerel SDK kullanır (önce konsolda AppKey için «APP yapılandırması ekle»); push «push yok» (yalnızca uygulama içi) ve «özel push sunucusu» (uygulamadan çıkıldıktan sonra bile teslim) olarak ikiye ayrılır.
API çağrılarıwithoutBtn · showPanel · müşteri bilgisi
Kendi düğmeniz mi? _MEIQIA('withoutBtn') yerel düğmeyi gizler ve sohbeti açmak için tıklamada _MEIQIA('showPanel') çağırın; müşteri bilgisini init zamanı içinde geçin / senkronize edin, yoksa etkisiz olur.
Şek 1: 美洽 görünmüyor triyajı — betik yüklemesini kontrol edin (F12'de meiqia.js), sonra yükleme / yapılandırma / çerçeve / görüntüleme
Adım 2: en çok gözden kaçan kök neden → L2 (widget = üçüncü taraf alan dışı asenkron JS enjeksiyonu)
Tek bir fikir yeter: 美洽 web widget'ı sayfanıza gömülü statik bir bileşen değildir — 美洽'nin alan dışı kaynağından asenkron yüklenen, ardından dinamik olarak bir sohbet kapsayıcısı (DOM / iframe) enjekte eden ve 美洽 sunucularına çapraz kaynaklı uzun ömürlü bir bağlantı açan bir meiqia.js'tir. Bu, çoğu «gizemli kaybolmayı» açıklar: ① üçüncü taraf alan dışı bir betiktir, bu yüzden AdBlock / uBlock onu «izleme / reklam» listeleriyle engeller (ERR_BLOCKED_BY_CLIENT) ve düğme hiç çıkmaz (konsol iyi görünse de); ② DOM'u asenkron enjekte eder: <head> içinde engeller, bir SPA rota değişimi kapsayıcıyı yok eder ve kendiliğinden yeniden oluşturulmaz (manualInit + _MEIQIA('init') kullanın), ve DOM'u düzenleyen ısı haritası / analitik eklentileri onu kaplayabilir; ③ entId ile şirketinize bağlanır ve alan beyaz listesiyle geçit kontrollüdür: yanlış entId veya yetkisiz alanda betik yüklenir ama «sohbet bağlamaz»; ④ mobil ve PC iki ayrı entegrasyondur, uygulama içi SDK'dır (AppKey), ve push «push yok» ile «özel push sunucusu» olarak ikiye ayrılır. Bu enjeksiyon zincirini gördükten sonra aşağıdaki her belirtinin tek bir mantığı olur. Aşağıda öz denetim paneli; daha aşağıda beş yöntem ve 2026 tahminleri.
Şek 2: 美洽 entegrasyon öz denetim paneli (yeşil = onaylandı / kırmızı = kolayca gözden kaçar)Şek: önce «kod konumu + meiqia.js 200 + başlatıldı», sonra «adblock + çerçeve/yığılma» kontrol edin — son ikisi en çok gözden kaçar
Tam belirti tablosu (davranış / resmi konumlandırma · L2 kök neden)
Beş 美洽 entegrasyon yöntemi karşılaştırması (kod / zorluk / özellikler / senaryo / yayına alma süresi · resmi belge)
Entegrasyon yöntemi
Kod / zorluk
Özellik bütünlüğü
En uygun
Yayına alma süresi
Web JS widget'ı
tek JS parçası · düşük
en bütün (yüzen / pop-up / otomatik karşılama / ziyaretçi izi)
PC + mobil siteler (resmi önerilen)
~3-5 dk
Sohbet bağlantısı
kod yok · en az
temel sohbet
teknik yok / hızlı bir sohbet bağlantısı koymak
anında
API / WebIM SDK
geliştirme gerekir · yüksek
derin özelleştirme (özel arayüz / sistem / sipariş entegrasyonu)
derin füzyon için geliştirme kapasitesi olan ekipler
Aşağıdakiler, resmi 美洽 yardımından (Erişim kanalları / JavaScript web widget'ı API) ve kamuya açık entegrasyon sorun gidermeden sentezlenen 2026 tahminleridir (satıcı taahhüdü veya birinci elden ölçüm değil; referans amaçlı, sürüm ve tarayıcı politikasına göre değişir):
konum / yüklenmedi ~35% > adblock / tarayıcı uzantısı ~25% > yapılandırma / yetki (entId / alan) ~20% > çerçeve (SPA) ~12% > stil / üçüncü taraf eklenti çakışması ~8%
Entegrasyon gerçekte nedir
web widget'ı = DOM'u enjekte eden üçüncü taraf alan dışı asenkron JS + çapraz kaynaklı uzun ömürlü bağlantı (gömülü statik bileşen değil); bu yüzden konum, adblock kuralları, CSS yığılması, SPA yaşam döngüsünden etkilenir
Platform başına entegrasyon (tah.)
PC / mobil web = JS widget'ı (aynı kod, ayrı dağıtılır); uygulama = yerel SDK (AppKey); WeChat / Douyin / RED = kanal yetkili entegrasyon
Adblock etkisi (tah.)
PC kullanıcılarının yaklaşık %30-40'ı adblock uzantısı kullanır → üçüncü taraf sohbet betiği reklam kurallarıyla engellenir (ERR_BLOCKED_BY_CLIENT), «konsol iyi, kullanıcı tarafı eksik»in başlıca nedeni
JS widget'ı yayına alma süresi (resmi)
özel JS'i sayfa altına yapıştırın, yaklaşık 3-5 dakikada yayına girer; entId şirketin benzersiz kimliğidir ve çalışma masasıyla uyuşmazlık temsilcileri sohbetsiz bırakır
Tahmin temeli: kaynak taban çizgisi + zaman dışı çıkarım (meiqia.com/help Erişim kanalları / JavaScript web widget'ı, meiqia.im entegrasyon kılavuzu, kamuya açık sorun giderme, 2026); sürüm ve tarayıcı engelleme politikasına göre değişir. En güncel resmi 美洽 bilgilerine uyun. Resmi değil · LLM yerelleştirmesi.
Gerçek vakalar — hızlı okuma
Kod yapıştırıldı ama sohbet baloncuğu yok: önce F12 → Network, meiqia.js arayın — istek yoksa veya 200 değilse yanlış yerleştirilmiş / önbellekte takılı; CDN önbelleğini temizleyin veya gizli modda yeniden açın.
Konsol meiqia.js net::ERR_BLOCKED_BY_CLIENT diyor: bir adblock (AdBlock / uBlock / AdGuard) üçüncü taraf sohbet betiğini reklam kurallarıyla engelledi — uzantıyı kapatın veya siteyi beyaz listeye alın; «konsolunuz iyi görünürken bazı kullanıcılar için eksik» olmasının nedeni de budur.
Betik yüklendi (konsol typeof _MEIQIA function) ama düğme yok: genelde bir tema CSS'i baloncuğu ekran dışına itti veya bir ısı haritası / analitik eklentisi DOM yığılmasını değiştirdi — F12 → Elements, 美洽 kapsayıcısını arayın ve öğe öğe kontrol edin.
Vue / React SPA'da ana sayfada sohbet var ama ikinci rotada yok: SPA rota değişimi kapsayıcıyı yok etti ve widget yeniden oluşturulmadı — auto-init'i durdurmak için manualInit kullanın ve yeniden bağlamak için rota kancasında _MEIQIA('init') çağırın.
Sohbet açılıyor ama temsilciler ziyaretçi mesajı almıyor: büyük olasılıkla entId çalışma masasıyla uyuşmuyor (başkasının parçası kopyalandı / hesaplar karıştı) — Ayarlar - Ekip - kimlik arama'daki şirket kimliğini koddaki entId ile karşılaştırın.
Staging'de çalışıyor, üretim alanında yüklenmiyor: üretim alanı «Entegrasyon sitesi ekle» ile yetkilendirilmedi — canlı alanı listeye ekleyin ve yeniden yayınlayın.
美洽'nin yuvarlak yerel düğmesini kaldırıp kendi «Destek» düğmenizi kullanmak istiyorsunuz: yereli gizlemek için _MEIQIA('withoutBtn') çağırın, sonra sohbeti açmak için düğmenize _MEIQIA('showPanel') bağlayın.
