Bước 1: chia bốn nhóm (tải / cấu hình / framework / hiển thị)
Dù «chat không hiện» của bạn là gì, hãy thu hẹp trước về bốn nhóm — chỉ vậy đã tiết kiệm phần lớn vòng vo. Sơ đồ làm rõ quyết định: kiểm script có tải hay không (meiqia.js trong F12), rồi là cấu hình, framework hay vấn đề lớp hiển thị. Cơ bản xem hướng dẫn tích hợp web 美洽.
Tích hợp hoạt động ra sao: vì sao chèn JS này lỗi / bị chặn
Một câu là đủ: widget web 美洽 không phải thành phần tĩnh trong trang bạn — nó là meiqia.js tải bất đồng bộ từ miền ngoài của 美洽 chèn động container chat (DOM / iframe) và mở kết nối xuyên nguồn lâu dài. Để chèn thành công cần «script đã tải (vị trí tốt, không bị adblock), container không bị CSS / plugin khác che, entId và miền khớp, và gắn lại sau khi đổi route SPA». Sơ đồ dưới vẽ chuỗi này và bốn điểm chặn — vì thế cùng mã chạy ở site / framework này nhưng không ở khác.
Mã đặt đúng nhưng vẫn không hiện: chạy bảng tự kiểm tích hợp
Nếu vị trí, meiqia.js 200 và entId đều đã xác nhận mà vẫn không hiện, về cơ bản là «adblock» hoặc «framework / xếp chồng». Bảng dưới sắp theo mức quan trọng: xanh thường ổn, các mục đỏ (adblock, xếp chồng SPA / plugin bên thứ ba) là bẫy thường gặp. Kiểm từng mục khoanh vùng nhanh.
Bảng triệu chứng đầy đủ (hành vi / định vị chính thức · nguyên nhân gốc L2)
Bảng dưới liệt kê cùng lúc các triệu chứng không hiển thị / lỗi thường gặp, mỗi cái kèm định vị chính thức và nguyên nhân gốc L2. Ô tìm phía trên chạy bằng dữ liệu bảng này — tìm từ khóa bạn gặp.
| Triệu chứng | Nhóm | Hành vi L1 / định vị chính thức | Nguyên nhân gốc L2 |
|---|---|---|---|
| Cửa sổ / bong bóng chat hoàn toàn không hiển thị | Tải lỗi | Widget web 美洽 tải cửa sổ chat nổi bằng một snippet JS được dán; xác nhận mã đã nhúng đúng và trang tích hợp đã cấu hình trong console. | Widget là meiqia.js được chèn vào DOM sau khi tải bất đồng bộ, nên «không có gì» thường nghĩa là «script chưa từng tải»: sai vị trí, bị adblock / cache chặn, hoặc miền / entId không khớp, nên bước chèn không bao giờ chạy. |
| Script đã tải nhưng mất nút chat | Lỗi hiển thị | Mã widget tự thích ứng site và hiện nút chat; nếu hiển thị lỗi, kiểm xem có bị kiểu ẩn hay khởi tạo bị ngắt. | Nếu script tải nhưng mất nút, thường là vấn đề «lớp hiển thị»: CSS toàn site ghi đè vị trí nút / đặt display:none, z-index thua, hoặc phần tử cố định khác che; lỗi JS khác cũng có thể ngắt khởi tạo. |
| meiqia.js bị tiện ích adblock chặn | Tải lỗi | Script chat 美洽 đến từ miền bên thứ ba; nếu có tiện ích chặn cài đặt, nó có thể coi là quảng cáo / theo dõi và ngăn tải — tắt chặn hoặc whitelist. | ERR_BLOCKED_BY_CLIENT nghĩa là tiện ích trình duyệt (AdBlock / uBlock / AdGuard) chặn request theo danh sách lọc. Script 美洽 là «bên thứ ba ngoài miền + giao tiếp thời gian thực», thường bị quy tắc đó hiểu nhầm là quảng cáo / theo dõi, gây lỗi giả «console ổn, phía người dùng mất». |
| meiqia.js 404 / trạng thái xấu / nội dung hỗn hợp | Tải lỗi | Sau khi deploy, tìm meiqia.js trong bảng Network; trạng thái 200 nghĩa là script đặt đúng và đã tải. | Nguyên nhân khác-200 thường gặp: mã bị cache trang / CDN giữ (chưa làm mới sau xuất bản), tải trên trang HTTP / chuỗi chứng chỉ không đầy đủ kích hoạt chặn nội dung hỗn hợp, hoặc mã hỏng / sao chép thiếu. Bước này lỗi thì chèn và kết nối không bao giờ xảy ra. |
| Mã sai vị trí (chặn head / không hiệu lực) | Tải lỗi | 美洽 khuyến nghị dán mã ở cuối trang, trước </body>; widget chạy sau khi nội dung chính tải xong. | Widget phải chèn container sau khi DOM sẵn sàng. Trong <head> nó chặn render (màn hình trắng trước trên mạng yếu) hoặc chạy trước khi DOM sẵn sàng và chèn lỗi; trong một số scope async / module thứ tự tải cũng có thể sai. |
| Kiểu cửa sổ / nút chat vỡ | Lỗi hiển thị | Widget chèn kiểu riêng và tự thích ứng site; xung đột với kiểu toàn site có thể gây bất thường thị giác. | Script 美洽 chèn CSS lúc runtime; nếu kiểu toàn site (bộ chọn phổ quát / quy tắc ưu tiên cao / reset) ghi đè lớp của nó trước, vị trí, xếp chồng và phông vỡ — tác dụng phụ của «chèn động + chia sẻ một không gian kiểu tài liệu». |
| Nút ra ngoài màn hình / bị che | Lỗi hiển thị | Nút widget xuất hiện dạng nổi vị trí cố định; nếu bị phần tử cố định khác che, chỉnh xếp chồng hoặc vị trí. | Phần tử position:fixed khác trên site (lên đầu, quảng cáo nổi, thanh hỗ trợ riêng) với z-index cao hơn che nút 美洽, hoặc theme tính sai tọa độ, để nó «ngoài màn hình / bị che». |
| Xung đột DOM plugin / phân tích bên thứ ba | Lỗi hiển thị | Script khác trên trang sửa DOM hoặc chặn request có thể ảnh hưởng việc tải và hiển thị bình thường của widget. | Script heatmap / phân tích / chuyển đổi viết lại DOM, chèn overlay hoặc chặn request; vì chúng và 美洽 cùng chèn vào một tài liệu, xếp chồng / sự kiện nhiễu nhau và container 美洽 bị che hoặc init bị ngắt. |
| Widget biến mất sau khi đổi route SPA | Tích hợp framework | Với ứng dụng một trang (SPA), dùng hook route của framework để tải / init widget 美洽 hợp với routing frontend. | SPA đổi view qua routing frontend, hủy / dựng lại DOM, nhưng meiqia.js mặc định chèn một lần ở lần tải đầu và không tự dựng lại khi đổi route, nên «đổi trang, chat mất». |
| Cần init thủ công (manualInit / init) | Tích hợp framework | Thêm _MEIQIA('manualInit') sau mã nhúng 美洽 để dừng auto-init sau khi tải xuống; gọi _MEIQIA('init') để init thủ công khi cần. | Mặc định 美洽 tự init ngay sau khi tải; khi bạn cần container sẵn sàng / thông tin khách đã truyền / route ổn định trước, thời điểm đó «quá sớm» — chuyển sang init thủ công để kiểm soát trình tự. |
| entId không khớp / nhân viên không nhận chat | Cấu hình / cấp phép | Số sau entId trong mã là id duy nhất của công ty bạn; không khớp workbench thì nhân viên không thể phục vụ chat — tra ID công ty ở Cài đặt - Nhóm - tra ID. | entId gắn snippet với một tài khoản công ty cụ thể. Với mã của người khác / môi trường khác, hoặc lẫn tài khoản, frontend tải cửa sổ nhưng tin nhắn tới «công ty khác», nên workbench này không nhận gì — kiểu kinh điển «trông ổn mà không nhận». |
| Miền site chưa cấp phép trong console | Cấu hình / cấp phép | Console 美洽 cho «Thêm trang tích hợp», mỗi cái có cấu hình riêng; site mới phải cấu hình trong console trước khi tích hợp đúng. | 美洽 quản lý nhiều site như «trang tích hợp»; miền phải đăng ký / cấp phép trong console để được nhận. Miền sản xuất mới chưa thêm có thể không được chấp nhận hoặc ánh xạ sai cấu hình. |
| Đa site / kênh con (probe) lẫn lộn | Cấu hình / cấp phép | 美洽 hỗ trợ deploy widget và link chat khác nhau mỗi site (kênh con / probe); ngoài site mặc định bạn có thể thêm nữa, mỗi cái cấu hình riêng. | Mảng kinh doanh khác cần nhóm nhân viên / tin tự động khác, nhưng nếu mọi site dùng chung một snippet mặc định, không phân biệt được nguồn và cấu hình lẫn nhau. Kênh con (probe) thiết kế cho «một công ty, nhiều lối vào, được routing». |
| Chat web di động không hiển thị / cần deploy riêng | Di động / SDK | Mã widget tự thích ứng site; di động / PC dùng cùng snippet nhưng phải deploy riêng. | Nhiều nhóm có trang / template PC và di động riêng và chỉ dán mã ở template PC. Snippet như nhau và tự thích ứng, nhưng bước «dán» phải làm cả ở template di động; bỏ sót thì di động không có chat. |
| Tích hợp SDK gốc của app / AppKey | Di động / SDK | Tích hợp in-app cần AppKey từ workbench 美洽 (Cài đặt - Tích hợp - SDK, «Thêm cấu hình APP»), và lập trình viên tích hợp SDK iOS / Android theo tài liệu và demo chính thức. | App dùng SDK gốc, không phải JS web: trước hết «Thêm cấu hình APP» để lấy AppKey, rồi tích hợp SDK theo nền tảng cho UI chat, chưa đọc, push, v.v. — đường hoàn toàn khác widget web. |
| Push tin SDK không tới | Di động / SDK | Push SDK 美洽 có hai chế độ: với «không push», tin nhân viên chỉ tới trong app (mở app để nhận); với «máy chủ push tùy chỉnh», người dùng nhận push tới điện thoại cả khi đã thoát app. | Thiếu «push offline» thường nghĩa là chế độ push «không push», hoặc không có máy chủ push tùy chỉnh / chứng chỉ push theo nền tảng. Đường là «美洽 → máy chủ app → điện thoại người dùng»; thiếu mắt xích chỉ còn nhận in-app. |
| Ẩn nút mặc định / lối vào tùy chỉnh | Gọi API | Gọi _MEIQIA('withoutBtn') để không hiện nút gốc 美洽; sau khi init thành công, gọi _MEIQIA('showPanel') để mở chat. | Mặc định nút nổi gốc được render; để dùng lối vào riêng bạn phải khai báo «không nút gốc» trước / trong init và gắn «mở chat» vào phần tử của bạn — vấn đề thời điểm API, không phải «nút hỏng». |
| Truyền / đồng bộ thông tin khách không hiệu lực | Gọi API | Widget web 美洽 cung cấp API «truyền thông tin khách», «đồng bộ danh tính khách» và «thêm thông tin sự kiện tùy chỉnh» để đưa dữ liệu khách vào chat. | Các API này phải gọi trong thời điểm init đúng: sau khi init thành công (hoặc trong thời điểm manualInit + init). Quá sớm / muộn, hoặc sai định dạng trường, thành «đã đặt mà không hiệu lực». |
美洽 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.
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)
Chọn phương thức tích hợp nào? So sánh dưới tổng hợp tài liệu chính thức 美洽 cho tham chiếu chéo nhanh (lượng mã, đầy đủ tính năng, độ phù hợp, thời gian lên). Hầu hết site chọn «widget JS web».
| 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 |
Kênh / kịch bản → bản đồ kết quả tích hợp
Cùng 美洽 tích hợp khác nhau theo kênh / kịch bản. Bản đồ dưới hiện kênh thường gặp: xanh = dán là chạy, vàng = cần setup (deploy riêng / init / whitelist), đỏ = đổi phương thức mặc định (adblock / entId / app dùng SDK).
Câu hỏi thường gặp
美洽 Cửa sổ / bong bóng chat hoàn toàn không hiển thị — khắc phục thế nào?
Widget web 美洽 tải cửa sổ chat nổi bằng một snippet JS được dán; xác nhận mã đã nhúng đúng và trang tích hợp đã cấu hình trong console. Widget là meiqia.js được chèn vào DOM sau khi tải bất đồng bộ, nên «không có gì» thường nghĩa là «script chưa từng tải»: sai vị trí, bị adblock / cache chặn, hoặc miền / entId không khớp, nên bước chèn không bao giờ chạy. F12 → Network, tìm meiqia.js: không request → mã không có hiệu lực (kiểm vị trí / xóa cache); có request nhưng khác 200 → bị chặn hoặc lỗi đường dẫn; mọi thứ ổn mà vẫn ẩn → kiểm entId / cấp phép miền và các nhóm dưới.
美洽 Script đã tải nhưng mất nút chat — khắc phục thế nào?
Mã widget tự thích ứng site và hiện nút chat; nếu hiển thị lỗi, kiểm xem có bị kiểu ẩn hay khởi tạo bị ngắt. Nếu script tải nhưng mất nút, thường là vấn đề «lớp hiển thị»: CSS toàn site ghi đè vị trí nút / đặt display:none, z-index thua, hoặc phần tử cố định khác che; lỗi JS khác cũng có thể ngắt khởi tạo. F12 → Elements, tìm container 美洽 — có, bị ẩn, hay ngoài màn hình?; tạm tắt CSS / script riêng để thử lại; kiểm console xem lỗi ngắt thực thi.
美洽 meiqia.js bị tiện ích adblock chặn — khắc phục thế nào?
Script chat 美洽 đến từ miền bên thứ ba; nếu có tiện ích chặn cài đặt, nó có thể coi là quảng cáo / theo dõi và ngăn tải — tắt chặn hoặc whitelist. ERR_BLOCKED_BY_CLIENT nghĩa là tiện ích trình duyệt (AdBlock / uBlock / AdGuard) chặn request theo danh sách lọc. Script 美洽 là «bên thứ ba ngoài miền + giao tiếp thời gian thực», thường bị quy tắc đó hiểu nhầm là quảng cáo / theo dõi, gây lỗi giả «console ổn, phía người dùng mất». Thử lại ở ẩn danh hoặc tắt adblock — nếu hiện, chặn là nguyên nhân; nhắc người dùng whitelist site; frontend có thể tải script chat trễ / có điều kiện để né một số quy tắc tự động.
美洽 meiqia.js 404 / trạng thái xấu / nội dung hỗn hợp — khắc phục thế nào?
Sau khi deploy, tìm meiqia.js trong bảng Network; trạng thái 200 nghĩa là script đặt đúng và đã tải. Nguyên nhân khác-200 thường gặp: mã bị cache trang / CDN giữ (chưa làm mới sau xuất bản), tải trên trang HTTP / chuỗi chứng chỉ không đầy đủ kích hoạt chặn nội dung hỗn hợp, hoặc mã hỏng / sao chép thiếu. Bước này lỗi thì chèn và kết nối không bao giờ xảy ra. Xóa cache CDN / trình duyệt (hoặc ẩn danh) sau xuất bản; đảm bảo HTTPS đầy đủ với chuỗi chứng chỉ nguyên vẹn và không nội dung hỗn hợp; xác minh mã sao chép đầy đủ và không bị escape.
美洽 Mã sai vị trí (chặn head / không hiệu lực) — khắc phục thế nào?
美洽 khuyến nghị dán mã ở cuối trang, trước </body>; widget chạy sau khi nội dung chính tải xong. Widget phải chèn container sau khi DOM sẵn sàng. Trong <head> nó chặn render (màn hình trắng trước trên mạng yếu) hoặc chạy trước khi DOM sẵn sàng và chèn lỗi; trong một số scope async / module thứ tự tải cũng có thể sai. Đặt JS 美洽 ở footer chung mọi trang, trước </body>; với SPA xem mục «route SPA» và dùng manualInit; đảm bảo bundler không loại bỏ nó qua tree-shaking.
美洽 Kiểu cửa sổ / nút chat vỡ — khắc phục thế nào?
Widget chèn kiểu riêng và tự thích ứng site; xung đột với kiểu toàn site có thể gây bất thường thị giác. Script 美洽 chèn CSS lúc runtime; nếu kiểu toàn site (bộ chọn phổ quát / quy tắc ưu tiên cao / reset) ghi đè lớp của nó trước, vị trí, xếp chồng và phông vỡ — tác dụng phụ của «chèn động + chia sẻ một không gian kiểu tài liệu». F12 để xem quy tắc site nào ghi đè container 美洽; thu hẹp kiểu toàn site / giảm tác động lên lớp chung; nếu cần nhờ 美洽 chỉnh xếp chồng container.
美洽 Nút ra ngoài màn hình / bị che — khắc phục thế nào?
Nút widget xuất hiện dạng nổi vị trí cố định; nếu bị phần tử cố định khác che, chỉnh xếp chồng hoặc vị trí. Phần tử position:fixed khác trên site (lên đầu, quảng cáo nổi, thanh hỗ trợ riêng) với z-index cao hơn che nút 美洽, hoặc theme tính sai tọa độ, để nó «ngoài màn hình / bị che». Chọn container 美洽 trong F12 để xem tọa độ / z-index thực; nâng nó lên hoặc hạ z-index phần tử che; tránh xếp nhiều nổi cố định một góc.
美洽 Xung đột DOM plugin / phân tích bên thứ ba — khắc phục thế nào?
Script khác trên trang sửa DOM hoặc chặn request có thể ảnh hưởng việc tải và hiển thị bình thường của widget. Script heatmap / phân tích / chuyển đổi viết lại DOM, chèn overlay hoặc chặn request; vì chúng và 美洽 cùng chèn vào một tài liệu, xếp chồng / sự kiện nhiễu nhau và container 美洽 bị che hoặc init bị ngắt. Tắt từng plugin nghi ngờ để khoanh xung đột; chỉnh thứ tự tải / xếp chồng container; cho heatmap v.v. né vùng container 美洽.
美洽 Widget biến mất sau khi đổi route SPA — khắc phục thế nào?
Với ứng dụng một trang (SPA), dùng hook route của framework để tải / init widget 美洽 hợp với routing frontend. SPA đổi view qua routing frontend, hủy / dựng lại DOM, nhưng meiqia.js mặc định chèn một lần ở lần tải đầu và không tự dựng lại khi đổi route, nên «đổi trang, chat mất». Dùng _MEIQIA('manualInit') để dừng auto-init, và gọi _MEIQIA('init') trong hook route (React useEffect / Vue mounted / router afterEach) để gắn lại khi cần; tránh khởi tạo nhiều instance.
美洽 Cần init thủ công (manualInit / init) — khắc phục thế nào?
Thêm _MEIQIA('manualInit') sau mã nhúng 美洽 để dừng auto-init sau khi tải xuống; gọi _MEIQIA('init') để init thủ công khi cần. Mặc định 美洽 tự init ngay sau khi tải; khi bạn cần container sẵn sàng / thông tin khách đã truyền / route ổn định trước, thời điểm đó «quá sớm» — chuyển sang init thủ công để kiểm soát trình tự. Thêm _MEIQIA('manualInit') sau mã; gọi _MEIQIA('init') khi điều kiện sẵn sàng (DOM / phiên / route); gọi API thông tin theo thứ tự trong thời gian init theo tài liệu.
Thêm thiết lập tích hợp: tích hợp web 美洽, tích hợp SDK APP; để bắt đầu: hướng dẫn 美洽. Bản đầy đủ tìm được (gồm công cụ này) cũng ở khắc phục tích hợp 美洽 (GitHub Pages).