Langkah 1: bagi jadi empat kelompok (muat / konfig / framework / tampilan)
Apa pun «chat tak muncul» Anda, persempit dulu ke empat kelompok — ini saja menghemat sebagian besar putaran. Diagram alir memperjelas keputusan: periksa apakah skrip benar dimuat (meiqia.js di F12), lalu apakah konfig, framework, atau masalah lapisan tampilan. Untuk dasar lihat panduan integrasi web 美洽.
Cara kerja integrasi: kenapa injeksi JS ini gagal / diblokir
Satu kalimat cukup: widget web 美洽 bukan komponen statis di halaman Anda — ia meiqia.js yang dimuat asinkron dari domain eksternal 美洽 yang secara dinamis menyuntik kontainer chat (DOM / iframe) dan membuka koneksi lintas-asal bertahan lama. Agar injeksi sukses perlu «skrip dimuat (penempatan benar, tak ter-adblock), kontainer tak tertutup CSS / plugin lain, entId dan domain cocok, dan pasang ulang setelah ganti rute SPA». Diagram di bawah menggambar rantai ini dan empat titik blokir — itulah kenapa kode sama jalan di satu situs / framework tapi tidak di lain.
Kode ditempat benar tapi masih tak muncul: jalankan panel swa-periksa integrasi
Jika penempatan, meiqia.js 200, dan entId semua terkonfirmasi tapi masih tak muncul, pada dasarnya itu «adblock» atau «framework / penumpukan». Panel di bawah diurut menurut kepentingan: hijau biasanya baik, yang merah (adblock, penumpukan SPA / plugin pihak ketiga) adalah jebakan sering. Memeriksanya satu per satu cepat melokalkan.
Tabel gejala lengkap (perilaku / posisi resmi · akar masalah L2)
Tabel di bawah mendaftar sekaligus gejala tidak muncul / error yang umum, masing-masing dengan posisi resmi dan akar masalah L2. Kotak cari di atas digerakkan data tabel ini — cari kata kunci yang Anda temui.
| Gejala | Kelompok | Perilaku L1 / posisi resmi | Akar masalah L2 |
|---|---|---|---|
| Jendela / gelembung chat tak muncul sama sekali | Gagal muat | Widget web 美洽 memuat jendela chat mengambang dengan satu snippet JS yang ditempel; pastikan kode tertanam benar dan situs integrasi dikonfigurasi di konsol. | Widget adalah meiqia.js yang disuntik ke DOM setelah pemuatan asinkron, jadi «tak ada apa-apa» biasanya berarti «skrip tak pernah dimuat»: salah tempat, diblokir adblock / cache, atau domain / entId tak cocok, sehingga injeksi tak pernah berjalan. |
| Skrip dimuat tapi tombol chat hilang | Masalah tampilan | Kode widget menyesuaikan situs dan menampilkan tombol chat; jika tampilan gagal, periksa apakah tersembunyi oleh gaya atau inisialisasi terputus. | Jika skrip dimuat tapi tombol hilang, biasanya masalah «lapisan tampilan»: CSS global menimpa posisi tombol / set display:none, z-index kalah, atau elemen fiks lain menutupinya; error JS lain juga bisa membatalkan inisialisasi. |
| meiqia.js diblokir ekstensi adblock | Gagal muat | Skrip chat 美洽 berasal dari domain pihak ketiga; jika ada ekstensi pemblokir, ia mungkin menganggapnya iklan / pelacak dan mencegah pemuatan — matikan pemblokiran atau whitelist. | ERR_BLOCKED_BY_CLIENT berarti ekstensi browser (AdBlock / uBlock / AdGuard) memblokir permintaan lewat daftar filter. Skrip 美洽 adalah «pihak ketiga lintas domain + komunikasi real-time», yang sering disalahbaca aturan tersebut sebagai iklan / pelacak, menyebabkan kegagalan palsu «konsol baik, sisi pengguna hilang». |
| meiqia.js 404 / status buruk / konten campuran | Gagal muat | Setelah deploy, cari meiqia.js di panel Network; status 200 berarti skrip ditempatkan benar dan dimuat. | Sebab umum bukan-200: kode tertahan cache halaman / CDN (tak di-refresh setelah publikasi), dimuat di halaman HTTP / rantai sertifikat tak lengkap memicu blokir konten campuran, atau kode rusak / disalin sebagian. Jika langkah ini gagal, injeksi dan koneksi tak pernah terjadi. |
| Kode salah tempat (blokir head / tak berlaku) | Gagal muat | 美洽 menyarankan menempel kode di bagian bawah halaman, sebelum </body>; widget berjalan setelah konten utama dimuat. | Widget harus menyuntik kontainer setelah DOM siap. Di <head> ia memblokir render (layar kosong dulu di jaringan lemah) atau berjalan sebelum DOM siap dan gagal; dalam sebagian scope async / modul urutan muat juga bisa kacau. |
| Gaya jendela / tombol chat rusak | Masalah tampilan | Widget menyuntik gayanya sendiri dan menyesuaikan situs; konflik dengan gaya global bisa menyebabkan anomali visual. | Skrip 美洽 menyuntik CSS saat runtime; jika gaya global (selektor universal / aturan prioritas tinggi / reset) menimpa kelasnya lebih dulu, posisi, penumpukan, dan font rusak — efek samping «injeksi dinamis + berbagi satu ruang gaya dokumen». |
| Tombol di luar layar / tertutup | Masalah tampilan | Tombol widget muncul sebagai mengambang posisi fiks; jika tertutup elemen fiks lain, sesuaikan penumpukan atau posisi. | Elemen position:fixed lain di situs (kembali ke atas, iklan mengambang, bilah dukungan kustom) dengan z-index lebih tinggi menutup tombol 美洽, atau tema salah hitung koordinatnya, membuatnya «di luar layar / tertutup». |
| Konflik DOM plugin / analitik pihak ketiga | Masalah tampilan | Skrip lain di halaman yang mengubah DOM atau mencegat permintaan bisa memengaruhi pemuatan dan tampilan normal widget. | Skrip heatmap / analitik / konversi menulis ulang DOM, menyuntik overlay atau mencegat permintaan; karena mereka dan 美洽 menyuntik ke dokumen yang sama, penumpukan / event saling ganggu dan kontainer 美洽 tertutup atau init-nya terputus. |
| Widget hilang setelah ganti rute SPA | Integrasi framework | Untuk aplikasi satu halaman (SPA), pakai hook rute framework untuk memuat / init widget 美洽 agar cocok dengan routing frontend. | SPA menukar tampilan via routing frontend, menghancurkan / membangun ulang DOM, tapi meiqia.js menyuntik sekali saat muat pertama secara default dan tak dibangun ulang otomatis saat ganti rute, jadi «ganti halaman, chat hilang». |
| Perlu init manual (manualInit / init) | Integrasi framework | Tambah _MEIQIA('manualInit') setelah kode sematan 美洽 untuk menghentikan auto-init setelah unduh; panggil _MEIQIA('init') untuk init manual saat diperlukan. | Secara default 美洽 auto-init tepat setelah unduh; saat Anda perlu kontainer siap / info pelanggan terkirim / rute stabil dulu, waktu itu «terlalu dini» — beralih ke init manual untuk mengatur urutan. |
| entId tidak cocok / agen tidak menerima chat | Konfigurasi / otorisasi | Angka setelah entId di kode adalah id unik perusahaan Anda; jika tak cocok dengan workbench, agen tak bisa melayani chat — cari ID perusahaan di Pengaturan - Tim - cari ID. | entId mengikat snippet ke akun perusahaan tertentu. Dengan kode orang lain / lingkungan lain, atau akun tercampur, frontend memuat jendela tapi pesan pergi ke «perusahaan lain», jadi workbench ini tak menerima apa pun — klasik «tampak baik tapi tak menerima». |
| Domain situs tak diotorisasi di konsol | Konfigurasi / otorisasi | Konsol 美洽 bisa «Tambah situs integrasi», masing-masing dengan konfig sendiri; situs baru harus dikonfigurasi di konsol sebelum terintegrasi benar. | 美洽 mengelola banyak situs sebagai «situs integrasi»; domain harus terdaftar / diotorisasi di konsol untuk dikenali. Domain produksi baru yang tak ditambahkan mungkin tak diterima atau dipetakan ke konfig salah. |
| Multi-situs / sub-kanal (probe) tercampur | Konfigurasi / otorisasi | 美洽 mendukung deploy widget dan tautan chat berbeda per situs (sub-kanal / probe); selain situs default Anda bisa menambah lagi, masing-masing dengan konfig sendiri. | Lini bisnis berbeda perlu grup agen / pesan otomatis berbeda, tapi jika tiap situs berbagi satu snippet default, sumber tak bisa dibedakan dan konfig tercampur. Sub-kanal (probe) dirancang untuk «satu perusahaan, banyak pintu masuk, di-routing». |
| Chat web seluler tak muncul / perlu deploy terpisah | Seluler / SDK | Kode widget menyesuaikan situs; seluler / PC pakai snippet yang sama tapi harus di-deploy terpisah. | Banyak tim punya halaman / template PC dan seluler terpisah dan hanya menempel kode di template PC. Snippet-nya sama dan menyesuaikan, tapi langkah «tempel» harus dilakukan juga di template seluler; jika terlewat, seluler tak punya chat. |
| Integrasi SDK native app / AppKey | Seluler / SDK | Integrasi in-app perlu AppKey dari workbench 美洽 (Pengaturan - Integrasi - SDK, «Tambah konfig APP»), dan pengembang mengintegrasikan SDK iOS / Android sesuai dok dan demo resmi. | App pakai SDK native, bukan JS web: dulu «Tambah konfig APP» untuk AppKey, lalu integrasikan SDK per platform untuk UI chat, belum dibaca, push, dll. — jalur yang sama sekali beda dari widget web. |
| Push pesan SDK tak datang | Seluler / SDK | Push SDK 美洽 punya dua mode: dengan «tanpa push», pesan agen hanya sampai dalam app (buka app untuk menerima); dengan «server push kustom», pengguna menerima push ke ponsel bahkan setelah keluar app. | «Push offline» yang hilang biasanya berarti mode push «tanpa push», atau tak ada server push kustom / sertifikat push per platform. Jalurnya «美洽 → server app → ponsel pengguna»; mata rantai hilang menyisakan penerimaan in-app saja. |
| Sembunyikan tombol default / pintu masuk kustom | Panggilan API | Panggil _MEIQIA('withoutBtn') agar tak menampilkan tombol native 美洽; setelah init sukses, panggil _MEIQIA('showPanel') untuk membuka chat. | Secara default tombol mengambang native dirender; untuk pintu masuk Anda harus mendeklarasikan «tanpa tombol native» sebelum / saat init dan mengikat «buka chat» ke elemen Anda — soal waktu API, bukan «tombol rusak». |
| Kirim / sinkron info pelanggan tak berlaku | Panggilan API | Widget web 美洽 menyediakan API «kirim info pelanggan», «sinkron identitas pelanggan» dan «tambah info event kustom» untuk membawa data pengunjung ke chat. | API ini harus dipanggil dalam waktu init yang benar: setelah init sukses (atau dalam waktu manualInit + init). Terlalu dini / lambat, atau format field salah, dan jadi «diset tapi tak berlaku». |
美洽 sebab tidak muncul & perbandingan metode integrasi (perkiraan 2026)
Berikut adalah perkiraan 2026 yang dirangkum dari bantuan resmi 美洽 (Kanal akses / API widget web JavaScript) dan troubleshooting integrasi publik (bukan komitmen vendor maupun pengukuran langsung; sebagai acuan, berubah menurut versi dan kebijakan browser):
| Dimensi | Perkiraan / perbandingan |
|---|---|
| Sebaran sebab tidak muncul (komunitas / tiket · perk.) | penempatan / tak dimuat ~35% > adblock / ekstensi browser ~25% > konfig / otorisasi (entId / domain) ~20% > framework (SPA) ~12% > konflik gaya / plugin pihak ketiga ~8% |
| Apa sebenarnya integrasi itu | widget web = JS asinkron pihak ketiga lintas domain yang menyuntik DOM + koneksi lintas-asal bertahan lama (bukan komponen statis tertanam); maka terpengaruh penempatan, aturan adblock, penumpukan CSS, siklus hidup SPA |
| Integrasi per platform (perk.) | web PC / seluler = widget JS (kode sama, deploy terpisah); app = SDK native (AppKey); WeChat / Douyin / RED = integrasi otorisasi kanal |
| Dampak adblock (perk.) | sekitar 30-40% pengguna PC pakai ekstensi adblock → skrip chat pihak ketiga diblokir aturan iklan (ERR_BLOCKED_BY_CLIENT), sebab utama «konsol baik, sisi pengguna hilang» |
| Waktu tayang widget JS (resmi) | tempel JS khusus di bagian bawah halaman dan tayang dalam sekitar 3-5 menit; entId adalah id unik perusahaan, dan ketaksesuaian dengan workbench membuat agen tanpa chat |
Basis perkiraan: garis dasar sumber + ekstrapolasi waktu (meiqia.com/help Kanal akses / widget web JavaScript, panduan integrasi meiqia.im, troubleshooting publik, 2026); berubah menurut versi dan kebijakan pemblokiran browser. Ikuti info resmi 美洽 terbaru. Tidak resmi · lokalisasi LLM.
Lima metode integrasi 美洽 dibandingkan (kode / kesulitan / fitur / skenario / waktu tayang)
Metode integrasi mana? Perbandingan di bawah merangkum dok resmi 美洽 untuk acuan silang cepat (jumlah kode, kelengkapan fitur, kecocokan, waktu tayang). Kebanyakan situs memilih «widget JS web».
| Metode integrasi | Kode / kesulitan | Kelengkapan fitur | Cocok untuk | Waktu tayang |
|---|---|---|---|---|
| Widget JS web | satu snippet JS · rendah | terlengkap (mengambang / popup / sapaan otomatis / jejak pengunjung) | situs PC + seluler (rekomendasi resmi) | ~3-5 mnt |
| Tautan chat | tanpa kode · minimal | chat dasar | tanpa teknis / pasang tautan chat cepat | instan |
| API / SDK WebIM | perlu dev · tinggi | kustomisasi dalam (UI sendiri / sistem / integrasi pesanan) | tim dengan kapasitas dev untuk fusi dalam | tergantung dev |
| SDK native app | integrasi SDK · tinggi | chat in-app + push pesan | app iOS / Android | tergantung dev |
| Setup cepat CMS | plugin / satu klik · rendah | sama seperti widget JS | situs WordPress / Fkw / Shopify | menit |
Kanal / skenario → peta hasil integrasi
美洽 yang sama terintegrasi beda per kanal / skenario. Peta di bawah menampilkan kanal umum: hijau = tempel dan jalan, kuning = perlu setup (deploy terpisah / init / whitelist), merah = ganti metode secara default (adblock / entId / app pakai SDK).
Pertanyaan umum
美洽 Jendela / gelembung chat tak muncul sama sekali — bagaimana memperbaikinya?
Widget web 美洽 memuat jendela chat mengambang dengan satu snippet JS yang ditempel; pastikan kode tertanam benar dan situs integrasi dikonfigurasi di konsol. Widget adalah meiqia.js yang disuntik ke DOM setelah pemuatan asinkron, jadi «tak ada apa-apa» biasanya berarti «skrip tak pernah dimuat»: salah tempat, diblokir adblock / cache, atau domain / entId tak cocok, sehingga injeksi tak pernah berjalan. F12 → Network, cari meiqia.js: tanpa permintaan → kode tak berlaku (cek penempatan / bersihkan cache); ada permintaan tapi bukan-200 → diblokir atau masalah jalur; semua baik tapi masih tertutup → cek entId / otorisasi domain dan kelompok di bawah.
美洽 Skrip dimuat tapi tombol chat hilang — bagaimana memperbaikinya?
Kode widget menyesuaikan situs dan menampilkan tombol chat; jika tampilan gagal, periksa apakah tersembunyi oleh gaya atau inisialisasi terputus. Jika skrip dimuat tapi tombol hilang, biasanya masalah «lapisan tampilan»: CSS global menimpa posisi tombol / set display:none, z-index kalah, atau elemen fiks lain menutupinya; error JS lain juga bisa membatalkan inisialisasi. F12 → Elements, cari kontainer 美洽 — ada, tersembunyi, atau di luar layar?; nonaktifkan sementara CSS / skrip sendiri untuk uji ulang; cek konsol untuk error yang membatalkan eksekusi.
美洽 meiqia.js diblokir ekstensi adblock — bagaimana memperbaikinya?
Skrip chat 美洽 berasal dari domain pihak ketiga; jika ada ekstensi pemblokir, ia mungkin menganggapnya iklan / pelacak dan mencegah pemuatan — matikan pemblokiran atau whitelist. ERR_BLOCKED_BY_CLIENT berarti ekstensi browser (AdBlock / uBlock / AdGuard) memblokir permintaan lewat daftar filter. Skrip 美洽 adalah «pihak ketiga lintas domain + komunikasi real-time», yang sering disalahbaca aturan tersebut sebagai iklan / pelacak, menyebabkan kegagalan palsu «konsol baik, sisi pengguna hilang». Uji ulang di penyamaran atau dengan adblock mati — jika muncul, pemblokiran penyebabnya; minta pengguna whitelist situs; frontend bisa memuat skrip chat tertunda / kondisional untuk menghindari sebagian aturan otomatis.
美洽 meiqia.js 404 / status buruk / konten campuran — bagaimana memperbaikinya?
Setelah deploy, cari meiqia.js di panel Network; status 200 berarti skrip ditempatkan benar dan dimuat. Sebab umum bukan-200: kode tertahan cache halaman / CDN (tak di-refresh setelah publikasi), dimuat di halaman HTTP / rantai sertifikat tak lengkap memicu blokir konten campuran, atau kode rusak / disalin sebagian. Jika langkah ini gagal, injeksi dan koneksi tak pernah terjadi. Bersihkan cache CDN / browser (atau penyamaran) setelah publikasi; pastikan HTTPS penuh dengan rantai sertifikat utuh dan tanpa konten campuran; verifikasi kode yang disalin lengkap dan tak ter-escape.
美洽 Kode salah tempat (blokir head / tak berlaku) — bagaimana memperbaikinya?
美洽 menyarankan menempel kode di bagian bawah halaman, sebelum </body>; widget berjalan setelah konten utama dimuat. Widget harus menyuntik kontainer setelah DOM siap. Di <head> ia memblokir render (layar kosong dulu di jaringan lemah) atau berjalan sebelum DOM siap dan gagal; dalam sebagian scope async / modul urutan muat juga bisa kacau. Letakkan JS 美洽 di footer umum tiap halaman, sebelum </body>; untuk SPA lihat entri «rute SPA» dan pakai manualInit; pastikan bundler tak menghapusnya lewat tree-shaking.
美洽 Gaya jendela / tombol chat rusak — bagaimana memperbaikinya?
Widget menyuntik gayanya sendiri dan menyesuaikan situs; konflik dengan gaya global bisa menyebabkan anomali visual. Skrip 美洽 menyuntik CSS saat runtime; jika gaya global (selektor universal / aturan prioritas tinggi / reset) menimpa kelasnya lebih dulu, posisi, penumpukan, dan font rusak — efek samping «injeksi dinamis + berbagi satu ruang gaya dokumen». F12 untuk lihat aturan situs mana yang menimpa kontainer 美洽; persempit gaya global / kurangi dampaknya pada kelas umum; bila perlu minta 美洽 menyesuaikan penumpukan kontainer.
美洽 Tombol di luar layar / tertutup — bagaimana memperbaikinya?
Tombol widget muncul sebagai mengambang posisi fiks; jika tertutup elemen fiks lain, sesuaikan penumpukan atau posisi. Elemen position:fixed lain di situs (kembali ke atas, iklan mengambang, bilah dukungan kustom) dengan z-index lebih tinggi menutup tombol 美洽, atau tema salah hitung koordinatnya, membuatnya «di luar layar / tertutup». Pilih kontainer 美洽 di F12 untuk lihat koordinat / z-index nyata; naikkan atau turunkan z-index elemen penutup; hindari menumpuk banyak mengambang fiks di satu sudut.
美洽 Konflik DOM plugin / analitik pihak ketiga — bagaimana memperbaikinya?
Skrip lain di halaman yang mengubah DOM atau mencegat permintaan bisa memengaruhi pemuatan dan tampilan normal widget. Skrip heatmap / analitik / konversi menulis ulang DOM, menyuntik overlay atau mencegat permintaan; karena mereka dan 美洽 menyuntik ke dokumen yang sama, penumpukan / event saling ganggu dan kontainer 美洽 tertutup atau init-nya terputus. Nonaktifkan plugin mencurigakan satu per satu untuk melokalkan konflik; sesuaikan urutan muat / penumpukan kontainer; buat heatmap dll. menghindari area kontainer 美洽.
美洽 Widget hilang setelah ganti rute SPA — bagaimana memperbaikinya?
Untuk aplikasi satu halaman (SPA), pakai hook rute framework untuk memuat / init widget 美洽 agar cocok dengan routing frontend. SPA menukar tampilan via routing frontend, menghancurkan / membangun ulang DOM, tapi meiqia.js menyuntik sekali saat muat pertama secara default dan tak dibangun ulang otomatis saat ganti rute, jadi «ganti halaman, chat hilang». Pakai _MEIQIA('manualInit') untuk menghentikan auto-init, dan panggil _MEIQIA('init') di hook rute (React useEffect / Vue mounted / router afterEach) untuk memasang ulang sesuai kebutuhan; hindari menginisialisasi banyak instance.
美洽 Perlu init manual (manualInit / init) — bagaimana memperbaikinya?
Tambah _MEIQIA('manualInit') setelah kode sematan 美洽 untuk menghentikan auto-init setelah unduh; panggil _MEIQIA('init') untuk init manual saat diperlukan. Secara default 美洽 auto-init tepat setelah unduh; saat Anda perlu kontainer siap / info pelanggan terkirim / rute stabil dulu, waktu itu «terlalu dini» — beralih ke init manual untuk mengatur urutan. Tambah _MEIQIA('manualInit') setelah kode; panggil _MEIQIA('init') begitu kondisi siap (DOM / sesi / rute); panggil API info berurutan dalam waktu init sesuai dok.
Lebih banyak setup integrasi: integrasi web 美洽, integrasi SDK APP; untuk memulai: panduan 美洽. Versi lengkap yang bisa dicari (termasuk alat ini) juga di troubleshooting integrasi 美洽 (GitHub Pages).