Question 1

美洽 La fenêtre / bulle de chat ne s'affiche pas du tout — comment résoudre ?

Accepted Answer

Le widget web 美洽 charge une fenêtre de chat flottante avec un seul snippet JS collé ; confirmez que le code est bien intégré et le site d'intégration configuré dans la console. Le widget est meiqia.js injecté dans le DOM après un chargement asynchrone, donc « rien du tout » signifie souvent « le script n'a jamais chargé » : mauvais emplacement, bloqué par adblock / cache, ou domaine / entId incohérents, donc l'injection n'a jamais eu lieu. F12 → Network, cherchez meiqia.js : pas de requête → code sans effet (vérifiez l'emplacement / videz le cache) ; requête mais non-200 → bloqué ou problème de chemin ; tout est bon mais toujours masqué → vérifiez entId / autorisation de domaine et les groupes ci-dessous.

Question 2

美洽 Script chargé mais bouton de chat manquant — comment résoudre ?

Accepted Answer

Le code du widget s'adapte au site et affiche un bouton de chat ; si l'affichage échoue, vérifiez s'il est masqué par des styles ou si l'initialisation a été interrompue. Si le script charge mais le bouton manque, c'est souvent un problème de « couche d'affichage » : le CSS global écrase la position du bouton / met display:none, le z-index perd, ou un autre élément fixe le recouvre ; une autre erreur JS peut aussi interrompre l'initialisation. F12 → Elements, trouvez le conteneur 美洽 — présent, masqué ou hors écran ?; désactivez temporairement le CSS / autres scripts perso pour retester ; vérifiez la console pour une erreur ayant interrompu l'exécution.

Question 3

美洽 meiqia.js bloqué par une extension d'adblock — comment résoudre ?

Accepted Answer

Le script de chat 美洽 vient d'un domaine tiers ; si une extension de blocage est installée, elle peut le traiter comme pub / traqueur et empêcher le chargement — désactivez le blocage ou ajoutez à la liste blanche. ERR_BLOCKED_BY_CLIENT signifie qu'une extension de navigateur (AdBlock / uBlock / AdGuard) a bloqué la requête via ses listes de filtres. Le script 美洽 est « tiers hors domaine + communication temps réel », que ces règles confondent souvent avec pub / traqueur, causant un faux échec « console correcte, côté utilisateur absent ». Retestez en navigation privée ou avec l'adblock désactivé — s'il apparaît, le blocage était la cause ; demandez aux utilisateurs d'ajouter le site à la liste blanche ; le frontend peut charger le script en différé / conditionnellement pour contourner certaines règles auto.

Question 4

美洽 meiqia.js 404 / mauvais statut / contenu mixte — comment résoudre ?

Accepted Answer

Après déploiement, cherchez meiqia.js dans le panneau Network ; un statut 200 signifie que le script est bien placé et chargé. Causes courantes de non-200 : code retenu par le cache page / CDN (non rafraîchi après publication), chargement sur une page HTTP / chaîne de certificat incomplète déclenchant un blocage de contenu mixte, ou code cassé / partiellement copié. Si cette étape échoue, l'injection et la connexion n'ont jamais lieu. Videz le cache CDN / navigateur (ou navigation privée) après publication ; assurez un HTTPS complet avec chaîne de certificat intègre et sans contenu mixte ; vérifiez que le code copié est complet et non échappé.

Question 5

美洽 Code mal placé (blocage head / sans effet) — comment résoudre ?

Accepted Answer

美洽 recommande de coller le code en bas de page, avant ; le widget s'exécute après le chargement du contenu principal. Le widget doit injecter son conteneur après que le DOM est prêt. Dans il bloque le rendu (écran blanc d'abord sur réseau lent) ou s'exécute avant que le DOM soit prêt et échoue ; dans certains scopes async / module l'ordre de chargement peut aussi mal tourner. Placez le JS 美洽 dans le pied commun de chaque page, avant ; pour les SPA voir l'entrée « route SPA » et utilisez manualInit ; assurez-vous qu'un bundler ne l'élimine pas par tree-shaking.

Question 6

美洽 Style cassé de la fenêtre / bouton de chat — comment résoudre ?

Accepted Answer

