Davranış, resmi konumlandırma ve L2 kök nedeni (JS enjeksiyonu neden başarısız / engellendi) hemen almak için bir belirti yazın. Aşağıda: tam belirti tablosu, enjeksiyon diyagramı, 2026 tahminleriyle karşılaştırılan beş yöntem ve SSS.

«Sohbet çıkmadı» her ne ise, önce dört gruba daraltın — bu tek başına çoğu sapmayı önler. Akış şeması kararı netleştirir: betiğin yüklenip yüklenmediğini (F12'de meiqia.js), sonra yapılandırma, çerçeve mi yoksa görüntüleme katmanı sorunu mu olduğunu kontrol edin. Temel için bkz. 美洽 web entegrasyon kılavuzu.
Bir cümle yeter: 美洽 web widget'ı sayfanızdaki statik bir bileşen değildir — 美洽'nin alan dışı kaynağından asenkron yüklenen, dinamik olarak bir sohbet kapsayıcısı (DOM / iframe) enjekte eden ve çapraz kaynaklı uzun ömürlü bir bağlantı açan bir meiqia.js'tir. Enjeksiyonun başarısı için «betik yüklenmiş (doğru konum, adblock yok), kapsayıcı CSS / diğer eklentilerce kaplanmamış, entId ve alan uyumlu ve SPA rota değişiminden sonra yeniden bağlama» gerekir. Aşağıdaki diyagram bu zinciri ve dört engelleme noktasını çizer — aynı kodun bir site / çerçevede çalışıp diğerinde çalışmamasının nedeni budur.
Konum, meiqia.js 200 ve entId hepsi onaylandıysa ama hâlâ görünmüyorsa, temelde «adblock» veya «çerçeve / yığılma»dır. Aşağıdaki panel önem sırasına göredir: yeşil genelde iyidir, kırmızılar (adblock, SPA / üçüncü taraf eklenti yığılması) sık tuzaklardır. Öğe öğe kontrol etmek hızlı yerelleştirir.

Aşağıdaki tablo yaygın görünmeme / hata belirtilerini bir kerede listeler, her biri resmi konumlandırma ve L2 kök nedeniyle. Yukarıdaki arama kutusu bu tablonun verisiyle çalışır — karşılaştığınız anahtar kelimeyi arayın.
| Belirti | Grup | L1 davranışı / resmi konumlandırma | L2 kök neden |
|---|---|---|---|
| Sohbet penceresi / baloncuğu hiç görünmüyor | Yükleme hatası | 美洽 web widget'ı tek bir yapıştırılan JS parçasıyla yüzen bir sohbet penceresi yükler; kodun doğru gömüldüğünü ve entegrasyon sitesinin konsolda yapılandırıldığını doğrulayın. | Widget, asenkron yüklemeden sonra DOM'a enjekte edilen meiqia.js'tir, bu yüzden «hiçbir şey yok» genelde «betik hiç yüklenmedi» demektir: yanlış konum, adblock / önbellek ile engellenmiş veya uyuşmayan alan / entId, bu yüzden enjeksiyon hiç çalışmadı. |
| Betik yüklendi ama sohbet düğmesi eksik | Görüntüleme sorunları | Widget kodu siteye uyum sağlar ve bir sohbet düğmesi gösterir; görüntüleme başarısızsa stillerle gizlenip gizlenmediğini veya başlatmanın kesilip kesilmediğini kontrol edin. | Betik yüklenir ama düğme eksikse, genelde «görüntüleme katmanı» sorunudur: genel CSS düğme konumunu geçersiz kılar / display:none yapar, z-index kaybeder veya başka sabit bir öğe onu kaplar; başka bir JS hatası da başlatmayı durdurabilir. |
| meiqia.js bir adblock uzantısıyla engellendi | Yükleme hatası | 美洽 sohbet betiği üçüncü taraf bir alandan gelir; bir engelleme uzantısı kuruluysa onu reklam / izleyici sayıp yüklemeyi engelleyebilir — engellemeyi kapatın veya beyaz listeye alın. | ERR_BLOCKED_BY_CLIENT, bir tarayıcı uzantısının (AdBlock / uBlock / AdGuard) isteği filtre listeleriyle engellediği anlamına gelir. 美洽 betiği «üçüncü taraf alan dışı + gerçek zamanlı iletişim»dir; bu kurallar genelde onu reklam / izleyici sanıp «konsol iyi, kullanıcı tarafı eksik» sahte hatasına yol açar. |
| meiqia.js 404 / kötü durum / karışık içerik | Yükleme hatası | Dağıtımdan sonra Network panelinde meiqia.js arayın; 200 durumu betiğin doğru yerleştirildiği ve yüklendiği anlamına gelir. | Yaygın 200-olmayan nedenler: kod sayfa / CDN önbelleğinde takılı (yayından sonra yenilenmedi), HTTP sayfada yükleme / eksik sertifika zinciri karışık içerik engellemesini tetikler veya bozuk / kısmen kopyalanmış kod. Bu adım başarısız olursa enjeksiyon ve bağlantı asla gerçekleşmez. |
| Kod yanlış yerde (head engellemesi / etkisiz) | Yükleme hatası | 美洽, kodu sayfanın altına, </body> öncesine yapıştırmayı önerir; widget ana içerik yüklendikten sonra çalışır. | Widget, kapsayıcısını DOM hazır olduktan sonra enjekte etmelidir. <head> içinde işlemeyi engeller (zayıf ağda önce boş ekran) veya DOM hazır olmadan çalışıp başarısız olur; bazı async / modül kapsamlarında yükleme sırası da bozulabilir. |
| Sohbet penceresi / düğme stili bozuk | Görüntüleme sorunları | Widget kendi stillerini enjekte eder ve siteye uyum sağlar; genel stillerle çakışma görsel anomalilere yol açabilir. | 美洽 betiği çalışma zamanında CSS enjekte eder; genel stiller (evrensel seçiciler / yüksek öncelikli kurallar / resetler) sınıflarını önce geçersiz kılarsa konum, yığılma ve yazı tipleri bozulur — «dinamik enjeksiyon + tek belge stil alanını paylaşma»nın yan etkisi. |
| Düğme ekran dışı / kaplı | Görüntüleme sorunları | Widget düğmesi sabit konumlu yüzen olarak görünür; başka sabit öğelerce kaplıysa yığılmayı veya konumu ayarlayın. | Sitenin diğer position:fixed öğeleri (başa dön, yüzen reklamlar, özel destek çubuğu) daha yüksek z-index ile 美洽 düğmesini kaplar veya tema koordinatlarını yanlış hesaplar, onu «ekran dışı / kaplı» bırakır. |
| Üçüncü taraf eklenti / analitik DOM çakışması | Görüntüleme sorunları | Sayfadaki DOM'u değiştiren veya istekleri yakalayan diğer betikler widget'ın normal yüklenmesini ve görüntülenmesini etkileyebilir. | Isı haritası / analitik / dönüşüm betikleri DOM'u yeniden yazar, kaplamalar enjekte eder veya istekleri yakalar; onlar ve 美洽 aynı belgeye enjekte ettiğinden yığılma / olaylar çakışır ve 美洽 kapsayıcısı kaplanır veya init'i kesilir. |
| SPA rota değişiminden sonra widget kayboluyor | Çerçeve entegrasyonu | Tek sayfa uygulamaları (SPA) için 美洽 widget'ını yüklemek / başlatmak üzere çerçevenin rota kancalarını kullanın, böylece ön uç yönlendirmesine uyar. | Bir SPA görünümleri ön uç yönlendirmesiyle değiştirir, DOM'u yok eder / yeniden oluşturur, ama meiqia.js varsayılan olarak ilk yüklemede bir kez enjekte eder ve rota değişiminde kendiliğinden yeniden oluşturulmaz, yani «sayfa değiştir, sohbet gitti». |
| Manuel init gerekli (manualInit / init) | Çerçeve entegrasyonu | İndirmeden sonra auto-init'i durdurmak için 美洽 gömme kodundan sonra _MEIQIA('manualInit') ekleyin; gerektiğinde manuel başlatmak için _MEIQIA('init') çağırın. | Varsayılan olarak 美洽 indirmeden hemen sonra başlar; kapsayıcı hazır / müşteri bilgisi geçilmiş / rota önce kararlı olmalıysa o zamanlama «çok erken» — sırayı kontrol etmek için manuel init'e geçin. |
| entId uyuşmuyor / temsilciler sohbet almıyor | Yapılandırma / yetki | Koddaki entId'den sonraki sayı şirketinizin benzersiz kimliğidir; çalışma masasıyla uyuşmazsa temsilciler sohbete bakamaz — şirket kimliğini Ayarlar - Ekip - kimlik arama'da bulun. | entId parçayı belirli bir şirket hesabına bağlar. Başkasının / başka ortamın koduyla ya da karışmış hesaplarla ön uç pencereyi yükler ama mesajlar «başka bir şirkete» gider, bu yüzden bu çalışma masası hiçbirini almaz — klasik «iyi görünür ama hiçbir şey almaz». |
| Site alanı konsolda yetkilendirilmemiş | Yapılandırma / yetki | 美洽 konsolu, her biri kendi yapılandırmasıyla «Entegrasyon sitesi ekle»ye izin verir; yeni bir site iyi entegre olmadan önce konsolda yapılandırılmalıdır. | 美洽 birden çok siteyi «entegrasyon siteleri» olarak yönetir; alan tanınmak için konsolda kayıtlı / yetkili olmalıdır. Eklenmemiş yeni bir üretim alanı kabul edilmeyebilir veya yanlış yapılandırmaya eşlenebilir. |
| Çoklu site / alt kanal (sonda) karışması | Yapılandırma / yetki | 美洽, site başına farklı widget ve sohbet bağlantısı dağıtmayı destekler (alt kanallar / sonda); varsayılan site dışında daha fazla ekleyebilirsiniz, her biri kendi yapılandırmasıyla. | Farklı iş kolları farklı temsilci grupları / otomatik mesajlar gerektirir, ama her site tek varsayılan parçayı paylaşırsa kaynaklar ayırt edilemez ve yapılandırmalar karışır. Alt kanallar (sonda) «tek şirket, çok giriş, yönlendirilmiş» için tasarlanmıştır. |
| Mobil web sohbeti görünmüyor / ayrı dağıtım gerekir | Mobil / SDK | Widget kodu siteye uyum sağlar; mobil / PC aynı parçayı kullanır ama ayrı dağıtılmalıdır. | Birçok ekip ayrı PC ve mobil sayfa / şablonlara sahiptir ve kodu yalnızca PC şablonuna yapıştırdı. Parça aynıdır ve kendini uyarlar, ama «yapıştır» adımı mobil şablonda da yapılmalıdır; atlanırsa mobilde sohbet olmaz. |
| Yerel uygulama SDK entegrasyonu / AppKey | Mobil / SDK | Uygulama içi entegrasyon 美洽 çalışma masasından bir AppKey gerektirir (Ayarlar - Entegrasyon - SDK, «APP yapılandırması ekle») ve geliştiriciler iOS / Android SDK'sını resmi belge ve demoya göre entegre eder. | Bir uygulama web JS'i değil yerel SDK kullanır: önce AppKey için «APP yapılandırması ekle», sonra sohbet arayüzü, okunmamış, push vb. için platform başına SDK'yı entegre edin — web widget'ından tamamen farklı bir yol. |
| SDK mesaj push'u gelmiyor | Mobil / SDK | 美洽 SDK push'unun iki modu vardır: «push yok» ile temsilci mesajları yalnızca uygulamaya ulaşır (almak için açın); «özel push sunucusu» ile kullanıcılar uygulamadan çıktıktan sonra bile telefona push alır. | Eksik «çevrimdışı push» genelde push modunun «push yok» olduğu veya özel push sunucusu / platform başına push sertifikalarının olmadığı anlamına gelir. Yol «美洽 → uygulama sunucusu → kullanıcı telefonu»dur; eksik bir halka yalnızca uygulama içi alımı bırakır. |
| Varsayılan düğmeyi gizle / özel giriş | API çağrıları | 美洽'nin yerel sohbet düğmesini göstermemek için _MEIQIA('withoutBtn') çağırın; init başarılı olunca sohbeti açmak için _MEIQIA('showPanel') çağırın. | Varsayılan olarak yerel yüzen düğme işlenir; kendi girişiniz için init öncesi / sırasında «yerel düğme yok» bildirmeli ve «sohbet aç»ı kendi öğenize bağlamalısınız — API zamanlaması meselesi, «bozuk düğme» değil. |
| Müşteri bilgisi geçme / senkronize etme etkisiz | API çağrıları | 美洽 web widget'ı, ziyaretçi verisini sohbete getirmek için «müşteri bilgisi geç», «müşteri kimliğini senkronize et» ve «özel olay bilgisi ekle» API'leri sunar. | Bu API'ler doğru init zamanı içinde çağrılmalıdır: init başarısından sonra (veya manualInit + init zamanlamasıyla). Çok erken / geç ya da yanlış alan biçimleri «ayarlandı ama etkisiz» bırakır. |
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):
| Boyut | Tahmin / karşılaştırma |
|---|---|
| Görünmeme nedenleri dağılımı (topluluk / talepler · tah.) | 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.


