คู่มือสำหรับนักพัฒนา
Kavchat คือแชทบริการลูกค้าที่ตอบตามสคริปต์ที่คุณเขียน โดยไม่มีโมเดลภาษา สคริปต์ที่เผยแพร่จะทำงานบนอุปกรณ์ของผู้ใช้ จึงตอบได้รวดเร็ว คาดเดาได้ และยังทำงานได้แม้ไม่มีอินเทอร์เน็ต ที่นี่จะอธิบายว่าส่วนต่างๆ ทำงานร่วมกันอย่างไร และควรเริ่มจากตรงไหน
โครงสร้างของ Kavchat
- แดชบอร์ด คุณและทีมเข้าสู่ระบบได้ที่ app.kavchat.com แต่ละพื้นที่ทำงานมีคีย์สาธารณะ (
pk_live_...) และคีย์ลับ (sk_live_...) ซึ่งแสดงอยู่ในหน้า ติดตั้ง - สคริปต์ สร้างสคริปต์จากขั้นตอนต่างๆ ในเครื่องมือแก้ไขแบบภาพ แต่ละขั้นตอนมีข้อความ ปุ่ม และคำสำคัญ ปุ่มจะนำไปยังขั้นตอนอื่น สคริปต์อื่น ลิงก์ หน้าจอในแอปของคุณ หรือแบบฟอร์มติดต่อ
- การเผยแพร่ การเผยแพร่แต่ละครั้งจะบันทึกเป็นเวอร์ชันที่มีหมายเลข คุณกำหนดได้ว่าใครจะเห็นบอต: ไม่แสดงให้ใครเห็น แสดงเฉพาะผู้ทดสอบ (ตามหมายเลขโทรศัพท์) หรือแสดงให้ทุกคนเห็น สามารถกู้คืนเวอร์ชันก่อนหน้าได้ทุกเมื่อโดยไม่ต้องอัปเดตแอป
- วิดเจ็ตหรือ SDK เว็บไซต์โหลดวิดเจ็ตด้วยคีย์สาธารณะ ส่วนแอปใช้ SDK สำหรับมือถือชุดใดชุดหนึ่ง ทั้งวิดเจ็ตและ SDK จะดาวน์โหลดเวอร์ชันที่เผยแพร่ เก็บไว้บนอุปกรณ์ และจัดการบทสนทนาบนอุปกรณ์นั้น
- โทเคนระบุตัวตน (ไม่บังคับ) เมื่อผู้ใช้เข้าสู่ระบบแล้ว เซิร์ฟเวอร์ของคุณจะลงลายเซ็น JWT สั้นๆ ด้วยคีย์ลับ Kavchat จึงเชื่อมโยงรหัสผู้ใช้ของคุณกับบทสนทนาและคำร้องได้ และสามารถแสดงบอตที่เปิดให้เฉพาะผู้ทดสอบแก่ผู้ใช้ที่ถูกต้อง
- คำร้องและ webhook เมื่อสคริปต์แก้ปัญหาไม่ได้ แบบฟอร์มติดต่อจะสร้างคำร้องพร้อมบทสนทนาทั้งหมด คำร้องจะปรากฏในกล่องคำร้องบนแดชบอร์ด และสำหรับแพ็กเกจ Premium จะส่งไปยังระบบของคุณผ่าน webhook ที่ลงลายเซ็นด้วย เซิร์ฟเวอร์ของคุณยังอ่านและปิดคำร้องผ่าน Server API ได้
คีย์สองแบบ ใช้คนละที่
| คีย์ | ใช้ที่ไหน | ใช้ทำอะไร |
|---|---|---|
คีย์สาธารณะ pk_live_... | ในหน้าเว็บไซต์และแอป เปิดเผยได้ | โหลดบอต รายงานลำดับการสนทนา และสร้างคำร้อง |
คีย์ลับ sk_live_... | บนเซิร์ฟเวอร์ของคุณเท่านั้น ห้ามใส่ไว้ในเบราว์เซอร์หรือแอป | ลงลายเซ็นโทเคนระบุตัวตน ตรวจสอบ webhook และเรียกใช้ Server API |
เริ่มต้นอย่างรวดเร็ว
สำหรับเว็บไซต์ เพียงวางบรรทัดนี้ก่อน </body> คัดลอกบรรทัดพร้อมคีย์ของคุณได้จากหน้า ติดตั้ง บนแดชบอร์ด:
<script src="https://cdn.kavchat.com/v1/kavchat.js" data-key="pk_live_..." async></script>เผยแพร่สคริปต์ เปิดบอตให้ทุกคนใช้งาน (หรือเฉพาะหมายเลขโทรศัพท์ของผู้ทดสอบ) แล้วรีเฟรชหน้าเว็บ
คู่มือ
ปุ่มและคำถาม
ใช้ปุ่มข้อความสั้นและคำถามเต็มประโยคในแต่ละขั้นตอน พร้อมช่องค้นหาเมื่อมีหลายหัวข้อ
วิดเจ็ตเว็บไซต์
โค้ดบรรทัดเดียว พร้อมอินเทอร์เฟซ JavaScript ที่เลือกใช้ได้ อีเวนต์ และ CSP
React Native
Provider, หน้าแชท และปุ่มลอย ใช้ได้กับทุกแอป React Native (ตั้งแต่เวอร์ชัน 0.72) ไม่ว่าจะใช้ Expo หรือไม่
Flutter
ตัวควบคุม ปุ่มลอย และหน้าแชท พร้อมรองรับ RTL ในตัว
iOS
แพ็กเกจ Swift พร้อมคอมโพเนนต์ SwiftUI และ UIKit สำหรับ iOS 15 ขึ้นไป
Android
คอมโพเนนต์ Jetpack Compose และ Activity สำหรับแอป Views สำหรับ API 23 ขึ้นไป
ระบุตัวผู้ใช้
ลงลายเซ็นโทเค็นอายุสั้นบนเซิร์ฟเวอร์ มีตัวอย่างใน 7 ภาษา
Webhook
ทุกคำร้องใหม่ส่งตรงเข้าระบบของคุณพร้อมลายเซ็น สำหรับ Premium
Server API
คำร้อง รายงาน กลุ่มเป้าหมาย และเวอร์ชัน จากเซิร์ฟเวอร์ของคุณโดยตรง
ต้องการความช่วยเหลือ?
ติดต่อเราได้ที่ support@kavchat.com รายละเอียด API ทั้งหมดอยู่ในไฟล์ openapi.yaml (OpenAPI 3.1)