Le widget injecte ses propres styles et s'adapte au site ; les conflits avec les styles globaux peuvent causer des anomalies visuelles. Le script 美洽 injecte du CSS à l'exécution ; si les styles globaux (sélecteurs universels / règles haute priorité / resets) écrasent ses classes en premier, la position, l'empilement et les polices cassent — un effet de bord de « injection dynamique + partage d'un même espace de style du document ». F12 pour voir quelle règle du site écrase le conteneur 美洽 ; restreignez les styles globaux / réduisez leur impact sur les classes génériques ; au besoin, demandez à 美洽 d'ajuster l'empilement du conteneur.

Question 7

美洽 Bouton hors écran / recouvert — comment résoudre ?

Accepted Answer

Le bouton du widget apparaît en flottant à position fixe ; s'il est recouvert par d'autres éléments fixes, ajustez l'empilement ou la position. D'autres éléments position:fixed du site (retour en haut, pub flottante, une barre de support perso) avec un z-index supérieur recouvrent le bouton 美洽, ou le thème calcule mal ses coordonnées, le laissant « hors écran / recouvert ». Sélectionnez le conteneur 美洽 dans F12 pour voir les coordonnées / z-index réels ; remontez-le ou baissez le z-index de l'élément qui recouvre ; évitez d'empiler plusieurs flottants fixes dans un coin.

Question 8

美洽 Conflit de DOM avec plugin / analytics tiers — comment résoudre ?

Accepted Answer

D'autres scripts de la page qui modifient le DOM ou interceptent des requêtes peuvent affecter le chargement et l'affichage normaux du widget. Les scripts de heatmap / analytics / conversion réécrivent le DOM, injectent des overlays ou interceptent des requêtes ; comme eux et 美洽 injectent dans le même document, l'empilement / les événements interfèrent et le conteneur 美洽 est recouvert ou son init interrompu. Désactivez les plugins suspects un par un pour localiser le conflit ; ajustez l'ordre de chargement / l'empilement du conteneur ; faites que les heatmaps évitent la zone du conteneur 美洽.

Méthode d'intégration	Code / difficulté	Fonctions complètes	Idéal pour	Délai de mise en ligne
Widget JS web	un snippet JS · faible	le plus complet (flottant / popup / accueil auto / parcours visiteur)	sites PC + mobile (recommandé officiel)	~3-5 min
Lien de chat	sans code · minimal	chat basique	sans technique / poser un lien de chat rapide	instantané
API / SDK WebIM	nécessite dev · élevé	personnalisation poussée (UI perso / système / intégration commandes)	équipes avec capacité dev pour fusion poussée	selon dev
SDK natif d'app	intégrer SDK · élevé	chat in-app + push de messages	apps iOS / Android	selon dev
Config rapide CMS	plugin / un clic · faible	comme le widget JS	sites WordPress / Fkw / Shopify	minutes

Dimension	Estimation / comparaison
Répartition des causes de non-affichage (communauté / tickets · est.)	emplacement / non chargé ~35% > adblock / extension navigateur ~25% > config / autorisation (entId / domaine) ~20% > framework (SPA) ~12% > conflit de style / plugin tiers ~8%
Ce qu'est vraiment l'intégration	le widget web = JS asynchrone tiers hors domaine qui injecte le DOM + une connexion persistante cross-origin (pas un composant statique intégré) ; d'où l'effet de l'emplacement, des règles d'adblock, de l'empilement CSS, du cycle de vie SPA
Intégration par plateforme (est.)	web PC / mobile = widget JS (même code, déployé à part) ; app = SDK natif (AppKey) ; WeChat / Douyin / RED = intégration autorisée par canal
Impact de l'adblock (est.)	environ 30-40% des utilisateurs PC utilisent une extension d'adblock → le script de chat tiers est bloqué par les règles pub (ERR_BLOCKED_BY_CLIENT), cause principale de « console correcte, côté utilisateur absent »
Délai de mise en ligne du widget JS (officiel)	collez le JS dédié en bas de page et il est en ligne en environ 3-5 minutes ; entId est l'id unique de l'entreprise, et un écart avec le backoffice laisse les agents sans chats

美洽 widget de chat ne s'affiche pas / corriger l'erreur d'intégration

Étape 1 : vérifiez si le script a chargé, puis répartissez en quatre groupes

Étape 2 : la cause racine la plus oubliée → L2 (le widget = injection JS asynchrone tierce hors domaine)

Tableau complet des symptômes (comportement / positionnement officiel · cause racine L2)

Cinq méthodes d'intégration 美洽 comparées (code / difficulté / fonctions / scénario / délai de mise en ligne · doc officielle)

美洽 causes de non-affichage & comparatif des méthodes d'intégration (estimation 2026)

Cas réels — lecture rapide