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

Налаштуйте вигляд і поведінку віджета.

Опції init#

Опція	За замовчуванням	Опис
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 аватара AI-агента, що показується поряд із повідомленнями
identity	—	Попередньо задана особа користувача під час init (ті самі поля, що й у `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: {                      // необов’язково: задати під час init, якщо користувач уже відомий
    email: 'user@example.com',
    name: 'John Doe',
    userId: 'usr_123',
    properties: {                  // кастомні властивості контакту
      account_type: 'enterprise',
      region: 'eu-west'
    }
  }
});

Більшість налаштувань (колір, логотип, привітання, швидкі запитання) керуються з панелі Channels. Віджет отримує їх під час завантаження — з коду вбудовування вам потрібна лише пара agentId/channelId.