Troubleshooting saas

Widget tidak muncul di situs Anda, atau hanya muncul untuk pengguna yang telah login, atau muncul kosong. Halaman ini adalah panduan langkah demi langkah untuk memecahkan masalah paling umum.

Checklist: widget tidak muncul sama sekali

Ikuti langkah-langkah berikut secara berurutan:

1. Pastikan kode pasang terpasang. Buka situs Anda, klik kanan → View Page Source, lalu cari widget.js. Jika tidak ditemukan, kode pasang belum terpasang dengan benar.
2. Pastikan asal yang diizinkan sudah benar. Buka Pengaturan agen → Asal yang diizinkan. Pastikan https://situsanda.com ada di dalam daftar. Jika daftar kosong, widget tidak akan muncul di mana pun.
3. Pastikan agen sudah dipublikasikan. Widget hanya dapat memuat agen yang telah dipublikasikan. Buka halaman agen Anda dan pastikan tombol Publikasikan sudah diklik.
4. Buka DevTools → Console. Cari pesan error berwarna merah. Jika ada, salin pesan error tersebut dan kirimkan ke tim dukungan kami.
5. Coba di peramban privat. Buka situs Anda di jendela incognito/private window untuk memastikan tidak ada ekstensi peramban yang memblokir widget.

Widget muncul tapi kosong

Jika widget muncul di pojok layar tetapi tidak ada teks sama sekali:

1. Muat ulang halaman (Refresh). Tekan Ctrl+F5 (atau Cmd+Shift+R di Mac).
2. Pastikan agen memiliki pengetahuan. Buka halaman agen → Pengetahuan. Jika belum ada sumber, tambahkan setidaknya satu sumber.
3. Uji di Playground. Buka /app/agents/{id}/playground dan ajukan pertanyaan. Jika agen tidak merespons di sana juga, berarti terdapat masalah pada pengetahuan atau konfigurasi agen.

Widget muncul tapi tidak merespons

Jika widget dapat dibuka tetapi tidak memberikan jawaban:

• Periksa kuota bulanan. Jika kuota percakapan Anda habis, widget akan menampilkan pesan "Batas chat habis". Buka Pengaturan → Billing untuk memeriksa.
• Periksa status agen. Pastikan status agen adalah Aktif, bukan Arsip.
• Periksa koneksi ke penyedia AI. Buka Pengaturan → Sistem dan klik Test AI untuk memastikan koneksi ke layanan AI berfungsi baik.

Widget tidak muncul hanya di halaman tertentu

Hal ini biasanya disebabkan oleh:

• Jalur yang dibatasi. Periksa apakah halaman tersebut masuk ke dalam daftar Jalur yang dibatasi pada pengaturan agen.
• Cache halaman. Jika Anda menggunakan plugin cache (seperti pada WordPress), bersihkan cache situs Anda.
• Konflik Tema (Theme conflict). Beberapa tema CSS menyembunyikan elemen dengan aturan display: none. Anda dapat menambahkan aturan CSS berikut di pengaturan tema Anda:

Widget lambat

Jika widget lambat dimuat atau merespons:

• Periksa koneksi internet. Widget membutuhkan koneksi internet untuk terhubung ke server kami.
• Pastikan Anda tidak memblokir script eksternal. Beberapa ekstensi pemblokir iklan (ad blocker) dapat menghalangi pemuatan widget.
• Ukuran file widget. Widget kami dioptimalkan hingga <50KB. Jika pemuatan terasa sangat lambat, hubungi tim dukungan kami.

Butuh bantuan lebih lanjut?

Jika langkah-langkah di atas belum menyelesaikan masalah Anda, hubungi tim dukungan kami melalui [email protected] dengan menyertakan:

• Nama ruang kerja dan ID agen Anda.
• URL situs web tempat widget mengalami kendala.
• Tangkapan layar (screenshot) atau salinan pesan error dari DevTools Console.
• Peramban dan sistem operasi yang Anda gunakan.