ติดตั้งวิดเจ็ต

วิดเจ็ต RolChat คือปุ่มลอยปุ่มเดียวที่ปรับตามโมดูลที่คุณเปิดใช้: แชท ฟอร์มขอให้โทรกลับ การจองนัดหมาย ฟอร์มลีด และการค้นหาฐานความรู้ ทั้งหมดอยู่ในวิดเจ็ตนี้ ติดตั้งครั้งเดียว ส่วนสิ่งที่แสดงจะกำหนดในแดชบอร์ด

1. คัดลอกโค้ด

ใน การตั้งค่า → วิดเจ็ต เลือกไซต์และคัดลอกโค้ดติดตั้ง ซึ่งมีหน้าตาดังนี้:

<!-- RolChat widget -->
<script>
  window.rolchatConfig = {
    "site_id": "ste_…",
    "account_id": "…",
    "widget_key": "wk1.<site>.<signature>",
    "modules": ["chat"]
  };
</script>
<script async src="https://widget.rolchat.com/stub.js"></script>

คีย์วิดเจ็ตเป็นแบบสาธารณะและใส่ในหน้าเว็บได้อย่างปลอดภัย คีย์นี้ระบุไซต์ของคุณและมีลายมือชื่อ จึงไม่มีใครชี้สำเนาของวิดเจ็ตมาที่บัญชีของคุณได้ แดชบอร์ดจะเพิ่มคีย์อื่นๆ ลงในออบเจ็กต์ (ข้อความทักทาย ชื่อส่วนหัว ธีม เวลาทำการ เลย์เอาต์ตามขนาดหน้าจอ) เมื่อคุณเปลี่ยนการตั้งค่าวิดเจ็ต ให้คัดลอกโค้ดอีกครั้งหลังเปลี่ยน หรือเก็บออบเจ็กต์ให้น้อยที่สุดแล้วให้วิดเจ็ตดึงส่วนที่เหลือเอง

stub.js มีขนาดไม่กี่กิโลไบต์และโหลดส่วนที่เหลือเฉพาะเมื่อผู้เยี่ยมชมต้องใช้: หน้าจอแชทเมื่อเปิดครั้งแรก การติดตามหลังได้รับความยินยอม และแบนเนอร์ความยินยอมในที่ที่จำเป็น

2. วางก่อน </body>

เพิ่มโค้ดในทุกหน้าที่ต้องการให้มีวิดเจ็ต ควรใส่ผ่านเทมเพลตของเว็บไซต์หรือตัวจัดการแท็กเพื่อให้ปรากฏทุกหน้าในครั้งเดียว สคริปต์โหลดแบบอะซิงโครนัสและไม่บล็อกการเรนเดอร์ บันเดิลที่โหลดครั้งแรกตั้งใจทำให้เล็กเพื่อไม่ให้กระทบ Core Web Vitals ของคุณ

3. ตรวจสอบว่าใช้งานได้

เปิดเว็บไซต์ของคุณในหน้าต่างส่วนตัว ปุ่มจะปรากฏที่มุมที่คุณเลือก ในแดชบอร์ด ผู้เยี่ยมชม จะแสดงเซสชันนิรนามใหม่แบบเรียลไทม์ และข้อความที่ส่งจากวิดเจ็ตจะปรากฏในกล่องข้อความรวมเป็นบทสนทนาใหม่

ระบุตัวผู้ใช้ที่เข้าสู่ระบบ

หากผู้เยี่ยมชมของคุณลงชื่อเข้าใช้ผลิตภัณฑ์ของคุณ ให้บอก RolChat ว่าพวกเขาเป็นใคร เพื่อให้บทสนทนาเชื่อมกับผู้ติดต่อที่ถูกต้อง:

window.rolchat.identify({
  email: "alice@example.com",
  first_name: "Alice",
  last_name: "Martin",
  phone: "+15551234567",
  external_id: "user_12345",
  custom_fields: { plan: "pro" },
});

แอตทริบิวต์ที่รับได้คือ email phone first_name last_name external_id และออบเจ็กต์ custom_fields แบบแบน นอกนั้นจะถูกละเว้น RolChat ค้นหาอีเมลใน CRM หากมีผู้ติดต่ออยู่ เซสชันจะเชื่อมกับผู้ติดต่อนั้นและเจ้าหน้าที่จะเห็นโปรไฟล์ หากไม่มี ระบบจะเก็บรายละเอียดไว้และสร้างลีดเมื่อผู้เยี่ยมชมเขียนมาครั้งแรก

