网站嵌入

一行 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日