Integration overview

AskAIs คือ backend เดียวที่มาพร้อมวิธีเชื่อมต่อหลากหลาย คุณตั้งค่า workspace เพียงครั้งเดียว จากนั้นก็ฝังแชตได้ทุกที่ ไม่ว่าจะเป็นเว็บไซต์ แอปมือถือ หรือบริการ backend ใดก็ตาม ลูกค้ายังติดต่อคุณผ่านช่องทางขาเข้าอย่าง Telegram และ WhatsApp ได้ด้วย ทุก client และทุกช่องทางเชื่อมต่อไปยัง inbox, AI agent และฐานความรู้เดียวกัน

backend เดียว ครอบคลุมทุกแพลตฟอร์ม

ไม่ว่าคุณจะใช้แพลตฟอร์มใด การติดตั้งก็สั้นกระชับ และบทสนทนา ผู้ติดต่อ การตอบกลับด้วย AI รวมถึงการตั้งค่าต่าง ๆ ล้วนใช้ร่วมกัน ต่อไปนี้คือวิธีติดตั้งของแต่ละแพลตฟอร์ม และที่สำคัญคือวิธีที่แต่ละแพลตฟอร์มได้รับอัปเดตในอนาคต:

ภาพรวมแพลตฟอร์มทั้งหมด

client และช่องทางทั้งหมดทำงานร่วมกันได้ไหม?

ได้ ทุกตัวเป็นเพียงทางเข้าที่ต่างกันไปยัง workspace ของ AskAIs เดียวกัน จึงทำงานร่วมกันได้อย่างสมบูรณ์:

• backend เดียวกัน app-id เดียวกัน: ทุก client เชื่อมต่อไปยัง inbox เดียวกันใน workspace ของคุณ
• ผู้เยี่ยมชมคนเดียวข้ามหลายอุปกรณ์: ระบุตัวตนด้วย externalId เดียวกัน แล้วแชตที่เริ่มบนเว็บจะดำเนินต่อในแอปของคุณได้
• ไม่ใช่แค่การฝัง แต่มีช่องทางขาเข้าด้วย: นอกจาก widget บนเว็บและในแอปแล้ว ลูกค้ายังติดต่อคุณผ่าน Telegram และ WhatsApp ได้ (ทั้งคู่ใช้งานได้แบบ end to end) และทุกข้อความจะมารวมที่ inbox เดียวกัน อีกทั้งช่องสำหรับ X ก็พร้อมแล้ว
• การตั้งค่าที่ใช้ร่วมกัน: AI agent (โฮสต์บนแพลตฟอร์มหรือใช้คีย์ของคุณเอง), ฐานความรู้, เวลาทำการ, การตอบกลับด้วยคำสำคัญ และ FAQ ตั้งค่าเพียงครั้งเดียวและมีผลกับทุกช่องทาง

เว็บ การฝังอย่างเป็นทางการ (แนะนำ)

เพียงวางบรรทัดนี้ก่อน </body> เท่านี้ก็ติดตั้งเสร็จเรียบร้อย ค่า app-id เป็นข้อมูลสาธารณะและปลอดภัยที่จะนำไปใช้ ก็อปปี้ได้จาก Settings → Inboxes

<script src="https://singchat.org/widget.js"
        data-app-id="YOUR_APP_ID"
        data-base-url="https://singchat.org"
        async></script>

⚠️ อย่าดาวน์โหลดหรือ self-host widget.js

โหลด widget จาก https://singchat.org/widget.js เสมอ หากคุณดาวน์โหลดไฟล์ไปโฮสต์เอง หรือคอมไพล์รวมเข้าไปในบันเดิลของคุณ คุณจะตรึงมันไว้ที่เวอร์ชันเดียว ทำให้การอัปเดตสไตล์ การแก้บั๊ก และฟีเจอร์ใหม่ในอนาคตของเราจะไม่มีวันส่งถึงคุณ เมื่อโหลดจาก singchat.org ตัว 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" });

แอปมือถือ: Flutter SDK หรือการฝังด้วย WebView

สำหรับมือถือมีวิธีจริงอยู่สามทาง หนึ่ง Flutter widget SDK แบบเนทีฟให้ UI แชตที่ครบถ้วนและปรับธีมได้ (ปุ่มลอยและหน้าจอแชตแบบเนทีฟ ไม่ใช่ WebView) เพียงเพิ่มลงใน pubspec แล้วปล่อยแอป สอง บน iOS และ Android (รวมถึง React Native) คุณฝัง widget บนเว็บแบบเต็มรูปแบบไว้ใน WebView ได้ ได้ประสบการณ์เหมือนบนเว็บไซต์ และมันอัปเดตตัวเองอยู่เสมอ สาม เรียกใช้ REST API พร้อม webhook ที่ลงลายเซ็น แล้ววาด UI ของคุณเอง ไม่มี SDK แชตเนทีฟแยกสำหรับ iOS, Android หรือ React Native ให้ติดตั้ง และนี่คือช่องทางที่รองรับ

# Flutter, native chat widget (floating bubble + native chat UI, not a WebView).
# In your app's pubspec.yaml (download and unzip the SDK package first):
dependencies:
  singchat_widget:
    path: ../singchat_widget

# iOS / Android / React Native without Flutter: load the hosted web widget in a
# WKWebView / WebView (same experience as the website), or drive the REST API
# with signed webhooks and render your own chat UI.

backend หรือภาษาใดก็ได้

ไม่ต้องใช้ SDK เรียก REST API โดยตรงเพื่อระบุตัวตนผู้ติดต่อและรับ/ส่งข้อความได้เลย และตรวจสอบเหตุการณ์ขาเข้าด้วย webhook ที่ลงลายเซ็น ทั้ง API เป็นไปตามสเปก OpenAPI ที่เผยแพร่ไว้ คุณจึงสร้าง client ในภาษาของคุณเองได้ หรือจะเรียก endpoint โดยตรงก็ได้

# Any backend / language, talk to the REST API directly
curl -X POST https://singchat.org/api/v1/auth/identify \
  -H 'Content-Type: application/json' \
  -d '{"appId":"YOUR_APP_ID","externalId":"user_123"}'

เจาะลึกเพิ่มเติม

• Web widget เอกสารอ้างอิงฉบับเต็ม (events, การกำหนดธีม, ความปลอดภัย)
• มือถือ Flutter SDK และการฝังด้วย WebView
• SDK และสเปก OpenAPI
• เอกสารอ้างอิง REST API