เพื่อความน่าเชื่อถือที่สูงขึ้น แบ็กเอนด์ของคุณสามารถลงลายมือชื่อข้อมูลตัวตนได้: ส่งลายมือชื่อที่ RolChat ออกให้ผู้ใช้พร้อมกับแอตทริบิวต์ แล้วเซสชันจะได้รับการยกระดับเมื่อลายมือชื่อผ่านการตรวจสอบเท่านั้น เรียก window.rolchat.reset() เมื่อผู้ใช้ออกจากระบบ ไม่เช่นนั้นคนถัดไปบนเบราว์เซอร์นั้นจะเห็นบทสนทนาก่อนหน้า

JavaScript API

window.rolchat พร้อมใช้งานทันทีที่ stub ทำงาน การเรียกที่เกิดขึ้นก่อนบันเดิลโหลดจะเข้าคิวและทำงานตามลำดับ

เมธอด	ทำอะไร
show() / hide()	แสดงหรือซ่อนปุ่มเปิด
open() / close()	เปิดหรือปิดแผงแชท
identify(traits)	เชื่อมเซสชันกับบุคคล (ด้านบน)
reset()	ลืมข้อมูลตัวตนและเริ่มเซสชันนิรนามใหม่
pushEvent(name, props)	รายงานเหตุการณ์ที่กำหนดเองสำหรับข้อความทริกเกอร์และระบบอัตโนมัติ
trackPageView(path?)	รายงานการดูหน้าในแอปหน้าเดียว
setLocale(code)	เปลี่ยนภาษาของวิดเจ็ต
showConsentPreferences()	เปิดศูนย์การตั้งค่าความยินยอม
on(event, handler) / off(event, handler)	ติดตาม chat:opened chat:closed message:sent message:received session:started

window.rolchat.pushEvent("cart_abandoned", { value: 129.9, currency: "EUR" });
window.rolchat.on("message:received", () => audio.play());

ภาษาและทิศทางข้อความ

วิดเจ็ตใช้ภาษาที่คุณกำหนดด้วย lang ใน window.rolchatConfig (เช่น "lang": "de") หากไม่กำหนด จะใช้ภาษาของเบราว์เซอร์ผู้เยี่ยมชมตามลำดับความชอบของเบราว์เซอร์ โดยเลือกจาก 40 ภาษาที่ RolChat รองรับ และหากไม่ตรงกับภาษาใดเลยจะใช้ภาษาอังกฤษ การตั้งค่าภาษาของไซต์เองไม่ถูกนำมาใช้: หากต้องการให้วิดเจ็ตใช้ภาษาของไซต์ ให้ตั้งค่า lang ภาษาอาหรับและฮีบรูแสดงจากขวาไปซ้าย วิดเจ็ตไม่แปลข้อความของเจ้าหน้าที่ ฝั่งเจ้าหน้าที่สามารถใช้การแปลสดด้วย AI แทนได้

คุกกี้และความยินยอม

วิดเจ็ตไม่ติดตามผู้เยี่ยมชมก่อนได้รับความยินยอมในที่ที่ต้องมีแบนเนอร์ความยินยอม หากคุณใช้โมดูลความเป็นส่วนตัวของ RolChat แบนเนอร์และวิดเจ็ตจะใช้สถานะความยินยอมร่วมกัน หากคุณใช้เครื่องมือความยินยอมอื่น เหตุการณ์การวิเคราะห์ของวิดเจ็ตจะรอสัญญาณที่คุณกำหนดใน การตั้งค่า → ความเป็นส่วนตัว → การฝัง

ตั้งค่าวิดเจ็ตได้ที่ไหน

อะไร	ที่ไหน
สี ตำแหน่ง ข้อความทักทาย จุดเข้าใช้งาน โค้ดติดตั้ง	การตั้งค่า → วิดเจ็ต
โมดูลใดปรากฏในวิดเจ็ต	การตั้งค่า → โมดูล (แยกตามไซต์)
เวลาทำการและข้อความออฟไลน์	การตั้งค่า → ไซต์ → เวลาทำการ
ข้อความทริกเกอร์ที่แสดงบนหน้าเฉพาะ	การตลาด → ทริกเกอร์