Benam Laman Web

Satu baris script meletakkan tetingkap sembang di laman web, serta kaedah dan peraturan bahasa yang boleh dipanggil pada halaman.

Dalam teks di bawah, {API} merujuk kepada alamat perkhidmatan, yang boleh dilihat pada halaman "Integrasi" dalam panel pentadbir.

<script src="{API}/static/aics-widget.js" data-key="pk_xxx" data-api="{API}" async></script>
  • data-key ialah Key awam, salin di halaman "Integrasi" dalam panel pentadbir.
  • Pada halaman "Integrasi", daftarkan laman web yang dibenarkan membenamkan widget (contohnya https://shop.example.com); laman web lain yang mendapat Key awam anda juga tidak dapat menggunakannya. Pastikan diisi sebelum dilancarkan.
  • Pilihan data-theme="dark" untuk menggunakan gaya gelap.
  • Pilihan data-language="de": apabila laman web itu sendiri berbilang bahasa, hantar bahasa halaman semasa; khidmat pelanggan akan menggunakan bahasa ini secara lalai (pelawat masih boleh bertukar). Kod bahasa yang disokong lihat Gambaran keseluruhan API Terbuka.
  • Pilihan data-language="auto": ambil <html lang> halaman sebagai bahasa lalai; selepas itu apabila halaman bertukar bahasa (menukar atribut lang, aplikasi satu halaman tidak perlu dimuat semula pun boleh), tetingkap khidmat pelanggan akan mengikut secara automatik.

Pada halaman, anda boleh memanggil:

KaedahFungsi
AICS.open() / AICS.close() / AICS.toggle()Buka, tutup tetingkap khidmat pelanggan, contohnya letakkan pada butang "Hubungi Khidmat Pelanggan"
AICS.identify(userToken)Selepas pelanggan log masuk, beritahu khidmat pelanggan siapa dia (lihat Kenal pasti pelanggan yang log masuk)
AICS.setLanguage(code)Panggil apabila laman web bertukar bahasa; tetingkap khidmat pelanggan dan jawapan seterusnya akan ikut bertukar, contohnya AICS.setLanguage("ja"); juga menerima format seperti zh-Hans, pt-BR
AICS.reset()Panggil apabila pelanggan log keluar: nyahmuat tetingkap khidmat pelanggan dan buang sesi semasa; muat semula skrip sekali lagi untuk mendapatkan tetingkap baharu tanpa nama, orang seterusnya tidak dapat melihat perbualan orang sebelumnya

Bahasa

  • Tetingkap khidmat pelanggan memaparkan bahasa yang sepadan mengikut lokasi pelawat (IP), termasuk teks antara muka dan mesej alu-aluan; apabila data-language ditetapkan, bahasa halaman diutamakan. Jika lokasi tidak dapat ditentukan, gunakan "Bahasa Lalai" yang ditetapkan dalam panel pentadbir.
  • AI menjawab mengikut bahasa yang digunakan oleh pelanggan; apabila bahasa kandungan yang dihantar oleh pelanggan tidak dapat dikenal pasti (emoji, nombor pesanan), gunakan bahasa yang ditentukan di atas.
  • Pelanggan boleh bertukar bahasa melalui menu bahasa di bahagian atas tetingkap, atau terus memberitahu AI "Sila jawab dalam bahasa Inggeris". Selepas itu, AI akan terus menggunakan bahasa tersebut walaupun pelanggan menulis dalam bahasa lain.
  • Perubahan bahasa pada laman web (AICS.setLanguage atau menukar <html lang> apabila data-language="auto") juga dikira sebagai pilihan pelanggan; antara cara di atas, pilihan terakhir yang diambil kira. Namun begitu, bahasa lalai yang dibawa semasa halaman dibuka tidak akan mengatasi bahasa yang telah dipilih oleh pelanggan.
  • Dalam panel pentadbir, "Tetapan Bot → Bahasa" membolehkan anda mematikan pengesanan berdasarkan IP, menukar bahasa lalai dan mengehadkan bahasa yang tersedia.
  • Apabila digunakan di belakang proksi terbalik atau CDN, anda perlu mengkonfigurasi TRUSTED_PROXIES atau COUNTRY_HEADER di bahagian pelayan; jika tidak, IP sebenar pelawat tidak dapat diperoleh.

Adakah halaman ini membantu?

Kemas kini terakhir: