快速接入

1. 完成分身设置

先在灵谐中确认默认分身资料完整、云托管状态正常。嵌入网站会使用这个分身回答访客消息。

2. 配置基础信息

进入「开放平台 → 嵌入网站」：

1. 填写名称；不填时显示“客服”。
2. 按需上传消息头像；不上传时使用默认消息气泡头像。
3. 填写允许嵌入的网站来源，例如 https://www.example.com。
4. 使用右侧实时预览检查入口和对话窗口。
5. 打开「启用嵌入网站」并保存。

来源只填写 Origin

填写协议、域名和可选端口，不要带路径、查询参数或结尾页面名。例如填写 https://www.example.com，不要填写 https://www.example.com/help/index.html。

3. 复制代码

保存后，页面会生成类似下面的代码。请以你页面实际生成的内容为准：

<script
  defer
  src="https://lingxie.net/widget/v1/loader.js"
  data-widget-id="ww_example"
  data-api-base="https://chat.example.com"
></script>

把它放到网页 </body> 前。一个页面只嵌入一次。

4. 验证

1. 从允许来源中的网站打开页面。
2. 确认入口出现在配置的左下角或右下角。
3. 打开对话，检查名称、头像、主题色和欢迎语。
4. 发送一条测试消息，确认出现本地时间并收到回复。
5. 刷新网页，确认历史消息仍可读取。

5. 上线前检查

• 正式域名已加入允许来源，测试域名可按需删除。
• 页面没有重复加载嵌入脚本。
• 网站的内容安全策略允许加载灵谐脚本和 iframe。
• 桌面端和移动端都完成打开、发送和关闭测试。