网页组件
网页组件让你在自己的网站上嵌入一个悬浮客服按钮，访客点击即可与 AI 对话。嵌入代码不含 API Key，安全可靠。
网页组件为专业版 / 旗舰版能力，基础版未开放。专业版最多 2 个、旗舰版最多 10 个组件。
接入步骤
- 进入 外部拓展 → 网页组件，新建一个组件。新建出来的是草稿（功能开关默认关闭），先配置、确认无误后再启用。
- 填写组件名称（如「官网售前客服」）。
- 填写允许显示的域名——这是启用组件的前置条件。留空时组件会对任意站点放行，而嵌入代码里的 token 在网页源码中可见，第三方站点拿去即可消耗你的额度。支持通配符（如
*.example.com）或每行一个域名。 - 打开功能开关——开启后嵌入网站的组件才显示并可用。未填域名时开关无法保存，会提示先填域名。
- 复制生成的嵌入代码，粘贴到你网站的页面中。
- 打开网站验证悬浮按钮与回答是否正常。
已启用的组件不能把域名清空保存；确需清空请先关闭功能开关。
可配置项
- 人工客服：开关。关闭后，组件弹窗内隐藏「人工客服」按钮，访客也无法通过对话触发转人工。
- 启用自动转接人工：当 AI 回复命中你设置的拦截短语（如「无法回答」类话术）时，自动转接人工并向访客显示转接提示，而不是把 AI 的原始回复展示出来。留空则用默认拦截短语。
- 开启追问：允许 AI 主动追问以澄清需求。需先在系统设置中全局开启「开启追问」，此处开关才可用；全局关闭时本开关禁用、访客端不显示追问气泡。
- 关联 API Key：可选，关联一个 API 密钥（用于对话统计、转人工等；不受系统设置 → 开放 API 权限中 v1 白名单限制，组件本身走 widget_token 鉴权）。
与开放 API 权限的关系
网页组件不经过 /api/v1/chat，因此系统设置里的「AI 会话」开关与白名单不影响组件访客对话。若某 Key 仅用于组件、不对外提供 v1 集成，无需将其加入开放 API 白名单。
上线前检查
- [ ] 允许显示的域名已填写，且覆盖全部要嵌入的站点（含二级域名，必要时用
*.example.com）。 - [ ] 组件「功能开关」已打开。
- [ ] 悬浮按钮在桌面端与移动端都正常。
- [ ] 常见问题回答准确，已通过试聊验证。智能体若绑了技能，可用汇率 / HS 等真实问法再验一遍。
- [ ] 人工客服 / 自动转接策略符合预期。