Hangi entegrasyon yöntemi? Aşağıdaki karşılaştırma, hızlı çapraz referans için resmi 美洽 belgelerini sentezler (kod hacmi, özellik bütünlüğü, en iyi uyum, yayına alma süresi). Çoğu site «web JS widget'ı»nı seçer.
| 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 | geliştirmeye göre |
| Yerel uygulama SDK | SDK entegre · yüksek | uygulama içi sohbet + mesaj push'u | iOS / Android uygulamaları | geliştirmeye göre |
| CMS hızlı kurulum | eklenti / tek tık · düşük | JS widget'ı gibi | WordPress / Fkw / Shopify siteleri | dakikalar |
Aynı 美洽 kanal / senaryoya göre farklı entegre olur. Aşağıdaki harita yaygın kanalları gösterir: yeşil = yapıştır ve çalış, sarı = kurulum gerekir (ayrı dağıtım / init / beyaz liste), kırmızı = varsayılan olarak yöntem değiştir (adblock / entId / uygulama SDK kullanır).
美洽 web widget'ı tek bir yapıştırılan JS parçasıyla yüzen bir sohbet penceresi yükler; kodun doğru gömüldüğünü ve entegrasyon sitesinin konsolda yapılandırıldığını doğrulayın. Widget, asenkron yüklemeden sonra DOM'a enjekte edilen meiqia.js'tir, bu yüzden «hiçbir şey yok» genelde «betik hiç yüklenmedi» demektir: yanlış konum, adblock / önbellek ile engellenmiş veya uyuşmayan alan / entId, bu yüzden enjeksiyon hiç çalışmadı. F12 → Network, meiqia.js arayın: istek yok → kod etkisiz (konumu kontrol edin / önbelleği temizleyin); istek var ama 200 değil → engellendi veya yol sorunu; her şey iyi ama hâlâ gizli → entId / alan yetkisini ve aşağıdaki grupları kontrol edin.
Widget kodu siteye uyum sağlar ve bir sohbet düğmesi gösterir; görüntüleme başarısızsa stillerle gizlenip gizlenmediğini veya başlatmanın kesilip kesilmediğini kontrol edin. Betik yüklenir ama düğme eksikse, genelde «görüntüleme katmanı» sorunudur: genel CSS düğme konumunu geçersiz kılar / display:none yapar, z-index kaybeder veya başka sabit bir öğe onu kaplar; başka bir JS hatası da başlatmayı durdurabilir. F12 → Elements, 美洽 kapsayıcısını bulun — var mı, gizli mi, ekran dışı mı?; yeniden test için özel CSS / betikleri geçici devre dışı bırakın; yürütmeyi durduran bir hata için konsolu kontrol edin.
美洽 sohbet betiği üçüncü taraf bir alandan gelir; bir engelleme uzantısı kuruluysa onu reklam / izleyici sayıp yüklemeyi engelleyebilir — engellemeyi kapatın veya beyaz listeye alın. ERR_BLOCKED_BY_CLIENT, bir tarayıcı uzantısının (AdBlock / uBlock / AdGuard) isteği filtre listeleriyle engellediği anlamına gelir. 美洽 betiği «üçüncü taraf alan dışı + gerçek zamanlı iletişim»dir; bu kurallar genelde onu reklam / izleyici sanıp «konsol iyi, kullanıcı tarafı eksik» sahte hatasına yol açar. Gizli modda veya adblock kapalı yeniden test edin — görünürse neden engellemedir; kullanıcılardan siteyi beyaz listeye almasını isteyin; ön uç bazı otomatik kuralları atlatmak için sohbet betiğini gecikmeli / koşullu yükleyebilir.
Dağıtımdan sonra Network panelinde meiqia.js arayın; 200 durumu betiğin doğru yerleştirildiği ve yüklendiği anlamına gelir. Yaygın 200-olmayan nedenler: kod sayfa / CDN önbelleğinde takılı (yayından sonra yenilenmedi), HTTP sayfada yükleme / eksik sertifika zinciri karışık içerik engellemesini tetikler veya bozuk / kısmen kopyalanmış kod. Bu adım başarısız olursa enjeksiyon ve bağlantı asla gerçekleşmez. Yayından sonra CDN / tarayıcı önbelleğini temizleyin (veya gizli mod); bütün sertifika zinciriyle tam HTTPS ve karışık içerik olmadan sağlayın; kopyalanan kodun tam ve kaçışsız olduğunu doğrulayın.
美洽, kodu sayfanın altına, </body> öncesine yapıştırmayı önerir; widget ana içerik yüklendikten sonra çalışır. Widget, kapsayıcısını DOM hazır olduktan sonra enjekte etmelidir. <head> içinde işlemeyi engeller (zayıf ağda önce boş ekran) veya DOM hazır olmadan çalışıp başarısız olur; bazı async / modül kapsamlarında yükleme sırası da bozulabilir. 美洽 JS'i her sayfanın ortak alt bilgisine, </body> öncesine koyun; SPA'lar için «SPA rota» girdisine bakın ve manualInit kullanın; bir paketleyicinin onu tree-shaking ile kaldırmadığından emin olun.
Widget kendi stillerini enjekte eder ve siteye uyum sağlar; genel stillerle çakışma görsel anomalilere yol açabilir. 美洽 betiği çalışma zamanında CSS enjekte eder; genel stiller (evrensel seçiciler / yüksek öncelikli kurallar / resetler) sınıflarını önce geçersiz kılarsa konum, yığılma ve yazı tipleri bozulur — «dinamik enjeksiyon + tek belge stil alanını paylaşma»nın yan etkisi. Hangi site kuralının 美洽 kapsayıcısını geçersiz kıldığını görmek için F12; genel stilleri daraltın / genel sınıflar üzerindeki etkiyi azaltın; gerekirse 美洽'den kapsayıcı yığılmasını ayarlamasını isteyin.
Widget düğmesi sabit konumlu yüzen olarak görünür; başka sabit öğelerce kaplıysa yığılmayı veya konumu ayarlayın. Sitenin diğer position:fixed öğeleri (başa dön, yüzen reklamlar, özel destek çubuğu) daha yüksek z-index ile 美洽 düğmesini kaplar veya tema koordinatlarını yanlış hesaplar, onu «ekran dışı / kaplı» bırakır. Gerçek koordinatları / z-index'i görmek için F12'de 美洽 kapsayıcısını seçin; onu yükseltin veya kaplayan öğenin z-index'ini düşürün; bir köşede birden çok sabit yüzeni yığmaktan kaçının.
Sayfadaki DOM'u değiştiren veya istekleri yakalayan diğer betikler widget'ın normal yüklenmesini ve görüntülenmesini etkileyebilir. Isı haritası / analitik / dönüşüm betikleri DOM'u yeniden yazar, kaplamalar enjekte eder veya istekleri yakalar; onlar ve 美洽 aynı belgeye enjekte ettiğinden yığılma / olaylar çakışır ve 美洽 kapsayıcısı kaplanır veya init'i kesilir. Çakışmayı yerelleştirmek için şüpheli eklentileri tek tek devre dışı bırakın; yükleme sırasını / kapsayıcı yığılmasını ayarlayın; ısı haritalarının vb. 美洽 kapsayıcı alanından kaçınmasını sağlayın.
Tek sayfa uygulamaları (SPA) için 美洽 widget'ını yüklemek / başlatmak üzere çerçevenin rota kancalarını kullanın, böylece ön uç yönlendirmesine uyar. Bir SPA görünümleri ön uç yönlendirmesiyle değiştirir, DOM'u yok eder / yeniden oluşturur, ama meiqia.js varsayılan olarak ilk yüklemede bir kez enjekte eder ve rota değişiminde kendiliğinden yeniden oluşturulmaz, yani «sayfa değiştir, sohbet gitti». Auto-init'i durdurmak için _MEIQIA('manualInit') kullanın ve gerektiğinde yeniden bağlamak için bir rota kancasında (React useEffect / Vue mounted / router afterEach) _MEIQIA('init') çağırın; birden çok örnek başlatmaktan kaçının.
İndirmeden sonra auto-init'i durdurmak için 美洽 gömme kodundan sonra _MEIQIA('manualInit') ekleyin; gerektiğinde manuel başlatmak için _MEIQIA('init') çağırın. Varsayılan olarak 美洽 indirmeden hemen sonra başlar; kapsayıcı hazır / müşteri bilgisi geçilmiş / rota önce kararlı olmalıysa o zamanlama «çok erken» — sırayı kontrol etmek için manuel init'e geçin. Koddan sonra _MEIQIA('manualInit') ekleyin; koşullar hazır olunca (DOM / oturum / rota) _MEIQIA('init') çağırın; veri API'lerini belgeye göre init zamanı içinde sırayla çağırın.
Daha fazla entegrasyon kurulumu: 美洽 web entegrasyonu, APP SDK entegrasyonu; başlamak için: 美洽 kılavuzu. Aranabilir tam sürüm (bu araç dahil) ayrıca 美洽 entegrasyon sorun giderme (GitHub Pages).