Hình: 美洽 chat không hiển thị / sửa lỗi (hành vi L1 + nguyên nhân gốc L2 + năm phương thức tích hợp)
Đã dán mã 美洽(Meiqia) mà widget chat web không hiển thị, nút chat không bao giờ hiện, console báo meiqia.js bị chặn, hay nhân viên không nhận chat? Làm rõ ba điều trước: script hoàn toàn chưa tải (vị trí / adblock / cache), đã tải nhưng bị che bởi kiểu / xếp chồng, hay tải tốt nhưng cấu hình không khớp (entId / miền / vòng đời SPA)? Tra triệu chứng hoặc từ khóa (vd. not showing, adblock, entId, SPA, mobile, sdk push): trước là hành vi L1 & định vị chính thức, rồi nguyên nhân gốc L2 & cách sửa. Cài đặt / hướng dẫn? Xem tải 美洽 / hướng dẫn tích hợp CSKH.
Bước 1: kiểm tra script đã tải chưa, rồi chia bốn nhóm
Khi chat 美洽 không hiển thị, 9/10 lần là một trong bốn nhóm; trước hết xem script có tải hay không: F12 → Network, tìm meiqia.js; không có request hoặc trạng thái khác 200 nghĩa là chưa tải. ① Tải lỗi: mã sai vị trí (phải trước </body>, không phải trong <head>), bị quy tắc adblock chặn (ERR_BLOCKED_BY_CLIENT), bị cache CDN / trình duyệt giữ, hoặc chứng chỉ HTTPS / nội dung hỗn hợp. ② Cấu hình / cấp phép: entId không khớp workbench (tải nhưng nhân viên không nhận chat), hoặc miền chưa được cấp phép trong console. ③ Tích hợp framework: SPA Vue/React/Next hủy container khi đổi route và widget không được dựng lại. ④ Hiển thị / di động / SDK: CSS site đẩy bong bóng ra ngoài màn hình, plugin bên thứ ba phủ DOM, di động cần deploy riêng, in-app cần SDK. Đầy đủ hơn: hướng dẫn tích hợp web 美洽.
Tải lỗivị trí · adblock · cache · HTTPS
Dán JS 美洽 trước
(không phải trong ); F12 → Network, tìm meiqia.js và kiểm tra trạng thái (phải 200); ERR_BLOCKED_BY_CLIENT thường là tiện ích adblock — thử ở chế độ ẩn danh hoặc whitelist; xóa cache CDN sau khi xuất bản; đảm bảo HTTPS đầy đủ không nội dung hỗn hợp.
Cấu hình / cấp phépentId · danh sách trắng miền · kênh con
entId là id duy nhất của công ty bạn; không khớp workbench thì «script tải nhưng nhân viên không nhận chat» (Cài đặt - Nhóm - tra ID); miền site phải được cấp phép qua «Thêm trang tích hợp»; dùng kênh con (probe) riêng mỗi mảng kinh doanh.
Tích hợp frameworkSPA · đổi route · manualInit
SPA Vue/React/Next hủy DOM khi đổi route và widget không tự dựng lại; dùng _MEIQIA('manualInit') để dừng auto-init và gọi _MEIQIA('init') trong hook route (useEffect / mounted) để gắn lại.
Lỗi hiển thịxung đột kiểu · xếp chồng · plugin bên thứ ba
Đã tải nhưng vô hình: thường CSS toàn site ghi đè vị trí bong bóng, hoặc plugin heatmap / phân tích / SEO sửa DOM và phủ container; F12 → Elements, tìm container meiqia và kiểm tra display:none, z-index thua, hay tọa độ ngoài màn hình.
Di động / SDKweb di động · AppKey · push
Web di động / PC cùng snippet nhưng cần deploy riêng; in-app dùng SDK gốc (trước hết «Thêm cấu hình APP» trong console để lấy AppKey); push chia «không push» (chỉ in-app) và «máy chủ push tùy chỉnh» (nhận cả khi đã thoát app).
Gọi APIwithoutBtn · showPanel · thông tin khách
Nút riêng? _MEIQIA('withoutBtn') ẩn nút gốc, và gọi _MEIQIA('showPanel') khi nhấp để mở chat; truyền / đồng bộ thông tin khách trong thời gian init, nếu không sẽ không có hiệu lực.
Hình 1: phân loại 美洽 không hiển thị — kiểm tra tải script (meiqia.js trong F12), rồi tải / cấu hình / framework / hiển thị
Bước 2: nguyên nhân gốc bị bỏ sót nhiều nhất → L2 (widget = chèn JS bất đồng bộ bên thứ ba ngoài miền)
Một ý là đủ: widget web 美洽 không phải thành phần tĩnh nhúng trong trang của bạn — nó là meiqia.js được tải bất đồng bộ từ miền ngoài của 美洽 rồi chèn động một container chat (DOM / iframe) và mở kết nối lâu dài xuyên nguồn tới máy chủ 美洽. Điều này giải thích phần lớn «biến mất bí ẩn»: ① nó là script bên thứ ba ngoài miền, nên AdBlock / uBlock chặn theo danh sách «theo dõi / quảng cáo» (ERR_BLOCKED_BY_CLIENT) và nút không bao giờ hiện (dù console trông ổn); ② nó chèn DOM bất đồng bộ: trong <head> nó chặn render, đổi route SPA hủy container và không tự dựng lại (dùng manualInit + _MEIQIA('init')), và plugin heatmap / phân tích sửa DOM có thể phủ lên; ③ nó gắn vào công ty bạn qua entId và bị kiểm soát bởi danh sách trắng miền: entId sai hoặc miền chưa cấp phép thì script tải nhưng «không nối được chat»; ④ di động và PC là hai tích hợp riêng, in-app là SDK (AppKey), và push chia «không push» vs «máy chủ push tùy chỉnh». Khi đã thấy chuỗi chèn này, mỗi triệu chứng dưới đây có một logic chung. Dưới là bảng tự kiểm; xa hơn là năm phương thức và ước tính 2026.
Hình 2: bảng tự kiểm tích hợp 美洽 (xanh = đã xác nhận / đỏ = dễ bỏ sót)Hình: kiểm tra «vị trí mã + meiqia.js 200 + đã khởi tạo» trước, rồi «adblock + framework/xếp chồng» — hai cái sau dễ bỏ sót nhất
Bảng triệu chứng đầy đủ (hành vi / định vị chính thức · nguyên nhân gốc L2)
So sánh năm phương thức tích hợp 美洽 (mã / độ khó / tính năng / kịch bản / thời gian lên · tài liệu chính thức)
Phương thức tích hợp
Mã / độ khó
Đầy đủ tính năng
Phù hợp
Thời gian lên
Widget JS web
một snippet JS · thấp
đầy nhất (nổi / popup / chào tự động / dấu vết khách)
site PC + di động (khuyến nghị chính thức)
~3-5 phút
Link chat
không mã · tối thiểu
chat cơ bản
không kỹ thuật / đặt nhanh link chat
tức thì
API / SDK WebIM
cần dev · cao
tùy biến sâu (UI riêng / hệ thống / tích hợp đơn)
nhóm có năng lực dev cho hợp nhất sâu
tùy dev
SDK gốc app
tích hợp SDK · cao
chat in-app + push tin
app iOS / Android
tùy dev
Cấu hình nhanh CMS
plugin / một nhấp · thấp
như widget JS
site WordPress / Fkw / Shopify
vài phút
美洽 nguyên nhân không hiển thị & so sánh phương thức tích hợp (ước tính 2026)
Dưới đây là ước tính 2026 tổng hợp từ trợ giúp chính thức 美洽 (Kênh tiếp cận / API widget web JavaScript) và khắc phục sự cố tích hợp công khai (không phải cam kết của nhà cung cấp hay đo trực tiếp; để tham khảo, thay đổi theo phiên bản và chính sách trình duyệt):
Chiều
Ước tính / so sánh
Phân bố nguyên nhân không hiển thị (cộng đồng / ticket · ước.)
vị trí / chưa tải ~35% > adblock / tiện ích trình duyệt ~25% > cấu hình / cấp phép (entId / miền) ~20% > framework (SPA) ~12% > xung đột kiểu / plugin bên thứ ba ~8%
Tích hợp thực chất là gì
widget web = JS bất đồng bộ bên thứ ba ngoài miền chèn DOM + kết nối xuyên nguồn lâu dài (không phải thành phần tĩnh nhúng); do đó chịu ảnh hưởng vị trí, quy tắc adblock, xếp chồng CSS, vòng đời SPA
Tích hợp theo nền tảng (ước.)
web PC / di động = widget JS (cùng mã, deploy riêng); app = SDK gốc (AppKey); WeChat / Douyin / RED = tích hợp được cấp phép kênh
Tác động adblock (ước.)
khoảng 30-40% người dùng PC dùng tiện ích adblock → script chat bên thứ ba bị chặn theo quy tắc quảng cáo (ERR_BLOCKED_BY_CLIENT), nguyên nhân chính của «console ổn, phía người dùng mất»
Thời gian lên của widget JS (chính thức)
dán JS riêng ở cuối trang và lên trong khoảng 3-5 phút; entId là id duy nhất của công ty, và không khớp workbench khiến nhân viên không có chat
Cơ sở ước tính: nền nguồn + ngoại suy thời gian (meiqia.com/help Kênh tiếp cận / widget web JavaScript, hướng dẫn tích hợp meiqia.im, khắc phục sự cố công khai, 2026); thay đổi theo phiên bản và chính sách chặn của trình duyệt. Hãy theo info chính thức mới nhất của 美洽. Không chính thức · bản địa hóa LLM.
Tình huống thực — đọc nhanh
Dán mã nhưng không có bong bóng chat: trước hết F12 → Network, tìm meiqia.js — không có request hoặc khác 200 nghĩa là sai vị trí / bị cache giữ; xóa cache CDN hoặc mở lại ở ẩn danh.
Console báo meiqia.js net::ERR_BLOCKED_BY_CLIENT: adblock (AdBlock / uBlock / AdGuard) chặn script chat bên thứ ba theo quy tắc quảng cáo — tắt tiện ích hoặc whitelist site; đây cũng là lý do «mất với một số người dùng trong khi console bạn vẫn ổn».
Script đã tải (console typeof _MEIQIA là function) nhưng không có nút: thường CSS theme đẩy bong bóng ra ngoài màn hình hoặc plugin heatmap / phân tích đổi xếp chồng DOM — F12 → Elements, tìm container 美洽 và kiểm tra từng mục.
Trang chủ có chat trong SPA Vue / React, nhưng route thứ hai thì không: đổi route SPA hủy container và widget không được dựng lại — dùng manualInit để dừng auto-init và gọi _MEIQIA('init') trong hook route để gắn lại.
Chat mở được nhưng nhân viên không nhận tin của khách: nhiều khả năng entId không khớp workbench (sao chép snippet người khác / lẫn tài khoản) — đối chiếu ID công ty ở Cài đặt - Nhóm - tra ID với entId trong mã.
Chạy ở staging, không tải trên miền sản xuất: miền sản xuất chưa được cấp phép qua «Thêm trang tích hợp» — thêm miền live vào danh sách rồi xuất bản lại.
Muốn bỏ nút tròn gốc của 美洽 và dùng nút «Liên hệ» riêng: gọi _MEIQIA('withoutBtn') để ẩn nút gốc, rồi gắn _MEIQIA('showPanel') vào nút của bạn để mở chat.
