配置

自定义挂件的外观和行为。

Init 选项#

选项	默认值	说明
agentId	必填*	您的 agent 唯一 ID。*对于纯人工（humans-only）挂件，只提供 `channelId` 即可。
channelId	—	挂件渠道的 ID。当一个 agent 驱动多个挂件时，用于选择应用哪个挂件的设置（样式、外呼提示/横幅）；对于纯人工挂件，它是唯一的标识符。 `agentId` / `channelId` 至少需要提供其中之一。
position	bottom-right	`bottom-right` 或 `bottom-left`
primaryColor	#3B82F6	挂件按钮和标题栏的品牌色
title	Support	标题栏文字
greeting	auto	欢迎语（默认从仪表盘设置加载）
language	page	小部件语言，BCP-47 代码（`de`、`pt-BR`）。决定界面、问候语和快捷问题的语言。省略时小部件跟随页面的 `<html lang>`：`lang` 不是 `en` 的页面现在会直接以该语言启动，与访客浏览器无关。仅有 `<html lang="en">` 时视为模板默认值并忽略：访客保持原有行为（记住的选择，其次是浏览器语言）。传入 `'browser'` 可完全忽略 `<html lang>`，恢复仅按浏览器的行为。运行时可通过 `Respondo.setLanguage('fr')` 更改——适合不刷新页面的语言切换器。
placeholder	—	自定义输入框占位文字
quickQuestions	—	首条消息前显示的建议问题数组
logoUrl	—	显示在挂件标题栏中的 logo 的 URL
avatarUrl	—	显示在消息旁的 AI 智能体头像的 URL
identity	—	在 init 时预设用户身份（字段与 `identify()` 相同）
localStorageKey	—	用于自动读取 `userId` 的 localStorage 键（用于 GTM / 无代码接入）
chatSize	default	`compact`、`default` 或 `large` —— 聊天窗口尺寸
launcherSize	default	`small`、`default` 或 `large` —— 启动按钮尺寸
offsetBottom	20	距底部边缘的距离（px）
offsetSide	20	距左/右边缘的距离（px）
borderRadius	20	聊天窗口圆角（px）
zIndex	999999	挂件容器的 CSS z-index
customCSS	—	注入挂件 Shadow DOM 的自定义 CSS，用于高级样式
testMode	false	将对话标记为测试（从主视图中隐藏）

完整配置#

完整配置javascript

Respondo.init({
  agentId: 'YOUR_AGENT_ID',
  channelId: 'YOUR_CHANNEL_ID',
  position: 'bottom-right',        // 'bottom-right' | 'bottom-left'
  primaryColor: '#2563eb',
  language: 'de',                  // BCP-47；默认：<html lang>（en 为弱信号），'browser' 则忽略它
  title: 'Help Center',
  greeting: 'How can we help?',
  placeholder: 'Ask anything...',
  logoUrl: 'https://yoursite.com/logo.png',
  avatarUrl: 'https://yoursite.com/avatar.png',
  quickQuestions: [
    'How do I get started?',
    'What are the pricing plans?',
    'How do I contact support?'
  ],
  testMode: false,
  localStorageKey: 'myapp_user_id', // 从 localStorage 自动读取 userId（GTM / 无代码）
  chatSize: 'default',              // 'compact' | 'default' | 'large'
  offsetBottom: 20,                 // 距底部的距离（px）
  identity: {                      // 可选：如果用户已知，可在 init 时设置
    email: 'user@example.com',
    name: 'John Doe',
    userId: 'usr_123',
    properties: {                  // 自定义联系人属性
      account_type: 'enterprise',
      region: 'eu-west'
    }
  }
});

大多数设置（颜色、logo、欢迎语、快捷问题）都在 Channels 仪表盘中管理。挂件会在加载时获取这些设置 —— 您只需要嵌入代码里的 agentId/channelId 这一对。