การฝังบนเว็บไซต์

ใช้ script เพียงบรรทัดเดียวเพื่อวางหน้าต่างแชทบนเว็บไซต์ พร้อมเมธอดที่เรียกใช้ได้บนหน้าเว็บและกฎด้านภาษา

{API} ด้านล่างหมายถึงที่อยู่ของบริการ ซึ่งดูได้ที่หน้าการเชื่อมต่อในหลังบ้าน

<script src="{API}/static/aics-widget.js" data-key="pk_xxx" data-api="{API}" async></script>
  • data-key คือ Public Key ซึ่งคัดลอกได้จากหน้าการเชื่อมต่อในหลังบ้าน
  • ลงทะเบียนเว็บไซต์ที่อนุญาตให้ฝังได้ที่หน้าการเชื่อมต่อ (เช่น https://shop.example.com) แม้เว็บไซต์อื่นจะได้ Public Key ของคุณไปก็ใช้งานไม่ได้ ต้องกรอกก่อนเปิดใช้งานจริง
  • ไม่บังคับ: data-theme="dark" ใช้สไตล์โหมดมืด
  • ไม่บังคับ: data-language="de": เมื่อเว็บไซต์ของคุณรองรับหลายภาษา ให้ส่งภาษาของหน้าปัจจุบันเข้ามา ระบบแชทบริการลูกค้าจะใช้ภาษานี้เป็นค่าเริ่มต้น (ผู้เข้าชมยังสลับได้) ดูรหัสภาษาที่รองรับได้ที่ ภาพรวม API ที่เปิดให้ใช้งาน
  • ไม่บังคับ: data-language="auto": ใช้ <html lang> ของหน้าเป็นภาษาเริ่มต้น จากนั้นเมื่อหน้าเว็บสลับภาษา (เปลี่ยนแอตทริบิวต์ lang แม้เป็นแอปพลิเคชันหน้าเดียวที่ไม่รีเฟรชก็ได้) หน้าต่างแชทบริการลูกค้าจะเปลี่ยนตามอัตโนมัติ

บนหน้าเว็บสามารถเรียกใช้:

เมธอดหน้าที่
AICS.open() / AICS.close() / AICS.toggle()เปิดและปิดหน้าต่างแชทบริการลูกค้า เช่น ผูกกับปุ่ม “ติดต่อฝ่ายบริการลูกค้า”
AICS.identify(userToken)หลังลูกค้าเข้าสู่ระบบ ให้แจ้งฝ่ายบริการลูกค้าว่าลูกค้าคือใคร (ดู การระบุลูกค้าที่เข้าสู่ระบบ)
AICS.setLanguage(code)เรียกใช้เมื่อเว็บไซต์สลับภาษา หน้าต่างแชทและคำตอบหลังจากนั้นจะเปลี่ยนตาม เช่น AICS.setLanguage("ja"); รองรับรูปแบบอย่าง zh-Hans, pt-BR ด้วย
AICS.reset()เรียกใช้เมื่อลูกค้าออกจากระบบ: ถอดหน้าต่างแชทและทิ้งเซสชันปัจจุบัน; เมื่อโหลดสคริปต์อีกครั้งจะเป็นหน้าต่างใหม่แบบไม่ระบุตัวตน และคนถัดไปจะไม่เห็นบทสนทนาของคนก่อนหน้า

ภาษา

  • หน้าต่างแชทบริการลูกค้าจะแสดงภาษาตามตำแหน่งที่ตั้งของผู้เข้าชม (IP) รวมถึงข้อความอินเทอร์เฟซและข้อความต้อนรับ; หากตั้งค่า data-language ไว้ จะใช้ภาษาของหน้าเว็บก่อน หากระบุตำแหน่งที่ตั้งไม่ได้ จะใช้ “ภาษาเริ่มต้น” ที่ตั้งค่าไว้ในหลังบ้าน
  • AI จะตอบตามภาษาที่ลูกค้าใช้; หากดูภาษาจากเนื้อหาที่ลูกค้าส่งไม่ได้ (อีโมจิ หมายเลขคำสั่งซื้อ) จะใช้ภาษาที่ตรวจสอบได้จากข้างต้น
  • ลูกค้าสามารถสลับได้จากเมนูภาษาที่ส่วนหัวของหน้าต่าง หรือพูดกับ AI ตรงๆ ว่า “กรุณาตอบเป็นภาษาอังกฤษ” หลังจากนั้น AI จะใช้ภาษานี้ตลอด แม้ลูกค้าจะเขียนด้วยภาษาอื่น
  • การที่เว็บไซต์สลับภาษา (เรียก AICS.setLanguage หรือเปลี่ยน <html lang> เมื่อใช้ data-language="auto") ถือเป็นการเลือกของลูกค้าด้วย และไม่ว่าจะใช้วิธีใดข้างต้น ให้ยึดครั้งล่าสุดเป็นหลัก; เพียงแต่ภาษาเริ่มต้นที่มาพร้อมตอนเปิดหน้าเว็บจะไม่ทับภาษาที่ลูกค้าเลือกไว้
  • ในหลังบ้านที่ “การตั้งค่าบอท → ภาษา” สามารถปิดการตรวจหาตาม IP เปลี่ยนภาษาเริ่มต้น และจำกัดภาษาที่เปิดให้ใช้งาน
  • เมื่อติดตั้งใช้งานอยู่หลัง reverse proxy หรือ CDN ต้องกำหนดค่า TRUSTED_PROXIES หรือ COUNTRY_HEADER ฝั่งเซิร์ฟเวอร์ มิฉะนั้นจะไม่ได้รับ IP จริงของผู้เข้าชม

หน้านี้มีประโยชน์ไหม?

อัปเดตล่าสุด: