集成指南

使用您偏好的框架将 LaunchChat 组件添加到网站。

安装

将此代码添加到 </body> 标签之前:

<!-- LaunchChat Widget -->
<script>
  window.LaunchChatConfig = {
    widgetId: "YOUR_WIDGET_ID"
  };
</script>
<script src="https://your-domain.com/widget.js" async></script>

内容安全策略(CSP)

如果您的网站使用 CSP 头,请添加以下域名:

Content-Security-Policy:
  script-src 'self' https://your-launchchat-domain.com;
  connect-src 'self' https://your-launchchat-domain.com;
  frame-src 'self' https://your-launchchat-domain.com;

安全注意事项

Widget ID 是公开的

Widget ID 设计为公开使用,可嵌入到客户端代码中。它仅允许读取知识库和使用聊天功能。仅凭 Widget ID 无法执行任何敏感操作。

域名限制

您可以在控制台的 组件 → 行为 → 允许的域名 中限制哪些域名可以嵌入您的组件。设置后,组件仅在这些域名上生效。

验证安装

添加代码后,验证组件是否正确加载:

  1. 在浏览器中打开您的网站
  2. 在右下角查找聊天按钮
  3. 点击打开聊天窗口
  4. 发送一条测试消息以验证是否正常工作

如果组件未显示,请检查浏览器控制台是否有错误,并确认 Widget ID 是否正确。