เริ่มต้นใช้งาน
Integration overview
One backend, every platform — embed once, and it stays up to date.
AskAIs Customer Service คือ backend เดียวที่มาพร้อม client SDK หลากหลายตัว คุณตั้งค่า workspace เพียงครั้งเดียว จากนั้นก็ฝังแชตได้ทุกที่ ไม่ว่าจะเป็นเว็บไซต์ แอปมือถือ หรือบริการ backend ใดก็ตาม ทุก client เชื่อมต่อไปยัง inbox, AI agent และฐานความรู้เดียวกัน
backend เดียว ครอบคลุมทุกแพลตฟอร์ม
ไม่ว่าคุณจะใช้แพลตฟอร์มใด การติดตั้งก็สั้นกระชับ และบทสนทนา ผู้ติดต่อ การตอบกลับด้วย AI รวมถึงการตั้งค่าต่าง ๆ ล้วนใช้ร่วมกัน ต่อไปนี้คือวิธีติดตั้งของแต่ละแพลตฟอร์ม และที่สำคัญคือวิธีที่แต่ละแพลตฟอร์มได้รับอัปเดตในอนาคต:
ภาพรวมแพลตฟอร์มทั้งหมด
| แพลตฟอร์ม | การติดตั้ง | วิธีอัปเดต |
|---|---|---|
| เว็บไซต์ | <script src="…/widget.js"> | อัตโนมัติ — ทุกครั้งที่โหลดหน้าจะดึงเวอร์ชันล่าสุดมาให้ |
| iOS (Swift) | Swift Package / CocoaPods | อัปเวอร์ชัน SDK แล้วปล่อย build ใหม่ของแอป |
| Android (Kotlin) | Gradle | อัปเวอร์ชัน SDK แล้วปล่อย build ใหม่ของแอป |
| Flutter | pub | อัปเวอร์ชัน SDK แล้วปล่อย build ใหม่ของแอป |
| React Native | npm | อัปเวอร์ชัน SDK แล้วปล่อย build ใหม่ของแอป |
| backend ใดก็ได้ | REST API / OpenAPI | บริการของคุณเอง — อัปเดตเมื่อใดก็ได้ที่คุณ deploy |
SDK ทุกตัวเข้ากันได้หรือไม่?
ได้ ทุกตัวเป็นเพียงทางเข้าที่ต่างกันไปยัง workspace ของ AskAIs Customer Service เดียวกัน จึงทำงานร่วมกันได้อย่างสมบูรณ์:
- backend เดียวกัน app-id เดียวกัน: ทุก client เชื่อมต่อไปยัง inbox เดียวกันใน workspace ของคุณ
- ผู้เยี่ยมชมคนเดียวข้ามหลายอุปกรณ์: ระบุตัวตนด้วย externalId เดียวกัน แล้วแชตที่เริ่มบนเว็บจะดำเนินต่อในแอปของคุณได้
- การตั้งค่าที่ใช้ร่วมกัน: AI agent, ฐานความรู้, เวลาทำการ, การตอบกลับด้วยคำสำคัญ และ FAQ ตั้งค่าเพียงครั้งเดียวและมีผลกับทุกช่องทาง
เว็บ — การฝังอย่างเป็นทางการ (แนะนำ)
เพียงวางบรรทัดนี้ก่อน </body> เท่านี้ก็ติดตั้งเสร็จเรียบร้อย ค่า app-id เป็นข้อมูลสาธารณะและปลอดภัยที่จะนำไปใช้ ก็อปปี้ได้จาก Settings → Inboxes
<script src="https://cs.askais.com/widget.js"
data-app-id="YOUR_APP_ID"
data-base-url="https://cs.askais.com"
async></script>⚠️ อย่าดาวน์โหลดหรือ self-host widget.js
โหลด widget จาก https://cs.askais.com/widget.js เสมอ หากคุณดาวน์โหลดไฟล์ไปโฮสต์เอง หรือคอมไพล์รวมเข้าไปในบันเดิลของคุณ คุณจะตรึงมันไว้ที่เวอร์ชันเดียว ทำให้การอัปเดตสไตล์ การแก้บั๊ก และฟีเจอร์ใหม่ในอนาคตของเราจะไม่มีวันส่งถึงคุณ เมื่อโหลดจาก cs.askais.com ตัว widget จะอัปเดตตัวเองโดยอัตโนมัติ โดยที่คุณไม่ต้องเปลี่ยนแปลงอะไรเลย
ควบคุมจากหน้าเว็บของคุณ (ไม่บังคับ)
หลังจากสคริปต์โหลดเสร็จ จะมี window.SingChat แบบ global ให้ใช้งาน:
// Open / close the widget
window.SingChat.open();
window.SingChat.close();
// Identify a logged-in user (so chats follow them across devices)
window.SingChat.identify({ externalId: "user_123", name: "Ada", email: "ada@acme.com" });แอปมือถือ (iOS / Android / Flutter / React Native)
Native SDK จะถูกคอมไพล์รวมเข้าไปในแอปของคุณ จึงไม่อัปเดตอัตโนมัติเหมือน widget บนเว็บ หากต้องการเวอร์ชันใหม่ ให้อัปเวอร์ชัน SDK ใน package manager ของคุณ แล้วปล่อย build ใหม่ของแอป แนวคิดของการ init เหมือนกันทุกที่ คือชี้ไปที่ https://cs.askais.com และระบุตัวตนด้วย app-id ของคุณ:
// Swift Package Manager
.package(url: "https://github.com/singlink/singlink-ios", from: "0.1.0")
let client = SingChatClient(baseURL: "https://cs.askais.com")
try await client.identify(.deviceAnonymous(appId: "YOUR_APP_ID"))backend หรือภาษาใดก็ได้
ไม่ต้องใช้ SDK — เรียก REST API โดยตรงเพื่อระบุตัวตนผู้ติดต่อและรับ/ส่งข้อความได้เลย นอกจากนี้เรายังเผยแพร่ SDK ที่สร้างขึ้นจากสเปก OpenAPI ของเราสำหรับภาษ กว่า 30+ ภาษา
# Any backend / language — talk to the REST API directly
curl -X POST https://cs.askais.com/api/v1/auth/identify \
-H 'Content-Type: application/json' \
-d '{"appId":"YOUR_APP_ID","externalId":"user_123"}'