Hakbang 1: hatiin sa apat na grupo (load / config / framework / display)
Anuman ang «hindi lumabas ang chat» mo, paliitin muna sa apat na grupo — ito lang ang nagse-save ng karamihan sa mga paliko. Nililinaw ng flowchart ang desisyon: suriin kung na-load ba ang script (meiqia.js sa F12), tapos kung config, framework o isyu sa display layer. Para sa basics tingnan ang gabay sa web integration ng 美洽.
Paano gumagana ang integration: bakit nabibigo / naharang ang JS injection na ito
Sapat ang isang pangungusap: ang 美洽 web widget ay hindi static component sa pahina mo — ito ay meiqia.js na asynchronously na nilo-load mula sa off-domain na pinagmulan ng 美洽 na dynamic na nag-iinject ng chat container (DOM / iframe) at nagbubukas ng matagal na cross-origin connection. Para magtagumpay ang injection kailangan ng «na-load ang script (tamang placement, walang adblock), hindi natakpan ang container ng CSS / ibang plugin, tugma ang entId at domain, at re-mount pagkatapos ng SPA route change». Iginuguhit ng diagram sa ibaba ang chain na ito at apat na block point — kaya gumagana ang parehong code sa isang site / framework pero hindi sa iba.
Tama ang placement ng code pero hindi pa rin lumalabas: patakbuhin ang integration self-check panel
Kung nakumpirma na ang placement, meiqia.js 200 at entId pero hindi pa rin lumalabas, sa pangkalahatan ito ay «adblock» o «framework / stacking». Nakaayos ang panel sa ibaba ayon sa kahalagahan: berde ay kadalasang maayos, ang pula (adblock, SPA / third-party plugin stacking) ang madalas na bitag. Mabilis na natutukoy kapag sinuri item bawat item.
Buong talahanayan ng sintomas (behavior / opisyal na posisyon · L2 root cause)
Inililista ng talahanayan sa ibaba nang sabay-sabay ang mga karaniwang sintomas ng hindi paglabas / error, bawat isa may opisyal na posisyon at L2 root cause. Ang search box sa itaas ay pinapatakbo ng data ng talahanayang ito — hanapin ang keyword na naranasan mo.
| Sintomas | Grupo | L1 behavior / opisyal na posisyon | L2 root cause |
|---|---|---|---|
| Hindi talaga lumalabas ang chat window / bubble | Pagkabigo sa pag-load | Nilo-load ng 美洽 web widget ang isang floating chat window gamit ang isang idinikit na JS snippet; kumpirmahin na maayos na naka-embed ang code at naka-configure ang integration site sa console. | Ang widget ay meiqia.js na ini-inject sa DOM pagkatapos ng asynchronous load, kaya ang «walang anuman» ay kadalasang nangangahulugang «hindi kailanman na-load ang script»: maling placement, naharang ng adblock / cache, o hindi tugmang domain / entId, kaya hindi tumakbo ang injection. |
| Na-load ang script pero nawawala ang chat button | Mga isyu sa display | Umaangkop ang widget code sa site at nagpapakita ng chat button; kung nabigo ang display, suriin kung natago ito ng mga style o naputol ang initialization. | Kung na-load ang script pero nawawala ang button, kadalasang isyu sa «display layer» ito: ni-override ng site-wide CSS ang posisyon ng button / nag-set ng display:none, natalo ang z-index, o tinakpan ng ibang fixed element; maaari ring putulin ng ibang JS error ang initialization. |
| meiqia.js naharang ng adblock extension | Pagkabigo sa pag-load | Galing sa third-party domain ang 美洽 chat script; kung may naka-install na blocking extension, maaari nitong ituring na ad / tracker at pigilan ang pag-load — patayin ang blocking o i-whitelist. | Ang ERR_BLOCKED_BY_CLIENT ay nangangahulugang hinarang ng browser extension (AdBlock / uBlock / AdGuard) ang request sa pamamagitan ng filter lists nito. Ang 美洽 script ay «third-party off-domain + realtime communication», na madalas ipinagkakamali ng mga panuntunang iyon na ad / tracker, na nagdudulot ng false failure na «maayos ang console, nawawala sa gilid ng user». |
| meiqia.js 404 / masamang status / mixed content | Pagkabigo sa pag-load | Pagkatapos i-deploy, hanapin ang meiqia.js sa Network panel; ang status 200 ay nangangahulugang tama ang placement at na-load ang script. | Karaniwang sanhi ng hindi-200: code na hawak ng page / CDN cache (hindi na-refresh pagkatapos i-publish), na-load sa HTTP page / hindi kumpletong certificate chain na nagti-trigger ng mixed-content blocking, o sirang / bahagyang nakopyang code. Kapag nabigo ang hakbang na ito, hindi kailanman nangyayari ang injection at koneksyon. |
| Maling lugar ng code (head blocking / walang bisa) | Pagkabigo sa pag-load | Inirerekomenda ng 美洽 na idikit ang code sa ibaba ng pahina, bago ang </body>; tumatakbo ang widget pagkatapos ma-load ang pangunahing nilalaman. | Dapat i-inject ng widget ang container nito pagkatapos maging handa ang DOM. Sa <head> humaharang ito sa render (blangkong screen muna sa mahinang network) o tumatakbo bago handa ang DOM at nabibigo; sa ilang async / module scope maaari ring magkamali ang load order. |
| Sirang styling ng chat window / button | Mga isyu sa display | Nag-iinject ang widget ng sariling mga style at umaangkop sa site; ang mga conflict sa site-wide styles ay maaaring magdulot ng visual glitches. | Nag-iinject ang 美洽 script ng CSS sa runtime; kung ni-override muna ng site-wide styles (universal selectors / high-priority rules / resets) ang mga class nito, nasisira ang posisyon, stacking at fonts — side effect ng «dynamic injection + pagbabahagi ng iisang document style space». |
| Button nasa labas ng screen / natakpan | Mga isyu sa display | Lumalabas ang button ng widget bilang fixed-position float; kung natakpan ng ibang fixed elements, i-adjust ang stacking o posisyon. | Ang ibang position:fixed na elemento ng site (back-to-top, floating ads, custom support bar) na may mas mataas na z-index ay tinatakpan ang 美洽 button, o mali ang pagkalkula ng theme sa coordinate nito, na iniiwan itong «labas ng screen / natakpan». |
| DOM conflict ng third-party plugin / analytics | Mga isyu sa display | Ang ibang script sa pahina na nagbabago ng DOM o humaharang ng request ay maaaring makaapekto sa normal na pag-load at display ng widget. | Muling isinusulat ng heatmap / analytics / conversion scripts ang DOM, nag-iinject ng overlay o humaharang ng request; dahil sila at ang 美洽 ay nag-iinject sa iisang dokumento, nag-iinterfere ang stacking / events at natatakpan ang 美洽 container o naputol ang init nito. |
| Nawawala ang widget pagkatapos ng SPA route change | Framework integration | Para sa single-page apps (SPA), gamitin ang route hooks ng framework para i-load / i-init ang 美洽 widget upang umangkop sa front-end routing. | Nagpapalit ng view ang SPA sa pamamagitan ng front-end routing, sinisira / muling itinatayo ang DOM, pero nag-iinject ang meiqia.js nang isang beses sa unang load bilang default at hindi muling itinatayo nang kusa sa route change, kaya «magpalit ng pahina, nawala ang chat». |
| Kailangan ng manual init (manualInit / init) | Framework integration | Idagdag ang _MEIQIA('manualInit') pagkatapos ng embed code ng 美洽 para itigil ang auto-init pagkatapos ng download; tawagin ang _MEIQIA('init') para manu-manong i-init kung kailangan. | Bilang default nag-i-init ang 美洽 kaagad pagkatapos ng download; kapag kailangan mo munang handa ang container / naipasa ang impormasyon ng customer / stable ang route, ang timing na iyon ay «masyadong maaga» — lumipat sa manual init para kontrolin ang pagkakasunod-sunod. |
| Hindi tugma ang entId / walang chat ang mga ahente | Config / awtorisasyon | Ang numero pagkatapos ng entId sa code ay natatanging id ng kumpanya mo; kung hindi tugma sa workbench, hindi maaasikaso ng mga ahente ang chat — hanapin ang company ID sa Settings - Team - ID lookup. | Iniuugnay ng entId ang snippet sa isang partikular na company account. Sa code ng iba / ibang environment, o nagkahalong account, nilo-load ng front end ang window pero napupunta ang mga mensahe sa «ibang kumpanya», kaya walang natatanggap ang workbench na ito — ang klasikong «mukhang maayos pero walang natatanggap». |
| Hindi awtorisado ang domain ng site sa console | Config / awtorisasyon | Pinapayagan ng 美洽 console ang «Add integration site», bawat isa may sariling config; dapat i-configure ang bagong site sa console bago ito maayos na ma-integrate. | Pinamamahalaan ng 美洽 ang maraming site bilang «integration sites»; dapat nakarehistro / awtorisado ang domain sa console para makilala. Ang bagong production domain na hindi naidagdag ay maaaring hindi tanggapin o ma-map sa maling config. |
| Multi-site / sub-channel (probe) nagkakahalo | Config / awtorisasyon | Sinusuportahan ng 美洽 ang pag-deploy ng iba't ibang widget at chat link bawat site (sub-channels / probe); bukod sa default site maaari kang magdagdag pa, bawat isa may sariling config. | Kailangan ng iba't ibang business line ng iba't ibang agent group / auto-message, pero kung bawat site ay nagbabahagi ng iisang default snippet, hindi matukoy ang pinagmulan at nagkakahalo ang config. Dinisenyo ang sub-channels (probe) para sa «isang kumpanya, maraming entry, naka-route». |
| Hindi lumalabas ang mobile web chat / kailangan ng hiwalay na deploy | Mobile / SDK | Umaangkop ang widget code sa site; parehong snippet ang mobile / PC pero dapat i-deploy nang hiwalay. | Maraming team ang may hiwalay na PC at mobile page / template at idinikit lang ang code sa PC template. Pareho ang snippet at kusang umaangkop, pero dapat gawin din ang hakbang na «idikit» sa mobile template; kapag nalampasan, walang chat ang mobile. |
| Native app SDK integration / AppKey | Mobile / SDK | Kailangan ng in-app integration ng AppKey mula sa 美洽 workbench (Settings - Integration - SDK, «Add APP config»), at ini-integrate ng mga developer ang iOS / Android SDK ayon sa opisyal na doc at demo. | Gumagamit ang app ng native SDK, hindi web JS: una «Add APP config» para sa AppKey, tapos i-integrate ang SDK bawat platform para sa chat UI, unread, push, atbp. — ganap na ibang path kaysa web widget. |
| Hindi dumarating ang SDK message push | Mobile / SDK | May dalawang mode ang 美洽 SDK push: sa «walang push», umaabot lang sa loob ng app ang mga mensahe ng ahente (buksan ang app para matanggap); sa «custom push server», nakakatanggap ang mga user ng push sa telepono kahit umalis na sa app. | Ang nawawalang «offline push» ay kadalasang nangangahulugang «walang push» ang push mode, o walang custom push server / per-platform push certificates. Ang path ay «美洽 → app server → telepono ng user»; ang nawawalang link ay nag-iiwan lang ng in-app receipt. |
| Itago ang default button / custom entry | Mga API call | Tawagin ang _MEIQIA('withoutBtn') para hindi ipakita ang native button ng 美洽; pagkatapos ng matagumpay na init, tawagin ang _MEIQIA('showPanel') para buksan ang chat. | Bilang default na-render ang native floating button; para sa sariling entry kailangan mong ideklara ang «walang native button» bago / habang init at i-bind ang «buksan ang chat» sa elemento mo — usapin ng API timing, hindi «sirang button». |
| Walang bisa ang pagpasa / pag-sync ng impormasyon ng customer | Mga API call | Nag-aalok ang 美洽 web widget ng API na «ipasa ang impormasyon ng customer», «i-sync ang identity ng customer» at «magdagdag ng custom event info» para dalhin ang data ng bisita sa chat. | Dapat tawagin ang mga API na ito sa loob ng tamang init timing: pagkatapos ng matagumpay na init (o sa manualInit + init timing). Masyadong maaga / huli, o maling field formats, at «naka-set pero walang bisa». |
美洽 mga sanhi ng hindi paglabas & paghahambing ng paraan ng integration (tantiya 2026)
Ang sumusunod ay mga tantiya sa 2026 na sinintesa mula sa opisyal na tulong ng 美洽 (Access Channels / JavaScript web widget API) at pampublikong integration troubleshooting (hindi pangako ng vendor o first-hand na pagsukat; para sa sanggunian, nagbabago ayon sa bersyon at patakaran ng browser):
| Dimensyon | Tantiya / paghahambing |
|---|---|
| Distribusyon ng mga sanhi ng hindi paglabas (komunidad / tickets · tant.) | placement / hindi na-load ~35% > adblock / browser extension ~25% > config / awtorisasyon (entId / domain) ~20% > framework (SPA) ~12% > style / third-party plugin conflict ~8% |
| Ano talaga ang integration | ang web widget = third-party off-domain asynchronous JS na nag-iinject ng DOM + matagal na cross-origin connection (hindi naka-embed na static component); kaya naaapektuhan ng placement, panuntunan ng adblock, CSS stacking, SPA lifecycle |
| Integration bawat platform (tant.) | PC / mobile web = JS widget (parehong code, deployed nang hiwalay); app = native SDK (AppKey); WeChat / Douyin / RED = channel-authorized integration |
| Epekto ng adblock (tant.) | humigit-kumulang 30-40% ng PC users ang gumagamit ng adblock extension → naharang ang third-party chat script ng ad rules (ERR_BLOCKED_BY_CLIENT), pangunahing sanhi ng «maayos ang console, nawawala sa gilid ng user» |
| Oras na ma-live ng JS widget (opisyal) | idikit ang dedikadong JS sa ibaba ng pahina at mago-go-live sa humigit-kumulang 3-5 minuto; ang entId ay natatanging id ng kumpanya, at ang hindi pagkakatugma sa workbench ay nag-iiwan sa mga ahente nang walang chat |
Batayan ng tantiya: source baseline + time extrapolation (meiqia.com/help Access Channels / JavaScript web widget, meiqia.im integration guide, pampublikong troubleshooting, 2026); nagbabago ayon sa bersyon at patakaran ng pagharang ng browser. Sundin ang pinakabagong opisyal na impormasyon ng 美洽. Hindi opisyal · LLM localization.
Limang paraan ng integration ng 美洽 na ikinumpara (code / hirap / mga tampok / senaryo / oras na ma-live)
Aling paraan ng integration? Sinintesa ng paghahambing sa ibaba ang opisyal na doc ng 美洽 para sa mabilis na cross-reference (dami ng code, kabuuan ng tampok, pinakaangkop, oras na ma-live). Karamihan sa mga site ay pumipili ng «web JS widget».
| Paraan ng integration | Code / hirap | Kabuuan ng tampok | Pinakamahusay para sa | Oras na ma-live |
|---|---|---|---|---|
| Web JS widget | isang JS snippet · mababa | pinakakumpleto (float / popup / auto-greet / visitor trail) | PC + mobile site (opisyal na inirerekomenda) | ~3-5 min |
| Chat link | walang code · pinakamababa | basic chat | walang teknikal / maglagay ng mabilis na chat link | agad |
| API / WebIM SDK | kailangan ng dev · mataas | malalim na customization (sariling UI / system / order integration) | team na may kapasidad sa dev para sa malalim na fusion | depende sa dev |
| Native app SDK | i-integrate ang SDK · mataas | in-app chat + message push | iOS / Android apps | depende sa dev |
| CMS quick setup | plugin / one-click · mababa | katulad ng JS widget | WordPress / Fkw / Shopify sites | minuto |
Channel / senaryo → mapa ng resulta ng integration
Naiba-iba ang integration ng parehong 美洽 ayon sa channel / senaryo. Ipinapakita ng mapa sa ibaba ang karaniwang channel: berde = idikit at gagana, amber = kailangan ng setup (hiwalay na deploy / init / whitelist), pula = magpalit ng paraan bilang default (adblock / entId / SDK ang ginagamit ng app).
Mga madalas itanong
美洽 Hindi talaga lumalabas ang chat window / bubble — paano aayusin?
Nilo-load ng 美洽 web widget ang isang floating chat window gamit ang isang idinikit na JS snippet; kumpirmahin na maayos na naka-embed ang code at naka-configure ang integration site sa console. Ang widget ay meiqia.js na ini-inject sa DOM pagkatapos ng asynchronous load, kaya ang «walang anuman» ay kadalasang nangangahulugang «hindi kailanman na-load ang script»: maling placement, naharang ng adblock / cache, o hindi tugmang domain / entId, kaya hindi tumakbo ang injection. F12 → Network, hanapin ang meiqia.js: walang request → walang bisa ang code (suriin ang placement / linisin ang cache); may request pero hindi-200 → naharang o isyu sa path; lahat maayos pero natatago pa rin → suriin ang entId / awtorisasyon ng domain at ang mga grupo sa ibaba.
美洽 Na-load ang script pero nawawala ang chat button — paano aayusin?
Umaangkop ang widget code sa site at nagpapakita ng chat button; kung nabigo ang display, suriin kung natago ito ng mga style o naputol ang initialization. Kung na-load ang script pero nawawala ang button, kadalasang isyu sa «display layer» ito: ni-override ng site-wide CSS ang posisyon ng button / nag-set ng display:none, natalo ang z-index, o tinakpan ng ibang fixed element; maaari ring putulin ng ibang JS error ang initialization. F12 → Elements, hanapin ang 美洽 container — naroon, natago, o nasa labas ng screen?; pansamantalang i-disable ang custom CSS / ibang scripts para muling subukan; suriin ang console para sa error na pumutol sa execution.
美洽 meiqia.js naharang ng adblock extension — paano aayusin?
Galing sa third-party domain ang 美洽 chat script; kung may naka-install na blocking extension, maaari nitong ituring na ad / tracker at pigilan ang pag-load — patayin ang blocking o i-whitelist. Ang ERR_BLOCKED_BY_CLIENT ay nangangahulugang hinarang ng browser extension (AdBlock / uBlock / AdGuard) ang request sa pamamagitan ng filter lists nito. Ang 美洽 script ay «third-party off-domain + realtime communication», na madalas ipinagkakamali ng mga panuntunang iyon na ad / tracker, na nagdudulot ng false failure na «maayos ang console, nawawala sa gilid ng user». Muling subukan sa incognito o nakapatay ang adblock — kung lumabas, ang blocking ang sanhi; hilingin sa mga user na i-whitelist ang site; maaaring i-load ng front end ang chat script nang delayed / conditional para iwasan ang ilang auto rules.
美洽 meiqia.js 404 / masamang status / mixed content — paano aayusin?
Pagkatapos i-deploy, hanapin ang meiqia.js sa Network panel; ang status 200 ay nangangahulugang tama ang placement at na-load ang script. Karaniwang sanhi ng hindi-200: code na hawak ng page / CDN cache (hindi na-refresh pagkatapos i-publish), na-load sa HTTP page / hindi kumpletong certificate chain na nagti-trigger ng mixed-content blocking, o sirang / bahagyang nakopyang code. Kapag nabigo ang hakbang na ito, hindi kailanman nangyayari ang injection at koneksyon. Linisin ang CDN / browser cache (o incognito) pagkatapos i-publish; tiyakin ang buong HTTPS na may buong certificate chain at walang mixed content; suriin na kumpleto at hindi naka-escape ang nakopyang code.
美洽 Maling lugar ng code (head blocking / walang bisa) — paano aayusin?
Inirerekomenda ng 美洽 na idikit ang code sa ibaba ng pahina, bago ang </body>; tumatakbo ang widget pagkatapos ma-load ang pangunahing nilalaman. Dapat i-inject ng widget ang container nito pagkatapos maging handa ang DOM. Sa <head> humaharang ito sa render (blangkong screen muna sa mahinang network) o tumatakbo bago handa ang DOM at nabibigo; sa ilang async / module scope maaari ring magkamali ang load order. Ilagay ang 美洽 JS sa karaniwang footer ng bawat pahina, bago ang </body>; para sa SPA tingnan ang entry na «SPA route» at gamitin ang manualInit; tiyaking hindi ito tinatanggal ng bundler sa pamamagitan ng tree-shaking.
美洽 Sirang styling ng chat window / button — paano aayusin?
Nag-iinject ang widget ng sariling mga style at umaangkop sa site; ang mga conflict sa site-wide styles ay maaaring magdulot ng visual glitches. Nag-iinject ang 美洽 script ng CSS sa runtime; kung ni-override muna ng site-wide styles (universal selectors / high-priority rules / resets) ang mga class nito, nasisira ang posisyon, stacking at fonts — side effect ng «dynamic injection + pagbabahagi ng iisang document style space». F12 para makita kung aling site rule ang nag-override sa 美洽 container; paliitin ang site-wide styles / bawasan ang epekto sa generic classes; kung kailangan hilingin sa 美洽 na i-adjust ang container layering.
美洽 Button nasa labas ng screen / natakpan — paano aayusin?
Lumalabas ang button ng widget bilang fixed-position float; kung natakpan ng ibang fixed elements, i-adjust ang stacking o posisyon. Ang ibang position:fixed na elemento ng site (back-to-top, floating ads, custom support bar) na may mas mataas na z-index ay tinatakpan ang 美洽 button, o mali ang pagkalkula ng theme sa coordinate nito, na iniiwan itong «labas ng screen / natakpan». Piliin ang 美洽 container sa F12 para makita ang totoong coordinate / z-index; itaas ito o ibaba ang z-index ng nakatakip na elemento; iwasang mag-stack ng maraming fixed float sa isang sulok.
美洽 DOM conflict ng third-party plugin / analytics — paano aayusin?
Ang ibang script sa pahina na nagbabago ng DOM o humaharang ng request ay maaaring makaapekto sa normal na pag-load at display ng widget. Muling isinusulat ng heatmap / analytics / conversion scripts ang DOM, nag-iinject ng overlay o humaharang ng request; dahil sila at ang 美洽 ay nag-iinject sa iisang dokumento, nag-iinterfere ang stacking / events at natatakpan ang 美洽 container o naputol ang init nito. I-disable ang mga kahina-hinalang plugin isa-isa para matukoy ang conflict; i-adjust ang load order / container layering; ipaiwas sa heatmaps atbp. ang lugar ng 美洽 container.
美洽 Nawawala ang widget pagkatapos ng SPA route change — paano aayusin?
Para sa single-page apps (SPA), gamitin ang route hooks ng framework para i-load / i-init ang 美洽 widget upang umangkop sa front-end routing. Nagpapalit ng view ang SPA sa pamamagitan ng front-end routing, sinisira / muling itinatayo ang DOM, pero nag-iinject ang meiqia.js nang isang beses sa unang load bilang default at hindi muling itinatayo nang kusa sa route change, kaya «magpalit ng pahina, nawala ang chat». Gamitin ang _MEIQIA('manualInit') para itigil ang auto-init at tawagin ang _MEIQIA('init') sa route hook (React useEffect / Vue mounted / router afterEach) para muling i-mount kung kailangan; iwasang mag-initialize ng maraming instance.
美洽 Kailangan ng manual init (manualInit / init) — paano aayusin?
Idagdag ang _MEIQIA('manualInit') pagkatapos ng embed code ng 美洽 para itigil ang auto-init pagkatapos ng download; tawagin ang _MEIQIA('init') para manu-manong i-init kung kailangan. Bilang default nag-i-init ang 美洽 kaagad pagkatapos ng download; kapag kailangan mo munang handa ang container / naipasa ang impormasyon ng customer / stable ang route, ang timing na iyon ay «masyadong maaga» — lumipat sa manual init para kontrolin ang pagkakasunod-sunod. Idagdag ang _MEIQIA('manualInit') pagkatapos ng code; tawagin ang _MEIQIA('init') kapag handa na ang mga kondisyon (DOM / session / route); tawagin ang info APIs ayon sa pagkakasunod sa loob ng init timing ayon sa doc.
Higit pang setup ng integration: web integration ng 美洽, APP SDK integration; para magsimula: gabay ng 美洽. May nasa-search na buong bersyon (kasama ang tool na ito) din sa integration troubleshooting ng 美洽 (GitHub Pages).