指南

聊天组件自定义

让聊天组件与你的品牌相匹配。在后台自定义颜色、Logo、消息和行为——无需修改代码。

如何自定义

控制聊天组件在你网站上外观的视觉设置。启动按钮可以使用以下两种样式之一：

设置	说明	默认值
启动按钮样式	选择 Logo 使用自定义图片，或选择“图标”使用 Sonny 内置的启动按钮图标之一。	`图标`
聊天组件 Logo	当启动按钮样式为 Logo 时显示。上传小于 2MB、至少 64x64px 的 JPEG、PNG、GIF 或 WebP 图片。	`无自定义 Logo`
选择图标	当启动按钮样式为“图标”时显示。选择启动按钮使用的内置图标。	`聊天气泡`
图标颜色	使用取色器或 6 位十六进制值设置所选启动按钮图标的颜色。	`#ffffff`
品牌颜色	应用于启动按钮、聊天标题栏、发送按钮和发出的消息气泡。	`#2563eb`
组件位置	选择聊天组件显示在页面的右下角还是左下角。	`右下角`

自定义访客与聊天组件互动时看到的文字。

欢迎消息: 访客打开聊天组件时，显示在聊天窗口顶部的文字。用它为对话定下基调。; 默认：“您好！有什么可以帮您？” · 最多 500 个字符
在线消息: 至少有一位客服在线时，显示在聊天标题栏中的状态文字，旁边带有绿色指示点。; 默认：“我们通常几分钟内回复” · 最多 500 个字符
离线消息: 没有客服在线时，显示在聊天标题栏中的状态文字，旁边带有灰色指示点。; 默认：“我们暂时不在——请留言，我们会尽快回复您” · 最多 500 个字符

控制聊天组件对访客行为的设置。

邮箱询问时机: 控制何时向访客询问姓名和邮箱。选择“第一条消息之前”可要求先提供联系信息；选择“第一条消息之后”（默认）则让访客立即开始聊天，之后再收集他们的信息。
聊天前调查: 在聊天开始前询问访客的信息。开启后，使用必填字段选择姓名、邮箱或两者。至少要保留一个字段。
工作时间: 设置一周中每天的营业时间。只有在这些时间内有客服在线时，聊天组件才会显示为在线——在此之外，访客会看到你的离线消息，如果你使用了 AI 自动回复，它也可以接手。
聊天组件的显示位置: 只在选定的页面显示聊天组件、在其他页面隐藏，或者只在满足条件时显示，例如某个访客群组、URL 参数、日期范围或页面停留时间。设置显示规则。
允许的开发域名: 默认情况下，聊天组件只会在你注册的正式域名上加载。添加额外的域名（如 localhost:3000 或 staging.example.com），即可在开发期间测试聊天组件。localhost 始终自动允许。
隐藏“由 Sonny 提供支持”: 从聊天组件中移除 Sonny 品牌标识。任何 AI 套餐或 BYOK 解锁都包含此功能。
向访客显示送达标记: Sonny 收到访客消息后，在消息下方显示一个对勾。对勾并不表示客服已读。

聊天前信息和访客验证解决的是不同的问题。将“邮箱”设为必填，意味着每个新对话都必须有邮箱身份。有效的签名身份可以满足这一要求；在允许浏览器邮箱识别时，访客输入的邮箱也可以。已保存的姓名或已完成的调查不算邮箱身份，因此 Sonny 会再次询问，而不会开启一个身份不明的对话。

当验证为“关”或“可选验证”时，访客输入的邮箱会创建一个未验证的联系人，且无法解锁跨设备历史记录。选择需要证明才能识别身份时，浏览器输入的邮箱不会被视为身份，因此当“邮箱”为必填的聊天前字段时，必须提供签名 JWT。

使用安装代码复制要添加到网站的代码。实时预览会显示已保存的视觉设置效果。如果不再需要该渠道，选择断开网站连接并确认操作。