AskAIs串接總覽
目前連接 AskAIs 的幾種方式：你的網站、你的 App、Telegram 和 AI 客戶端。
程式碼中的
window.SingChat等是掛件與 API 的技術名稱，請原樣保留。
AskAIs 是託管服務：你的工作區、收件匣、AI 客服和知識庫都在 askais.com 上。你可以用下面幾種方式讓客戶聯絡到它，所有對話都會進入同一個共用收件匣，由同一個 AI 客服用相同的知識和設定來回答。
連接方式
| 在哪裡 | 如何連接 | 更新 |
|---|---|---|
| 你的網站 | 一個 <script> 標籤 | 無需更新：每次載入頁面都會取得目前版本的聊天視窗 |
| 你的 iOS、Android、Flutter、React Native 或桌面 App | 用 WebView 開啟你的聊天頁面 | 無需更新：WebView 會載入目前版本的聊天視窗 |
| Telegram | 在設定 → 渠道裡填入機器人 token | 無需更新 |
| Claude Code、Cursor 或 Gemini CLI（給你的團隊使用） | MCP 伺服器，搭配 MCP 金鑰 | 無需更新 |
你的網站
把這段程式碼加到 </body> 之前。App ID 在設定 → 收件匣與聊天框外觀裡複製；它是公開的，可以放心發布。
<script src="https://askais.com/widget.js"
data-app-id="YOUR_APP_ID"
data-base-url="https://askais.com"
async></script>⚠️ 從 askais.com 載入 widget.js
不要下載 widget.js，也不要把它打包進你自己的程式碼。從 askais.com 載入，它一律執行目前的版本；複製下來的副本會停在當時的版本，之後的每一個修正和新功能都用不到。
手機與桌面 App
不需要安裝任何 SDK。在 WebView 裡開啟 https://askais.com/api/widget-embed?appId=YOUR_APP_ID，你的 App 就會全螢幕顯示和網站上一樣的聊天。把已登入使用者的 ID、Email 和名字加到網址上，你的團隊就知道在跟誰對話。「App 內聊天」頁面有完整指南，並附上 Flutter、iOS、Android 和 JavaScript 的程式碼。
已登入訪客與身分驗證
對於已登入的使用者，傳入 externalId、email 和 name，他們的對話就能跨裝置延續。為了防止有人冒充其他使用者，還要傳入 hmac：在你的伺服器上、以收件匣密鑰對 externalId 計算出的 HMAC-SHA256。「網站聊天視窗」頁面有具體做法。
Telegram
用 @BotFather 建立一個機器人，把它的 token 貼到設定 → 渠道裡並連接。傳給機器人的訊息會進入同一個收件匣，由 AI 客服和你的團隊回覆。
AI 客戶端（MCP）
MCP 伺服器讓 Claude Code、Cursor 或 Gemini CLI 操作你的工作區：閱讀和回覆對話、訓練 AI、編輯 FAQ、查看數據統計。它是給你和團隊用的，不是給客戶用的。MCP 金鑰由工作區的擁有者或管理員建立。
目前不提供
- 可安裝的 SDK 套件（npm、pub.dev、CocoaPods、Gradle）。網站請用 script 標籤，App 請用 WebView 頁面。
- 供你自己的後端呼叫的公開 REST API。API 金鑰只有 MCP 伺服器接受。
- 對話或訊息事件的 Webhook。設定 → Webhook 可以儲存一個端點並送出帶簽章的測試 ping，但目前還不會傳送任何事件。
- 用來開啟、關閉或監聽聊天視窗的 JavaScript 方法。
window.SingChat.start()是 script 提供的唯一方法。