網站嵌入

一行 script 把聊天視窗放到網站上，以及頁面上可以呼叫的方法和語言規則。

下文的 {API} 指服務位址，可在後台「接入」頁面看到。

<script src="{API}/static/aics-widget.js" data-key="pk_xxx" data-api="{API}" async></script>

data-key 是公開 Key，在後台「接入」頁面複製。
在「接入」頁面登記允許嵌入的網站（例如 https://shop.example.com），其他網站拿到你的公開 Key 也無法使用。上線前務必填寫。
可選 data-theme="dark" 使用深色樣式。
可選 data-language="de"：當網站本身是多語言時，把目前頁面的語言傳進來，客服預設使用這個語言（訪客仍可切換）。支援的語言代碼請見開放 API 概覽。
可選 data-language="auto"：取頁面 <html lang> 作為預設語言，之後頁面切換語言（修改 lang 屬性，單頁應用不重新整理也行）客服視窗會自動跟著切換。

頁面上可以呼叫：

方法	作用
`AICS.open()` / `AICS.close()` / `AICS.toggle()`	開啟、關閉客服視窗，例如放在「聯絡客服」按鈕上
`AICS.identify(userToken)`	顧客登入後告訴客服他是誰（見識別登入顧客）
`AICS.setLanguage(code)`	網站切換語言時呼叫，客服視窗和之後的回答會跟著切換，例如 `AICS.setLanguage("ja")`；也接受 `zh-Hans`、`pt-BR` 這類寫法
`AICS.reset()`	顧客登出時呼叫：卸載客服視窗、丟棄目前工作階段；再載入一次指令碼就是匿名的新視窗，下一個人看不到上一位的對話

語言

客服視窗會依訪客所在地（IP）顯示對應語言，包括介面文字和歡迎語；設定 data-language 時優先使用頁面語言。無法判斷所在地時，使用後台設定的「預設語言」。
AI 會跟隨顧客使用的語言回答；顧客傳送的內容看不出語言時（表情符號、訂單編號），使用上面判斷出的語言。
顧客可以在視窗頂端的語言選單中切換，也可以直接對 AI 說「請用英文回答」。之後 AI 會一直使用這個語言，即使顧客用其他語言書寫。
網站切換語言（AICS.setLanguage，或 data-language="auto" 時修改 <html lang>）也算顧客的選擇，與上面幾種方式一樣以最後一次為準；只是開啟頁面時所帶的預設語言不會覆蓋顧客選過的語言。
後台「機器人設定 → 語言」可以關閉依 IP 判斷、修改預設語言、限制開放哪些語言。
部署在反向代理或 CDN 後方時，需要在伺服器端設定 TRUSTED_PROXIES 或 COUNTRY_HEADER，否則無法取得訪客的真實 IP。

這頁對你有幫助嗎？

最後更新: 2026年10月31日