01
运营后台管站点与知识，系统设置管密钥与成员，值班台管接待。不要混用入口。
/admin/ 建站点、写知识、看访问分析、复制接入代码。
/system/ 对话模型、成员、渠道对接、值班默认、开放应用。密钥仅超管可见。
/duty/ 选电脑或手机。座席账号不能进管理后台取脚本。
热线 400-656-3113。许可见 非商业开源许可。
02
公开页面不展示可复制脚本。每个站点的片段按已登记域名生成，必须登录后从后台复制。
| 渠道 | 怎么接 |
|---|---|
| 网站 | 把 widget.js 插到已登记 Hosts 页面的 </body> 前。接入代码「网站」默认给命令队列；data-site 仍是简写 |
| 接入插件 | 网站 aics() / identify；App 官方壳、WordPress、npm。说明见 接入插件 |
| 公众号 | 全屏 H5 /chat.html?site=站点ID&channel=mp，或在渠道对接填密钥走原生消息 |
| 小程序 | 业务域名填 aics.qianqianai.com，web-view 打开接入代码里的地址 |
| App 访客 | 系统 WebView 打开 /chat.html?site=站点ID&channel=app，官方壳见仓库 plugins/，不要嵌座席工作台 |
| 站点帮助中心 | 访客文章地址 /help/?site=站点ID，内容来自该站已发布知识 |
形态如下（把站点 ID 换成后台里的标识）：
<script src="https://aics.qianqianai.com/widget.js" data-site="站点ID" async></script>
登录用户请在首条消息前 identify，只传用户 id 和显示名。不要把开放 API 密钥写进网页。功能介绍见 接入插件。
网站四种样子：圆形气泡、底部咨询条、侧边标签、卡片入口。颜色和左右位置在同一弹窗里选，保存后下次打开生效。
企业微信、微信客服、拼多多、抖音、快手：在系统设置「渠道对接」绑定密钥与回调。买家仍在原对话框收消息。完整名单见 对接平台。
03
浏览器会带 Origin。必须是该站 Hosts 里的域名，含子域。
| 现象 | 先核对 |
|---|---|
| 气泡不出现 | 页面里没有 widget.js，或 CSP / 广告拦截挡了脚本；站点未启用 |
| 能看见气泡，一发就失败 | 当前域名没写进该站 Hosts。登记 example.com 可覆盖 www.example.com |
| 贴到了 localhost | 本地调试也要把 localhost 或 127.0.0.1 写进 Hosts，否则没有 CORS 头 |
| 答了另一套知识 | data-site 贴错了站点 ID |
| 样式不对 | 在接入代码弹窗改，不要改 widget.js 本身 |
本站 /chat.html 按 site 标识放行，不靠 Origin。
04
每个接入站点一套独立知识，互不检索。应答顺序固定：FAQ 精确匹配 → 向量检索 → 站点大模型。
/help/?site=站点ID。未公开文档仍可被内部检索。05
电脑、手机、App 用同一套座席账号，入口不同。答不了再排队转人工；下班走留言。
| 入口 | 地址 | 用途 |
|---|---|---|
| 入口一览 | /duty/ | 选电脑还是手机 |
| 电脑值班台 | /desk/ | 完整接待：转接、备注、质检、关单 |
| 手机网页 | /agent/ | 轻量接单与回复 |
| Android 座席 App | 包名 com.qianqianai.aics.agent | 锁屏推送、转接、内部备注。说明见 Android 座席 |
| 客服中心 | /center/ | 客户档案、商机、通知短信与智能回拨 |
座席账号不能进管理后台改知识或取接入脚本。
06
只发云厂商已审模板，做客服通知，不是营销群发。开放 API / MCP 不包含发短信。
06b
本地模板 + 队列投递，做客服通知，不是默认同站群发。通道可选腾讯云邮件推送 SES 或自建邮箱 SMTP。开放 API / MCP 不包含发邮件。
{name} 插入客户字段；点击跳转默认是项目主页，可改。07
对值班台离线留言做任务制 AI 回拨。接通走同一套知识库；说转人工就回值班台。不是预测式外呼。
不从导入名单群呼，没有 IVR 热线。功能页：智能回拨。
08
| 运营后台 /admin/ | 系统设置 /system/ | |
|---|---|---|
| 知识、接入代码、访问分析 | 是 | 否 |
| 对话模型、检索阈值、限流 | 否 | 是 |
| 成员、值班默认、健康巡检 | 否 | 是 |
| 开放应用密钥 | 否 | 是 |
09
REST 和 MCP 是两套独立说明页，不要把管理后台 Cookie 或 /api/admin 开放给三方。密钥在系统设置 → 开放应用签发，明文只显示一次。站点须打开「开放 API / MCP」渠道。