Embed Situs Web

Satu baris script untuk menempatkan jendela chat di situs web, beserta metode yang dapat dipanggil di halaman dan aturan bahasa.

Dalam teks berikut, {API} merujuk pada alamat layanan, yang dapat dilihat di halaman "Integrasi" pada panel admin.

<script src="{API}/static/aics-widget.js" data-key="pk_xxx" data-api="{API}" async></script>
  • data-key adalah Key publik; salin dari halaman "Integrasi" di panel admin.
  • Daftarkan situs web yang diizinkan untuk disematkan di halaman "Integrasi" (misalnya https://shop.example.com). Situs lain yang mendapatkan Key publik Anda tetap tidak dapat menggunakannya. Pastikan diisi sebelum diluncurkan.
  • Opsional data-theme="dark" untuk menggunakan tema gelap.
  • Opsional data-language="de": jika situs web Anda multibahasa, teruskan bahasa halaman saat ini; layanan pelanggan akan menggunakan bahasa tersebut secara default (pengunjung tetap dapat berganti). Kode bahasa yang didukung dapat dilihat di Ikhtisar Open API.
  • Opsional data-language="auto": gunakan <html lang> halaman sebagai bahasa default; setelah itu, saat halaman berganti bahasa (mengubah atribut lang, aplikasi satu halaman pun tidak perlu dimuat ulang), jendela layanan pelanggan akan otomatis mengikuti.

Di halaman, Anda dapat memanggil:

MetodeFungsi
AICS.open() / AICS.close() / AICS.toggle()Membuka, menutup, atau mengalihkan jendela layanan pelanggan, misalnya dipasang pada tombol "Hubungi Layanan Pelanggan"
AICS.identify(userToken)Setelah pelanggan login, beri tahu layanan pelanggan siapa pelanggan tersebut (lihat Mengenali Pelanggan yang Login)
AICS.setLanguage(code)Panggil saat situs web berganti bahasa; jendela layanan pelanggan dan jawaban berikutnya akan ikut berganti, misalnya AICS.setLanguage("ja"); juga menerima format seperti zh-Hans, pt-BR
AICS.reset()Panggil saat pelanggan logout: lepaskan jendela layanan pelanggan dan buang sesi saat ini; memuat skrip sekali lagi akan menjadi jendela anonim baru, sehingga orang berikutnya tidak dapat melihat percakapan orang sebelumnya

Bahasa

  • Jendela layanan pelanggan menampilkan bahasa sesuai lokasi pengunjung (IP), termasuk teks antarmuka dan pesan selamat datang; jika data-language diatur, bahasa halaman akan diprioritaskan. Jika lokasi tidak dapat ditentukan, gunakan "Bahasa default" yang diatur di panel admin.
  • AI menjawab dalam bahasa yang digunakan pelanggan; jika bahasa dari konten yang dikirim pelanggan tidak dapat dikenali (emoji, nomor pesanan), gunakan bahasa yang ditentukan di atas.
  • Pelanggan dapat berganti bahasa melalui menu bahasa di bagian atas jendela, atau langsung mengatakan kepada AI "Tolong jawab dalam bahasa Inggris". Setelah itu AI akan terus menggunakan bahasa tersebut, meskipun pelanggan menulis dalam bahasa lain.
  • Pergantian bahasa di situs web (memanggil AICS.setLanguage atau mengubah <html lang> saat data-language="auto") juga dianggap sebagai pilihan pelanggan; dari beberapa cara di atas, yang berlaku adalah pilihan terakhir. Namun, bahasa default yang dibawa saat halaman dibuka tidak akan menimpa bahasa yang sudah dipilih pelanggan.
  • Di panel admin, "Pengaturan Bot → Bahasa" memungkinkan Anda menonaktifkan deteksi berdasarkan IP, mengubah bahasa default, dan membatasi bahasa yang tersedia.
  • Jika diterapkan di belakang reverse proxy atau CDN, konfigurasikan TRUSTED_PROXIES atau COUNTRY_HEADER di sisi server; jika tidak, IP asli pengunjung tidak akan terbaca.

Apakah halaman ini membantu?

Terakhir diperbarui: