美洽 widget de chat no aparece / corregir error de integración
Fig: 美洽 chat no aparece / corrección de errores (comportamiento L1 + causa raíz L2 + cinco métodos de integración)
¿Pegaste el código de 美洽(Meiqia) y el widget de chat web no aparece, el botón de chat nunca sale, la consola dice que meiqia.js está bloqueado, o los agentes no reciben chats? Aclara tres cosas primero: ¿el script no cargó (ubicación / adblock / caché), cargó pero quedó oculto por estilos / apilamiento, o cargó bien pero la configuración no coincide (entId / dominio / ciclo de vida SPA)? Busca el síntoma o palabra clave (p. ej. not showing, adblock, entId, SPA, mobile, sdk push): primero el comportamiento L1 y la ubicación oficial, luego la causa raíz L2 y la solución. ¿Instalación / guía? Ve a descarga de 美洽 / guía de integración de atención al cliente.
Paso 1: comprueba si el script cargó y luego divide en cuatro grupos
Cuando el chat de 美洽 no aparece, 9 de cada 10 veces es uno de cuatro grupos; primero mira si el script siquiera cargó: F12 → Network, busca meiqia.js; sin petición o estado distinto de 200 significa que no cargó. ① Fallo de carga: código en el lugar equivocado (va antes de </body>, no en <head>), bloqueado por una regla de adblock (ERR_BLOCKED_BY_CLIENT), retenido por caché CDN / navegador, o certificado HTTPS / contenido mixto. ② Configuración / autorización: entId no coincide con el panel (carga pero los agentes no reciben chats), o el dominio no autorizado en la consola. ③ Integración de framework: una SPA Vue/React/Next destruye el contenedor al cambiar de ruta y el widget no se recrea. ④ Visualización / móvil / SDK: el CSS del sitio empuja la burbuja fuera de pantalla, un plugin externo superpone el DOM, móvil necesita su propio despliegue, in-app necesita el SDK. Guía completa: guía de integración web de 美洽.
Fallo de cargaubicación · adblock · caché · HTTPS
Pega el JS de 美洽 antes de
(no en ); F12 → Network, busca meiqia.js y revisa el estado (debe ser 200); ERR_BLOCKED_BY_CLIENT suele ser una extensión de adblock — prueba en incógnito o añade a lista blanca; limpia la caché CDN tras publicar; asegura HTTPS completo sin contenido mixto.
Configuración / autorizaciónentId · lista blanca de dominio · subcanales
entId es el id único de tu empresa; si no coincide con el panel «el script carga pero los agentes no reciben chats» (Ajustes - Equipo - búsqueda de ID); el dominio debe autorizarse vía «Añadir sitio de integración»; usa un subcanal (sonda) por línea de negocio.
Integración de frameworkSPA · cambio de ruta · manualInit
Una SPA Vue/React/Next destruye el DOM al cambiar de ruta y el widget no se recrea; usa _MEIQIA('manualInit') para detener el auto-init y llama _MEIQIA('init') en un hook de ruta (useEffect / mounted) para remontarlo.
Problemas de visualizaciónconflicto de estilo · apilamiento · plugins de terceros
Cargado pero invisible: normalmente el CSS global del sitio anula la posición de la burbuja, o un plugin de mapa de calor / analítica / SEO edita el DOM y tapa el contenedor; F12 → Elements, busca el contenedor meiqia y revisa display:none, z-index perdido o coordenadas fuera de pantalla.
Móvil / SDKweb móvil · AppKey · push
La web móvil / PC es el mismo snippet pero necesita su propio despliegue; in-app usa el SDK nativo (primero «Añadir config APP» en la consola para un AppKey); el push se divide en «sin push» (solo in-app) y «servidor de push propio» (entrega incluso tras salir de la app).
Llamadas a la APIwithoutBtn · showPanel · datos del cliente
¿Tu propio botón? _MEIQIA('withoutBtn') oculta el botón nativo, y llama _MEIQIA('showPanel') al hacer clic para abrir el chat; pasa / sincroniza datos del cliente dentro del tiempo de init, o no surte efecto.
Fig 1: triaje de 美洽 no aparece — comprueba la carga del script (meiqia.js en F12), luego carga / config / framework / visualización
Paso 2: la causa raíz más ignorada → L2 (el widget = inyección JS asíncrona de terceros fuera de dominio)
Basta una idea: el widget web de 美洽 no es un componente estático incrustado en tu página: es un meiqia.js cargado de forma asíncrona desde el dominio externo de 美洽 que luego inyecta dinámicamente un contenedor de chat (DOM / iframe) y abre una conexión persistente de origen cruzado con los servidores de 美洽. Eso explica la mayoría de las «desapariciones misteriosas»: ① es un script de terceros fuera de dominio, así que AdBlock / uBlock lo bloquean por sus listas de «rastreo / anuncios» (ERR_BLOCKED_BY_CLIENT) y el botón nunca sale (aunque la consola parezca bien); ② inyecta el DOM de forma asíncrona: en <head> bloquea, un cambio de ruta SPA destruye el contenedor y no se recrea solo (usa manualInit + _MEIQIA('init')), y plugins de mapas de calor / analítica que editan el DOM pueden taparlo; ③ se vincula a tu empresa por entId y se controla por lista blanca de dominios: con un entId erróneo o dominio no autorizado el script carga pero «no conecta un chat»; ④ móvil y PC son dos integraciones distintas, in-app es el SDK (AppKey), y el push se divide en «sin push» vs «servidor de push propio». Una vez ves esta cadena de inyección, cada síntoma de abajo tiene una sola lógica. Abajo el panel de autochequeo; más abajo los cinco métodos y las estimaciones 2026.
Fig 2: panel de autochequeo de integración de 美洽 (verde = confirmado / rojo = se ignora fácil)Fig: comprueba «ubicación del código + meiqia.js 200 + inicializado» primero, luego «adblock + framework/apilamiento» — los dos últimos se ignoran más
Tabla completa de síntomas (comportamiento / ubicación oficial · causa raíz L2)
Cinco métodos de integración de 美洽 comparados (código / dificultad / funciones / escenario / tiempo a producción · doc oficial)
Método de integración
Código / dificultad
Funciones completas
Mejor para
Tiempo a producción
Widget JS web
un snippet JS · bajo
lo más completo (flotante / popup / saludo automático / rastro de visitante)
sitios PC + móvil (recomendado oficial)
~3-5 min
Enlace de chat
sin código · mínimo
chat básico
sin técnica / soltar un enlace de chat rápido
instantáneo
API / SDK WebIM
requiere dev · alto
personalización profunda (UI propia / sistema / integración de pedidos)
equipos con capacidad dev para fusión profunda
según dev
SDK nativo de app
integrar SDK · alto
chat in-app + push de mensajes
apps iOS / Android
según dev
Config rápida CMS
plugin / un clic · bajo
igual que el widget JS
sitios WordPress / Fkw / Shopify
minutos
美洽 causas de no aparecer & comparativa de métodos de integración (estimación 2026)
Las siguientes son estimaciones 2026 sintetizadas de la ayuda oficial de 美洽 (Canales de acceso / API del widget web JavaScript) y del troubleshooting público de integración (no son compromisos del proveedor ni medición de primera mano; de referencia, cambian por versión y política del navegador):
Dimensión
Estimación / comparación
Reparto de causas de no aparecer (comunidad / tickets · est.)
ubicación / no cargado ~35% > adblock / extensión del navegador ~25% > config / autorización (entId / dominio) ~20% > framework (SPA) ~12% > conflicto de estilo / plugin de terceros ~8%
Qué es realmente la integración
el widget web = JS asíncrono de terceros fuera de dominio que inyecta el DOM + una conexión persistente de origen cruzado (no un componente estático incrustado); de ahí el efecto de ubicación, reglas de adblock, apilamiento CSS, ciclo de vida SPA
Integración por plataforma (est.)
web PC / móvil = widget JS (mismo código, desplegado aparte); app = SDK nativo (AppKey); WeChat / Douyin / RED = integración autorizada por canal
Impacto del adblock (est.)
cerca del 30-40% de usuarios PC usan una extensión de adblock → el script de chat de terceros se bloquea por reglas de anuncios (ERR_BLOCKED_BY_CLIENT), causa principal de «consola bien, lado del usuario ausente»
Tiempo a producción del widget JS (oficial)
pega el JS dedicado al final de la página y entra en producción en unos 3-5 minutos; entId es el id único de la empresa, y un desajuste con el panel deja a los agentes sin chats
Base de la estimación: línea base de fuentes + extrapolación temporal (meiqia.com/help Canales de acceso / widget web JavaScript, guía de integración meiqia.im, troubleshooting público, 2026); cambia con la versión y la política de bloqueo del navegador. Sigue la info oficial más reciente de 美洽. No oficial · localización LLM.
Casos reales — lectura rápida
Código pegado pero sin burbuja de chat: primero F12 → Network, busca meiqia.js — sin petición o no-200 significa mal ubicado / retenido por caché; limpia la caché CDN o reabre en incógnito.
La consola dice meiqia.js net::ERR_BLOCKED_BY_CLIENT: un adblock (AdBlock / uBlock / AdGuard) bloqueó el script de chat de terceros por sus reglas — desactiva la extensión o añade el sitio a lista blanca; por eso «falta para algunos usuarios mientras tu consola se ve bien».
Script cargado (consola typeof _MEIQIA es function) pero sin botón: normalmente un CSS de tema empujó la burbuja fuera de pantalla o un plugin de mapa de calor / analítica cambió el apilamiento del DOM — F12 → Elements, busca el contenedor de 美洽 y revisa ítem por ítem.
La página de inicio tiene chat en una SPA Vue / React, pero una segunda ruta no: el cambio de ruta SPA destruyó el contenedor y el widget no se recreó — usa manualInit para detener el auto-init y llama _MEIQIA('init') en el hook de ruta para remontar.
El chat abre pero los agentes no reciben mensajes de visitantes: lo más probable es que el entId no coincida con el panel (copiaste un snippet ajeno / mezclaste cuentas) — compara el ID de empresa en Ajustes - Equipo - búsqueda de ID con el entId del código.
Funciona en staging, no carga en el dominio de producción: el dominio de producción no se autorizó vía «Añadir sitio de integración» — añade el dominio en producción a la lista y vuelve a publicar.
Quieres quitar el botón redondo nativo de 美洽 y usar tu propio botón «Contactar»: llama _MEIQIA('withoutBtn') para ocultar el nativo, luego enlaza _MEIQIA('showPanel') a tu botón para abrir el chat.
