美洽 widget di chat non si mostra / correggere errore di integrazione
Fig: 美洽 chat non si mostra / correzione errori (comportamento L1 + causa radice L2 + cinque metodi di integrazione)
Hai incollato il codice 美洽(Meiqia) e il widget di chat web non si mostra, il pulsante di chat non appare mai, la console segnala meiqia.js bloccato, o gli agenti non ricevono chat? Chiarisci tre cose prima: lo script non si è caricato affatto (posizione / adblock / cache), si è caricato ma è nascosto da stile / impilamento, o si è caricato bene ma la config non combacia (entId / dominio / ciclo di vita SPA)? Cerca il sintomo o la parola chiave (es. not showing, adblock, entId, SPA, mobile, sdk push): prima il comportamento L1 e il posizionamento ufficiale, poi la causa radice L2 e la soluzione. Installazione / guida? Vedi download di 美洽 / guida all'integrazione dell'assistenza.
Passo 1: verifica se lo script si è caricato, poi dividi in quattro gruppi
Quando la chat di 美洽 non si mostra, 9 volte su 10 è uno di quattro gruppi; guarda prima se lo script si è caricato: F12 → Network, cerca meiqia.js; nessuna richiesta o stato diverso da 200 significa non caricato. ① Errore di caricamento: codice nel posto sbagliato (va prima di </body>, non in <head>), bloccato da una regola adblock (ERR_BLOCKED_BY_CLIENT), trattenuto da cache CDN / browser, o certificato HTTPS / contenuto misto. ② Config / autorizzazione: entId non corrisponde alla workbench (carica ma gli agenti non ricevono chat), o dominio del sito non autorizzato nella console. ③ Integrazione framework: una SPA Vue/React/Next distrugge il contenitore al cambio rotta e il widget non viene ricreato. ④ Visualizzazione / mobile / SDK: il CSS del sito spinge la bolla fuori schermo, un plugin di terze parti sovrappone il DOM, il mobile richiede un deploy proprio, in-app richiede l'SDK. Più completo: guida all'integrazione web di 美洽.
Errore di caricamentoposizione · adblock · cache · HTTPS
Incolla il JS di 美洽 prima di
(non in ); F12 → Network, cerca meiqia.js e controlla lo stato (deve essere 200); ERR_BLOCKED_BY_CLIENT di solito è un'estensione adblock — prova in incognito o whitelist; svuota la cache CDN dopo la pubblicazione; assicura HTTPS completo senza contenuto misto.
entId è l'id univoco della tua azienda; se non corrisponde alla workbench «lo script carica ma gli agenti non ricevono chat» (Impostazioni - Team - ricerca ID); il dominio del sito va autorizzato via «Aggiungi sito di integrazione»; usa un sotto-canale (sonda) per linea di business.
Una SPA Vue/React/Next distrugge il DOM al cambio rotta e il widget non viene ricreato; usa _MEIQIA('manualInit') per fermare l'auto-init e chiama _MEIQIA('init') in un hook di rotta (useEffect / mounted) per rimontarlo.
Problemi di visualizzazioneconflitto di stile · impilamento · plugin di terze parti
Caricato ma invisibile: di solito il CSS globale del sito sovrascrive la posizione della bolla, o un plugin di heatmap / analytics / SEO modifica il DOM e copre il contenitore; F12 → Elements, cerca il contenitore meiqia e controlla display:none, z-index perdente o coordinate fuori schermo.
Mobile / SDKweb mobile · AppKey · push
Il web mobile / PC è lo stesso snippet ma richiede un deploy proprio; in-app usa l'SDK nativo (prima «Aggiungi config APP» nella console per un AppKey); il push si divide in «niente push» (solo in-app) e «server push personalizzato» (consegnato anche dopo aver lasciato l'app).
Chiamate APIwithoutBtn · showPanel · dati cliente
Pulsante proprio? _MEIQIA('withoutBtn') nasconde il pulsante nativo, e chiama _MEIQIA('showPanel') al clic per aprire la chat; passa / sincronizza i dati cliente entro il tempo di init, altrimenti non ha effetto.
Fig 1: triage di 美洽 non si mostra — verifica il caricamento dello script (meiqia.js in F12), poi caricamento / config / framework / visualizzazione
Passo 2: la causa radice più trascurata → L2 (il widget = iniezione JS asincrona di terze parti fuori dominio)
Basta un'idea: il widget web di 美洽 non è un componente statico incorporato nella tua pagina — è un meiqia.js caricato in modo asincrono dal dominio esterno di 美洽 che poi inietta dinamicamente un contenitore di chat (DOM / iframe) e apre una connessione persistente cross-origin verso i server di 美洽. Questo spiega la maggior parte delle «sparizioni misteriose»: ① è uno script di terze parti fuori dominio, quindi AdBlock / uBlock lo bloccano con le loro liste «tracciamento / pubblicità» (ERR_BLOCKED_BY_CLIENT) e il pulsante non appare mai (anche se la console sembra a posto); ② inietta il DOM in modo asincrono: in <head> blocca, un cambio rotta SPA distrugge il contenitore e non viene ricreato da solo (usa manualInit + _MEIQIA('init')), e plugin di heatmap / analytics che modificano il DOM possono coprirlo; ③ si lega alla tua azienda via entId ed è regolato da whitelist domini: con entId errato o dominio non autorizzato lo script carica ma «non collega una chat»; ④ mobile e PC sono due integrazioni distinte, in-app è l'SDK (AppKey), e il push si divide in «niente push» vs «server push personalizzato». Una volta vista questa catena di iniezione, ogni sintomo sotto ha un'unica logica. Sotto il pannello di autoverifica; più sotto i cinque metodi e le stime 2026.
Fig 2: pannello di autoverifica dell'integrazione di 美洽 (verde = confermato / rosso = facilmente trascurato)Fig: verifica «posizione del codice + meiqia.js 200 + inizializzato» prima, poi «adblock + framework/impilamento» — gli ultimi due sono i più trascurati
Tabella completa dei sintomi (comportamento / posizionamento ufficiale · causa radice L2)
Cinque metodi di integrazione di 美洽 a confronto (codice / difficoltà / funzioni / scenario / tempo di attivazione · doc ufficiale)
Metodo di integrazione
Codice / difficoltà
Funzioni complete
Ideale per
Tempo di attivazione
Widget JS web
uno snippet JS · basso
il più completo (fluttuante / popup / saluto automatico / traccia visitatore)
siti PC + mobile (consigliato ufficiale)
~3-5 min
Link di chat
senza codice · minimo
chat di base
senza tecnica / mettere un link di chat rapido
istantaneo
API / SDK WebIM
richiede dev · alto
personalizzazione profonda (UI propria / sistema / integrazione ordini)
team con capacità dev per fusione profonda
secondo dev
SDK nativo di app
integrare SDK · alto
chat in-app + push di messaggi
app iOS / Android
secondo dev
Config rapida CMS
plugin / un clic · basso
come il widget JS
siti WordPress / Fkw / Shopify
minuti
美洽 cause di non visualizzazione & confronto dei metodi di integrazione (stima 2026)
Le seguenti sono stime 2026 sintetizzate dall'aiuto ufficiale di 美洽 (Canali di accesso / API del widget web JavaScript) e dal troubleshooting pubblico di integrazione (non sono impegni del fornitore né misurazioni dirette; di riferimento, cambiano per versione e policy del browser):
Dimensione
Stima / confronto
Distribuzione delle cause di non visualizzazione (community / ticket · st.)
posizione / non caricato ~35% > adblock / estensione del browser ~25% > config / autorizzazione (entId / dominio) ~20% > framework (SPA) ~12% > conflitto di stile / plugin di terze parti ~8%
Cosa è davvero l'integrazione
il widget web = JS asincrono di terze parti fuori dominio che inietta il DOM + una connessione persistente cross-origin (non un componente statico incorporato); da qui l'effetto di posizione, regole adblock, impilamento CSS, ciclo di vita SPA
Integrazione per piattaforma (st.)
web PC / mobile = widget JS (stesso codice, distribuito a parte); app = SDK nativo (AppKey); WeChat / Douyin / RED = integrazione autorizzata per canale
Impatto dell'adblock (st.)
circa il 30-40% degli utenti PC usa un'estensione adblock → lo script di chat di terze parti viene bloccato dalle regole pubblicitarie (ERR_BLOCKED_BY_CLIENT), causa principale di «console a posto, lato utente assente»
Tempo di attivazione del widget JS (ufficiale)
incolla il JS dedicato in fondo alla pagina e va in attivazione in circa 3-5 minuti; entId è l'id univoco dell'azienda, e una discrepanza con la workbench lascia gli agenti senza chat
Base della stima: baseline delle fonti + estrapolazione temporale (meiqia.com/help Canali di accesso / widget web JavaScript, guida all'integrazione meiqia.im, troubleshooting pubblico, 2026); cambia con la versione e la policy di blocco del browser. Segui le informazioni ufficiali più recenti di 美洽. Non ufficiale · localizzazione LLM.
Casi reali — lettura rapida
Codice incollato ma nessuna bolla di chat: prima F12 → Network, cerca meiqia.js — nessuna richiesta o non-200 significa mal posizionato / trattenuto dalla cache; svuota la cache CDN o riapri in incognito.
La console dice meiqia.js net::ERR_BLOCKED_BY_CLIENT: un adblock (AdBlock / uBlock / AdGuard) ha bloccato lo script di chat di terze parti con le sue regole pubblicitarie — disattiva l'estensione o whitelist il sito; ecco perché «manca per alcuni utenti mentre la tua console sembra a posto».
Script caricato (console typeof _MEIQIA è function) ma nessun pulsante: di solito un CSS del tema ha spinto la bolla fuori schermo o un plugin di heatmap / analytics ha cambiato l'impilamento del DOM — F12 → Elements, cerca il contenitore di 美洽 e controlla voce per voce.
La home ha la chat in una SPA Vue / React, ma una seconda rotta no: il cambio rotta SPA ha distrutto il contenitore e il widget non è stato ricreato — usa manualInit per fermare l'auto-init e chiama _MEIQIA('init') nell'hook di rotta per rimontare.
La chat si apre ma gli agenti non ricevono messaggi dei visitatori: molto probabilmente l'entId non corrisponde alla workbench (copiato lo snippet di altri / account confusi) — confronta l'ID azienda in Impostazioni - Team - ricerca ID con l'entId nel codice.
Funziona in staging, non carica sul dominio di produzione: il dominio di produzione non è stato autorizzato via «Aggiungi sito di integrazione» — aggiungi il dominio live alla lista e ripubblica.
Vuoi togliere il pulsante rotondo nativo di 美洽 e usare il tuo «Contatta»: chiama _MEIQIA('withoutBtn') per nascondere il nativo, poi lega _MEIQIA('showPanel') al tuo pulsante per aprire la chat.
