Widget chat tidak muncul di situs: cara mendiagnosis dan memperbaiki

Vitor

Vitor

Terakhir diperbarui saat Oct 14, 2026

Jika widget chat Papo (https://papo.global/) tidak muncul di situs Anda, diagnosis dimulai dengan memeriksa apakah snippet kode sudah dimasukkan dengan benar sebelum tag </body>, apakah ada konflik dengan plugin cache atau optimasi, dan apakah kotak masuk situs tetap aktif di dasbor Papo. Panduan ini merangkum langkah-langkah untuk mengidentifikasi dan memperbaiki masalah dengan cepat.

Widget chat adalah titik kontak yang mengubah pengunjung menjadi percakapan. Saat widget hilang, Anda kehilangan peluang layanan. Kabar baiknya, sebagian besar masalah memiliki penyebab sederhana dan solusi cepat.

Kemungkinan Penyebab Pemeriksaan Cepat Solusi yang Disarankan
Snippet tidak ada atau salah posisi Periksa kode sumber halaman (Ctrl+U) dan cari script widget. Masukkan kembali snippet tepat sebelum penutup </body>, sesuai yang dibuat di dasbor.
Konflik dengan plugin cache atau optimasi Uji situs di jendela anonim/privat atau nonaktifkan sementara plugin cache. Kecualikan script widget dari aturan minifikasi/cache atau bersihkan cache setelah memasukkan snippet.
Kotak masuk situs dihapus atau tanpa agen Buka Pengaturan → Kotak masuk dan periksa apakah kotak bertipe "Situs" terdaftar dan memiliki agen terkait. Buat ulang kotak masuk dan kaitkan setidaknya satu agen; salin snippet baru dan perbarui situs.
Script diblokir oleh ekstensi browser Buka situs di browser lain atau tanpa ekstensi aktif. Arahkan pengunjung untuk menonaktifkan pemblokir script untuk domain, atau tinjau pengaturan keamanan (CSP) situs.
Konflik dengan widget atau script lain Periksa konsol browser (F12) untuk mencari error JavaScript. Perbaiki konflik dengan menyesuaikan urutan pemuatan atau mengisolasi script.

Cara mendiagnosis tidak munculnya widget

  1. Pastikan snippet ada di kode sumber
    Buka halaman situs, klik kanan dan pilih "Lihat kode sumber" (atau gunakan Ctrl+U). Cari script yang dimulai dengan sesuatu seperti <script src="... app.papo.global ...">. Jika tidak muncul, snippet belum ditambahkan atau telah dihapus.

  2. Uji di jendela anonim/privat
    Sering kali, browser menyimpan versi cache halaman tanpa widget. Membuka jendela anonim mengabaikan cache lokal dan memuat versi terbaru situs. Jika widget muncul dalam mode ini, masalahnya adalah cache dan bukan script itu sendiri.

  3. Periksa konsol browser
    Tekan F12 untuk membuka alat pengembang dan buka tab "Console". Error berwarna merah dapat menunjukkan bahwa script widget diblokir oleh kebijakan keamanan atau berkonflik dengan script lain di halaman.

  4. Periksa apakah kotak masuk aktif di dasbor Papo
    Buka Pengaturan → Kotak masuk. Jika kotak yang dibuat untuk situs (tipe "Situs") tidak terdaftar, kotak itu mungkin terhapus secara tidak sengaja. Jika terdaftar, periksa apakah setidaknya satu agen terkait — kotak tanpa agen tidak memuat widget dengan benar.

Cara memperbaiki masalah yang paling umum

Memasang ulang snippet dengan benar

Jika kode tidak ada atau salah posisi, ulangi prosesnya:

  1. Di dasbor Papo, buka Pengaturan → Kotak masuk, klik Tambah kotak dan pilih Situs.
  2. Beri nama kotak dan masukkan URL situs.
  3. Salin script yang dibuat dan tempelkan ke HTML semua halaman tempat chat harus muncul, tepat sebelum penutup </body>.
  4. Kaitkan setidaknya satu agen ke kotak dan simpan.

Mengganti snippet lama dengan yang baru memastikan tidak ada karakter yang hilang akibat pengeditan manual.

Menangani cache dan plugin optimasi

Plugin cache, minifikasi JavaScript, atau lazy loading dapat mencegah script widget dijalankan. Jika Anda menggunakan platform seperti WordPress, bersihkan seluruh cache situs (server dan plugin) setelah menambahkan snippet. Jika memungkinkan, kecualikan script widget dari aturan minifikasi atau gabungkan hanya dengan script penting. Menguji dengan semua plugin optimasi dinonaktifkan membantu mengisolasi penyebabnya.

Membuat ulang kotak masuk dan menghubungkan kembali

Ketika kotak asli dihapus atau riwayat konfigurasi hilang, cara paling aman adalah membuat yang baru. Prosesnya sama seperti instalasi awal: buat kotak bertipe Situs, salin snippet baru dan ganti di kode situs. Setelah itu, kaitkan agen dan periksa apakah widget dimuat di jendela anonim. Snippet lama otomatis tidak berfungsi lagi dalam kasus ini.

Untuk siapa panduan ini berguna

  • Perusahaan yang baru saja memasang widget dan tidak melihatnya muncul.
  • Operasi yang mengganti tema atau melakukan pembaruan situs dan menyadari chat menghilang.
  • Tim yang mewarisi situs dengan snippet yang sudah dimasukkan dan perlu mendiagnosis mengapa widget tidak dimuat.
  • Mereka yang ingin menghindari kehilangan lead karena kanal layanan yang tidak terlihat.

Pertanyaan yang sering diajukan (FAQ)

Widget hanya tidak muncul untuk saya, tetapi klien saya melihatnya. Mengapa?

Kemungkinan besar itu cache browser Anda atau ekstensi yang memblokir script di perangkat Anda. Uji di jendela anonim atau perangkat lain. Jika widget muncul, masalahnya lokal dan tidak memengaruhi pengunjung.

Saya sudah memasang snippet, tetapi widget tidak muncul di halaman tertentu. Apa yang harus dilakukan?

Periksa apakah kode ditempelkan di template yang menyuplai semua halaman (misalnya, footer.php di WordPress) dan bukan hanya di satu halaman terpisah. Jika ada aturan tampilan kondisional di tema, Anda mungkin perlu menyesuaikannya untuk menyertakan domain yang benar.

Apakah saya perlu membuat ulang kotak masuk untuk memperbaiki widget?

Tidak selalu. Jika kotak masih ada dan memiliki agen terkait, cukup memasang ulang snippet biasanya menyelesaikan masalah. Membuat ulang kotak adalah alternatif ketika kotak dihapus atau ketika script asli hilang dan Anda tidak dapat memulihkannya.

Situs saya menggunakan WordPress, apakah ada hal khusus yang harus saya periksa?

Ya. Plugin cache (seperti WP Rocket, W3 Total Cache) dan alat minifikasi dapat memblokir script widget. Bersihkan cache, nonaktifkan sementara plugin tersebut untuk menguji dan, jika perlu, kecualikan script widget dari optimasi. Baca juga panduan lengkap tentang instalasi di WordPress.

Widget muncul lalu tiba-tiba hilang. Apa yang mungkin terjadi?

Perubahan tema situs, pembaruan plugin, atau migrasi server dapat menghapus snippet. Ada juga kemungkinan kotak masuk situs telah dihapus dari dasbor Papo. Periksa kedua kemungkinan: kode sumber dan daftar kotak masuk.

Bagaimana cara menguji apakah snippet berfungsi tanpa memublikasikan di situs resmi?

Anda dapat menambahkan script ke halaman uji di lingkungan staging atau ke halaman tersembunyi di situs Anda sendiri. Selama URL yang dimasukkan di kotak masuk sesuai dengan domain tempat script dipasang, widget akan dimuat normal agar Anda dapat memvalidasinya.

Baca juga


Mulai gratis dan pasang widget dalam hitungan menit →

Dengan Papo, Anda memberikan dukungan langsung di situs Anda dan menjaga seluruh layanan tetap terpusat di dasbor yang sama.