跳到主要内容

🌐 网页聊天小部件

网页聊天小部件是一个可嵌入的 JavaScript 聊天气泡，可以添加到任何网站。当访客通过小部件发送消息时，消息会像其他频道一样出现在 PulseHub 的收件箱中。

将小部件添加到您的网站​

1. 在 PulseHub 中添加网页聊天频道​

  1. 前往 Channels → Add Channel
  2. 选择 Web Chat Widget
  3. 输入名称和可选的问候语/颜色
  4. 点击 Save Channel
  5. 记下卡片上的 Channel ID

2. 嵌入脚本​

<script
  src="https://yourdomain.com/public/js/webchat-widget.js"
  data-channel="YOUR_CHANNEL_ID"
  data-greeting="Hi! How can we help you today?"
  data-color="#10b981">
</script>

小部件配置选项​

属性默认值描述
data-channel必填PulseHub 中的频道 UUID
data-greetingHi! How can we help you?聊天首次打开时显示的消息
data-color#10b981按钮和已发送消息的十六进制颜色

会话工作原理​

小部件在 localStorage 中存储两个值：

  • ph_contact_{channel_id} — 联系人的 UUID
  • ph_conv_{channel_id} — 会话的 UUID

这意味着关闭标签页后返回的访客将继续同一对话。

跨域请求​

如果 PulseHub 与您的网站位于不同域名，请添加 CORS 头：

<IfModule mod_headers.c>
    Header set Access-Control-Allow-Origin "https://yourwebsite.com"
    Header set Access-Control-Allow-Methods "GET, POST, PATCH, DELETE, OPTIONS"
    Header set Access-Control-Allow-Headers "Content-Type, X-Webchat-Channel"
</IfModule>

安全提示​

当 X-Webchat-Channel 头存在时，网页聊天 API 端点接受未经认证的用户请求。请确保在 Web 服务器或防火墙级别进行速率限制。