Masalah umum dan solusi untuk integrasi dan penggunaan widget.
Mengalami masalah? Anda berada di tempat yang tepat. Panduan ini mencakup masalah paling umum yang dihadapi pengembang saat mengintegrasikan widget, bersama dengan solusi langkah demi langkah. Sebagian besar masalah dapat diselesaikan hanya dalam beberapa menit.
50d Tip Debugging Cepat
Buka Konsol Pengembang browser Anda (F12) sebelum memecahkan masalah. Sebagian besar kesalahan widget akan menampilkan pesan yang jelas di konsol yang langsung menunjukkan masalahnya.
Jika widget tidak muncul sama sekali di halaman Anda, ikuti langkah-langkah pemecahan masalah ini secara berurutan:
Kesalahan: "Widget tidak dikonfigurasi" (dengan rincian tentang setiap atribut data-* yang hilang)
Periksa konsol browser untuk pesan kesalahan ini.
Pastikan semua atribut data yang diperlukan ada di tag skrip:
<script src="https://widget.companin.tech/widget.js" data-widget-key="YOUR_WIDGET_KEY" data-locale="en"></script>Kesalahan: "Autentikasi diperlukan" atau "Kredensial tidak valid"
Widget gagal untuk mengautentikasi dengan API. Ini biasanya terjadi ketika kredensial tidak benar atau sudah kedaluwarsa.
Masalah autentikasi biasanya mudah diperbaiki. Kerjakan pemeriksaan ini:
client_id benar di aplikasi OAuth Anda - Salin langsung dari dasbor Anda untuk menghindari kesalahan ketikMasih terjebak? Cobalah membuat aplikasi OAuth baru di dasbor Anda. Terkadang memulai dari awal menyelesaikan masalah konfigurasi yang tidak jelas.
Kesalahan: "Asal tidak diizinkan" atau permintaan token widget ditolak
Umum saat menyematkan dalam iframe dan domain host tidak terdaftar dalam asal yang diizinkan OAuth.
Tip validasi: Periksa tab jaringan browser untuk header permintaan token dan bandingkan X-Embed-Origin dengan entri allowed_origins OAuth Anda.
Masalah penempatan tombol
Widget dimuat tetapi tombol berada di luar viewport.
position: fixedoverflow: hiddenJika hide_on_mobile diaktifkan dalam konfigurasi, widget akan tersembunyi di perangkat mobile. Nonaktifkan pengaturan ini atau sesuaikan breakpoint mobile.
Masalah visual umum dan biasanya mudah diperbaiki. Widget dirancang untuk terpisah secara visual dari halaman Anda, tetapi terkadang konflik dapat terjadi.
Ikuti langkah-langkah ini untuk mendiagnosis masalah warna:
Tip debug: Buka widget di browser Anda dan gunakan alat inspeksi elemen untuk memverifikasi nilai CSS mana yang sebenarnya diterapkan. Ini akan menunjukkan apakah warna Anda dimuat atau ditimpa.
Ketika widget dimuat dengan benar tetapi fitur tidak berfungsi seperti yang diharapkan, solusi ini akan membantu.
Kesalahan jaringan, timeout, atau sesi kedaluwarsa
Pengguna mengetik pesan dan mengklik kirim, tetapi tidak ada yang terjadi atau kesalahan muncul. Periksa tab jaringan browser untuk permintaan yang gagal (seharusnya ditampilkan sebagai merah di tab jaringan).
Masalah pengiriman pesan biasanya terkait dengan konektivitas jaringan atau sesi yang kedaluwarsa. Diagnosa secara sistematis:
Tes cepat: Jika pesan berfungsi di jendela incognito tetapi tidak di browser normal Anda, masalahnya kemungkinan terkait dengan ekstensi browser atau data autentikasi yang di-cache.
Widget memerlukan fitur browser modern:
Browser minimum yang didukung: Chrome 60+, Firefox 55+, Safari 12+, Edge 79+
Ketika Anda memerlukan bantuan tambahan di luar panduan ini, alat dan sumber daya ini akan membantu Anda mendiagnosis masalah atau mendapatkan dukungan.
Aktifkan mode debug untuk melihat logging rinci di konsol browser Anda. Ini memberikan wawasan tentang apa yang dilakukan widget di setiap langkah:
<script src="https://widget.companin.tech/widget.js" data-widget-key="YOUR_WIDGET_KEY" data-dev="true"></script>Masih mengalami masalah?
Periksa panduan konfigurasi kami atau hubungi dukungan dengan log konsol browser dan rincian konfigurasi Anda.