小组件自定义
小组件自定义
Section titled “小组件自定义”个性化您的聊天小组件外观，使其与您的品牌和网站设计相匹配。
所有小组件自定义选项均可在 设置 → 渠道 → Web 中找到。选择您的 Web 渠道，然后打开 外观 选项卡。
主题颜色将统一应用于整个小组件的以下部分：
- 启动按钮背景
- 标题栏背景
- 发送按钮颜色
- 链接高亮颜色
- 用户消息气泡背景
请选择与您品牌形象相符、且与白色文字对比度良好的颜色。
欢迎消息是客户打开小组件时看到的第一条文字。请保持友好语气，并清晰说明机器人能提供哪些帮助。
示例：
- “您好！今天有什么可以帮助您的吗？”
- “欢迎使用 Acme 支持服务。您可以随时向我咨询有关我们产品和服务的任何问题。”
- “您好！我随时为您提供帮助。请问有什么需要协助的吗？“
| 位置 | 设置值 | 适用场景 |
|---|---|---|
| 右下角 | bottom-right （默认） | 标准位置，适用于大多数网站 |
| 左下角 | bottom-left | 当右侧与其他元素冲突时 |
v1.6.4
通过提供图片 URL，在小组件标题栏和主屏幕中显示自定义头像。
通过控制台： 在 设置 → 渠道 → Web → 自定义 → 头像 URL 中设置头像 URL。
通过嵌入代码： 在主题配置中传入 avatarUrl：
<script> window.ClientaConfig = { botId: "YOUR_BOT_ID", widgetId: "YOUR_WIDGET_ID", theme: { avatarUrl: "https://example.com/your-logo.png" } };</script>要求：
- 必须是
https://URL（出于安全考虑，http、data: 和 javascript: URL 将被拒绝） - 推荐尺寸： 128 × 128 像素（正方形）
- 支持格式： PNG、JPG、WebP、SVG
- 如果 URL 无效或图片加载失败，将显示默认图标
v1.6.2
问候消息支持三种语言模式。前往 设置 → 渠道 → Web → 自定义，找到 问候语模式 部分。
无论访客使用何种语言，均显示相同的问候文字。这是默认模式。
在文本框中输入一条问候语。示例：“您好！今天有什么可以帮助您的吗？“
匹配访客（语言区域）
Section titled “匹配访客（语言区域）”为每种语言显示不同的问候语。小组件会读取访客的检测语言并显示对应的问候语。
- 选择 匹配访客 模式。
- 将出现 15 种支持语言区域各自对应的输入框。
- 为您希望支持的每种语言填写问候文字。
- 将某语言区域的字段留空，则该语言将回退使用静态问候语。
示例配置：
- 泰语：“สวัสดีค่ะ! มีอะไรให้ช่วยไหม?”
- 英语：“Hi! How can I help you today?”
- 日语：“こんにちは！何かお手伝いできますか？“
无论访客使用何种语言，问候语始终以组织的主要响应语言显示。此模式读取在 AI 设置 → 主要响应语言 中设置的语言。
当您的团队使用单一语言运营，且希望所有问候语保持一致时，请使用”组织主语言”模式。
v1.6.2
语言选择器会在小组件标题栏中添加一个地球图标（🌐），让访客能够明确选择语言。该功能默认禁用。
启用方法： 在 设置 → 渠道 → Web → 自定义 中，将 显示语言选择器 切换为开启。
当访客从下拉菜单中选择语言时：
- 该会话中所有 AI 响应将锁定为所选语言
- 即使访客用其他语言输入，锁定语言也会覆盖自动检测
- 小组件界面切换为所选语言
完整行为说明请参阅 Web 小组件 — 语言选择器。
v1.6.8
为小组件设置默认语言，使访客在自动检测发生之前即可看到您偏好语言区域的界面。前往 设置 → 渠道 → Web → 自定义 → 默认语言，从下拉菜单中选择。
语言优先级链如下：
- 强制使用此语言（AI 设置）— 启用后将覆盖所有其他设置
- 访客明确选择的语言（通过语言选择器，如已启用）
- 默认语言 — 即本设置
- 嵌入配置语言区域 — 嵌入代码中的
locale值 - 泰语 — 无其他设置时的兜底语言
选择 “无 — 遵循嵌入配置” 可跳过此设置，改为依赖嵌入代码中的语言区域值。
更改完成后，使用设置页面右侧的 实时预览 面板，在保存之前查看小组件在您网站上的实际显示效果。