Конфигурация

Настройте внешний вид и поведение виджета.

Параметры инициализации#

Параметр	По умолчанию	Описание
agentId	обязательно*	Уникальный ID вашего агента. *Для виджетов «только люди» достаточно одного `channelId`.
channelId	—	ID канала виджета. Определяет, какие настройки виджета (стилизация, исходящие подсказки/баннеры) применяются, когда один агент обслуживает несколько виджетов, и является единственным идентификатором для виджетов «только люди». Требуется хотя бы один из `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	—	URL вашего логотипа, показываемого в шапке виджета
avatarUrl	—	URL аватара ИИ-агента, показываемого рядом с сообщениями
identity	—	Предустановленная личность пользователя на этапе инициализации (те же поля, что и в `identify()`)
localStorageKey	—	Ключ localStorage для автоматического чтения `userId` (для GTM / no-code сценариев)
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	—	Пользовательский CSS, внедряемый в Shadow DOM виджета для продвинутой стилизации
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', // автоматическое чтение userId из localStorage (GTM / no-code)
  chatSize: 'default',              // 'compact' | 'default' | 'large'
  offsetBottom: 20,                 // расстояние от низа (px)
  identity: {                      // необязательно: задать при инициализации, если пользователь уже известен
    email: 'user@example.com',
    name: 'John Doe',
    userId: 'usr_123',
    properties: {                  // пользовательские свойства контакта
      account_type: 'enterprise',
      region: 'eu-west'
    }
  }
});

Большинство настроек (цвет, логотип, приветствие, быстрые вопросы) управляются из панели «Каналы». Виджет загружает их при старте — из кода встраивания нужна только пара agentId/channelId.