如何使用

面向想在自己网站上线一个语音客服入口的业务方：不需要写代码对接 HTTP API，只要注册一个账号、配置一个 Agent、把一小段 <script> 贴到自己的网站里，四步就能跑起来。

这里讲的是网页控制台 + 嵌入脚本这条最省事的路径。如果你想直接调 HTTP API 自己搭一套发起/查询通话的系统（比如批量外呼任务），看 API 集成文档。

想先看效果再动手？打开 /demo，这是本服务自带的一个模拟客户网站，页面右下角就是嵌入进去的「语音客服」按钮，接入方式跟下面这四步完全一样（源码见仓库 demo/customer_site）。照着做一遍，就能在自己的网站上做出跟它一样的效果。

注册账户

打开账号中心，用邮箱注册一个账号并登录。这个账号后面会用来创建、管理你的 Agent，网页控制台的操作都基于登录态，不需要额外生成 API Key——只有当你要走 HTTP API 直接对接自己的系统时（见 API 文档）才需要用到 Key。
创建 Agent

登录后打开 Agent 控制台，点右上角的「创建语音助理」，填写它的人设（昵称、性格、语气）、音色，以及最重要的两项：
- 知识库 / 通话指导——它接电话时该知道什么、该怎么应对；
- 允许嵌入的网站域名——填你自己网站的域名（比如 https://your-site.com），只有在这个白名单里的网站才能把它嵌进去，其他网站盗用这段代码也打不通电话。
创建完成后，进入这个 Agent 的详情页，能看到一段「嵌入到自己网站的代码」，下一步直接复制它就行。域名填错了或者后面要换一个网站用，回到详情页编辑「允许嵌入的网站域名」重新保存即可，改动立即生效。
在自己的网站嵌入 Agent 脚本

把 Agent 详情页里的那段代码，原样贴到你自己网站页面的 <body> 里（放在哪个位置都行，不影响其它内容），大致长这样：
```
<script src="https://your-deployment.example.com/call/static/widget.js"
        data-agent-key="ag_xxx" async></script>
```
页面右下角就会出现一个悬浮的圆形头像按钮——头像就是这个 Agent 在控制台里配的头像（没配的话用性别兜底图），不需要额外设置。位置不满意的话可以加两个属性调整：
```
<script src="https://your-deployment.example.com/call/static/widget.js"
        data-agent-key="ag_xxx"
        data-position="bottom-left"
        data-offset-x="24" data-offset-y="24" async></script>
```
data-position 支持 bottom-right（默认）/ bottom-left / top-right / top-left； data-offset-x/data-offset-y 是相对该角的像素偏移，不填默认各 20px。访客点击按钮后会先弹出一个待接听面板，再点一次「接听」才会真正请求麦克风权限、建立通话——浏览器的自动播放/录音策略要求这样一次明确的用户手势，不能做成打开页面就自动接通。

换了一个没在白名单里的域名打开同一段代码，点击按钮不会有反应（浏览器控制台会看到具体的 403 报错）——这就是第二步里配的域名白名单在起作用，不是接错线了。
开始测试

回到自己的网站，点一下「语音客服」按钮，走一遍完整流程：接听、说几句话、挂断。听听 Agent 的应答是否符合预期，不满意就回 Agent 控制台调整人设/知识库/ 通话指导，保存后立即对后续新通话生效，不需要重新贴代码，反复调整几轮直到满意为止。

如何使用

注册账户

创建 Agent

在自己的网站嵌入 Agent 脚本

开始测试