Heb je de 美洽(Meiqia)-code geplakt en verschijnt de webchatwidget niet, komt de chatknop nooit op, meldt de console meiqia.js geblokkeerd, of krijgen agents geen chats? Verhelder eerst drie dingen: is het script helemaal niet geladen (plaatsing / adblock / cache), wél geladen maar verborgen door styling / stapeling, of goed geladen maar de config klopt niet (entId / domein / SPA-levenscyclus)? Zoek het symptoom of trefwoord (bijv. not showing, adblock, entId, SPA, mobile, sdk push): eerst het L1-gedrag & de officiële positionering, dan de L2-grondoorzaak & oplossing. Installatie / gids? Zie 美洽 download / integratiegids klantenservice.
Stap 1: controleer of het script is geladen en verdeel dan in vier groepen
Wanneer de 美洽-chat niet verschijnt, is het 9 van de 10 keer één van vier groepen; kijk eerst of het script überhaupt is geladen: F12 → Network, zoek meiqia.js; geen verzoek of een status anders dan 200 betekent niet geladen. ① Laadfout: code op de verkeerde plek (hoort vóór </body>, niet in <head>), geblokkeerd door een adblock-regel (ERR_BLOCKED_BY_CLIENT), vastgehouden door CDN- / browsercache, of HTTPS-certificaat / gemengde inhoud. ② Config / autorisatie: entId komt niet overeen met de workbench (laadt maar agents krijgen geen chats), of het sitedomein is niet geautoriseerd in de console. ③ Framework-integratie: een Vue/React/Next-SPA vernietigt de container bij een routewissel en de widget wordt niet herbouwd. ④ Weergave / mobiel / SDK: de site-CSS duwt de bubbel buiten beeld, een plugin van derden overlapt het DOM, mobiel heeft een eigen deploy nodig, in-app heeft de SDK nodig. Vollediger: 美洽 webintegratiegids.
Laadfoutplaatsing · adblock · cache · HTTPS
Plak de 美洽-JS vóór
(niet in ); F12 → Network, zoek meiqia.js en controleer de status (moet 200 zijn); ERR_BLOCKED_BY_CLIENT betekent meestal een adblock-extensie — test in incognito of whitelist; wis de CDN-cache na publicatie; zorg voor volledig HTTPS zonder gemengde inhoud.
entId is de unieke id van je bedrijf; bij verschil met de workbench «laadt het script maar agents krijgen geen chats» (Instellingen - Team - ID-opzoeken); het sitedomein moet geautoriseerd via «Integratiesite toevoegen»; gebruik per business line een eigen subkanaal (probe).
Een Vue/React/Next-SPA vernietigt het DOM bij een routewissel en de widget wordt niet herbouwd; gebruik _MEIQIA('manualInit') om auto-init te stoppen en roep _MEIQIA('init') aan in een route-hook (useEffect / mounted) om hem opnieuw te mounten.
Weergaveproblemenstijlconflict · stapeling · plugins van derden
Geladen maar onzichtbaar: meestal overschrijft de site-brede CSS de bubbelpositie, of een heatmap- / analytics- / SEO-plugin bewerkt het DOM en bedekt de container; F12 → Elements, zoek de meiqia-container en controleer display:none, verloren z-index of coördinaten buiten beeld.
Mobiel / SDKmobiel web · AppKey · push
Mobiel / pc-web is dezelfde snippet maar vereist een eigen deploy; in-app gebruikt de native SDK (eerst «APP-config toevoegen» in de console voor een AppKey); push splitst in «geen push» (alleen in-app) en «eigen push-server» (geleverd zelfs na het verlaten van de app).
Eigen knop? _MEIQIA('withoutBtn') verbergt de native knop, en roep _MEIQIA('showPanel') aan bij klik om de chat te openen; geef / synchroniseer klantgegevens binnen de init-timing, anders heeft het geen effect.
Fig 1: triage van 美洽 verschijnt niet — controleer het laden van het script (meiqia.js in F12), dan laden / config / framework / weergave
Stap 2: de meest over het hoofd geziene grondoorzaak → L2 (de widget = asynchrone JS-injectie van derden buiten het domein)
Eén idee volstaat: de 美洽-webwidget is geen statisch component ingebed in je pagina — het is een meiqia.js die asynchroon vanaf het externe domein van 美洽 wordt geladen en vervolgens dynamisch een chatcontainer (DOM / iframe) injecteert en een langlevende cross-origin verbinding opent naar de servers van 美洽. Dat verklaart de meeste «mysterieuze verdwijningen»: ① het is een script van derden buiten het domein, dus AdBlock / uBlock blokkeren het via hun «tracking / advertenties»-lijsten (ERR_BLOCKED_BY_CLIENT) en de knop komt nooit op (terwijl de console er goed uitziet); ② het injecteert het DOM asynchroon: in <head> blokkeert het, een SPA-routewissel vernietigt de container en hij wordt niet vanzelf herbouwd (gebruik manualInit + _MEIQIA('init')), en heatmap- / analytics-plugins die het DOM bewerken kunnen hem bedekken; ③ het bindt aan je bedrijf via entId en wordt gegate door een domein-whitelist: bij een verkeerd entId of niet-geautoriseerd domein laadt het script maar «verbindt geen chat»; ④ mobiel en pc zijn twee aparte integraties, in-app is de SDK (AppKey), en push splitst in «geen push» vs «eigen push-server». Zodra je deze injectieketen ziet, heeft elk symptoom hieronder één logica. Hieronder het zelfcontrolepaneel; verderop de vijf methoden en 2026-schattingen.
Fig 2: 美洽-integratie-zelfcontrolepaneel (groen = bevestigd / rood = makkelijk gemist)Fig: controleer eerst «codeplaatsing + meiqia.js 200 + geïnitialiseerd», dan «adblock + framework/stapeling» — de laatste twee worden het meest gemist
美洽 oorzaken van niet verschijnen & vergelijking van integratiemethoden (schatting 2026)
Het volgende zijn 2026-schattingen gesynthetiseerd uit de officiële 美洽-help (Toegangskanalen / JavaScript-webwidget-API) en openbare integratie-troubleshooting (geen toezeggingen van de leverancier of eerstehands meting; ter referentie, verandert per versie en browserbeleid):
Dimensie
Schatting / vergelijking
Verdeling van oorzaken van niet verschijnen (community / tickets · schat.)
de webwidget = asynchrone JS van derden buiten het domein die het DOM injecteert + een langlevende cross-origin verbinding (geen ingebed statisch component); vandaar de invloed van plaatsing, adblock-regels, CSS-stapeling, SPA-levenscyclus
ongeveer 30-40% van de pc-gebruikers gebruikt een adblock-extensie → het chatscript van derden wordt door advertentieregels geblokkeerd (ERR_BLOCKED_BY_CLIENT), een hoofdoorzaak van «console ok, gebruikerskant ontbreekt»
Live-tijd van de JS-widget (officieel)
plak de dedicated JS onderaan de pagina en hij gaat in ongeveer 3-5 minuten live; entId is de unieke bedrijfs-id, en een verschil met de workbench laat agents zonder chats
Schattingsbasis: bronbasislijn + tijdsextrapolatie (meiqia.com/help Toegangskanalen / JavaScript-webwidget, meiqia.im-integratiegids, openbare troubleshooting, 2026); verandert per versie en browserblokkeerbeleid. Volg de nieuwste officiële 美洽-info. Niet-officieel · LLM-lokalisatie.
Echte gevallen — snel lezen
Code geplakt maar geen chatbubbel: eerst F12 → Network, zoek meiqia.js — geen verzoek of niet-200 betekent verkeerd geplaatst / door cache vastgehouden; wis de CDN-cache of heropen in incognito.
Console zegt meiqia.js net::ERR_BLOCKED_BY_CLIENT: een adblocker (AdBlock / uBlock / AdGuard) blokkeerde het chatscript van derden via zijn advertentieregels — schakel de extensie uit of whitelist de site; daarom «ontbreekt het voor sommige gebruikers terwijl jouw console er goed uitziet».
Script geladen (console typeof _MEIQIA is function) maar geen knop: meestal duwde een thema-CSS de bubbel buiten beeld of veranderde een heatmap- / analytics-plugin de DOM-stapeling — F12 → Elements, zoek de 美洽-container en controleer item voor item.
De homepagina heeft chat in een Vue / React-SPA, maar een tweede route niet: de SPA-routewissel vernietigde de container en de widget werd niet herbouwd — gebruik manualInit om auto-init te stoppen en roep _MEIQIA('init') aan in de route-hook om opnieuw te mounten.
De chat opent maar agents krijgen geen bezoekersberichten: hoogstwaarschijnlijk komt het entId niet overeen met de workbench (andermans snippet gekopieerd / accounts door elkaar) — vergelijk de bedrijfs-ID in Instellingen - Team - ID-opzoeken met het entId in de code.
Werkt op staging, laadt niet op het productiedomein: het productiedomein is niet geautoriseerd via «Integratiesite toevoegen» — voeg het live domein toe aan de lijst en publiceer opnieuw.
Je wilt de ronde native 美洽-knop weghalen en je eigen «Contact»-knop gebruiken: roep _MEIQIA('withoutBtn') aan om de native te verbergen, koppel daarna _MEIQIA('showPanel') aan je knop om de chat te openen.
