Running your own ConvTag install? → Bahasa Indonesia help · install / env / deployment live in the repo README.md
User guide · English User guide · Bahasa
C ConvTag docs

SaaS Help

Allowed origins saas

Widget bisa langsung dipasang di situs web Anda — tapi kami butuh memastikan hanya situs yang Anda pilih yang bisa menampilkan widget. Inilah yang kami sebut asal yang diizinkan.

Kenapa ini penting

Kode widget bersifat publik — siapa saja bisa melihatnya. Jika ada orang lain yang menyalin kode Anda dan memasangnya di situs mereka, mereka bisa menggunakan kuota chat Anda. Dengan asal yang diizinkan, kami memastikan hanya situs yang Anda daftarkan yang bisa menampilkan widget.

Cara kerja

Setiap kali seseorang membuka situs Anda, browser mengirimkan Origin — ini alamat situs yang sedang memuat widget. Sistem kami membandingkan Origin ini dengan daftar yang Anda izinkan. Jika cocok, widget muncul. Jika tidak, widget tidak muncul dan tidak ada kuota yang terpakai.

Menambahkan situs Anda

Buka halaman agen Anda → PengaturanAsal yang diizinkan. Masukkan satu per baris:

Contoh asal yang diizinkan
https://tokoanda.com
https://www.tokoanda.com
https://blog.tokoanda.com

Setiap baris harus diawali dengan https:// atau http://. Setelah menyimpan, perubahan langsung berlaku — cukup refresh halaman untuk melihat hasilnya.

Subdomain

Setiap subdomain diperlakukan sebagai situs yang berbeda. Jika Anda ingin widget muncul di tokoanda.com, www.tokoanda.com, dan blog.tokoanda.com, ketiganya harus terdaftar secara terpisah.

Mode pengembangan lokal

Saat mengembangkan di komputer Anda, tambahkan:

Contoh origin lokal
http://localhost:3000
http://localhost:5173

Ini memungkinkan widget berjalan di server lokal Anda. Jangan gunakan pengganti karakter * untuk produksi — ini akan membuka widget ke situs mana saja.

Pemecahan masalah

Widget tidak muncul di situs produksi? Pastikan Origin yang Anda kunjungi ada di daftar. Buka DevTools (F12) → tab Network → cari permintaan ke widget/init. Jika ada respons 403, berarti Origin situs Anda belum terdaftar.

Widget muncul untuk pengunjung tertentu tapi tidak untuk yang lain? Ini biasanya disebabkan oleh plugin caching di situs Anda. Pastikan plugin caching sudah dihapus atau dikonfigurasi untuk tidak menyimpan halaman yang berisi widget.

Pilihan lanjutan: jalur yang dibatasi

Jika Anda ingin widget muncul di sebagian besar situs tetapi tidak ingin muncul di halaman tertentu (misalnya /checkout atau /admin), gunakan jalur yang dibatasi. Ini adalah daftar pola yang memberitahu widget tidak boleh muncul di halaman-halaman tertentu.

Contoh:

Contoh jalur yang dibatasi
/checkout
/admin/*
/account/*

Ini berguna untuk menjaga widget tidak mengganggu pengunjung di halaman-halaman penting seperti checkout atau akun pengguna.