09 接入插件

网站和 App 用同一套契约。聊天窗仍是现网那套。

插件是薄壳,不重做气泡。网站用命令队列,脚本没加载完也能 open / identify。App 用官方 WebView 壳。WordPress 和 npm 只填站点 ID。密钥仍走后台,不要写进前端。

网站

命令队列,脚本没就绪也不丢调用

接入代码「网站」默认给命令队列。贴脚本前后都能 aics('open')。旧的 data-site 一行写法继续可用。登录用户在首条消息前认人;值班台能看到显示名和订单号,访客气泡不会出现「已识别」字样。

  • init / open / close / toggle / send / openStaff
  • identify 只传用户 id 和显示名,禁止 token、密码、手机号、邮箱
  • setContext 可带当前页、订单号、SKU,纯展示
  • 事件 ready open close handoff unread
  • CSP 严的站可用 iframe 模式,会话面板进本站 chat.html
接入代码弹窗:网站命令队列、入口样式与帮助中心地址

App · CMS · npm

官方薄壳,不画消息气泡

App 继续打开现网全屏客服页。仓库 plugins/ 提供 Android、iOS、Flutter、uni-app、React Native 封装:键盘、返回、tel:、关闭桥不用每端重写。WordPress 在设置页填站点 ID,页脚注入队列。npm 包 @qianqianai/aics 只发 loader,运行时仍拉现网挂件。

AppWebView 打开 chat.htmlchrome=native 由原生导航关闭。
小程序业务域名 + web-view;仓库有邀请页示例。
WordPress不在 CMS 里存模型密钥或开放 API Bearer。
Shopify主题手工贴脚本。不接管 Inbox。
自有入口与渠道对接:网站、App 与第三方平台分开配置

Boundary

插件管自有站和自有 App

微信、拼多多仍走渠道对接。开放 API 给后端,不给浏览器。片段在登录后从「接入代码」复制。

域名未登记 Hosts 时访客页不弹红条;控制台可见 host_denied。运营可一键批准待登记域名。
密钥前端没有 apiKey。鉴权继续靠登记域名 Origin。
不做原生气泡 SDK、自动放行任意域名、把值班台嵌进访客插件。
外观颜色和入口样式仍由后台保存,不在插件里写死。

Next

片段在后台,渠道和密钥分开取

Start

登录后台,选站点,再复制插件片段

真实站点 ID 和脚本按已登记域名生成。公开页只说明能力,不放可复制密钥。