Konfiguracja

Dostosuj wygląd i zachowanie widgetu.

Opcje init#

Opcja	Domyślnie	Opis
agentId	wymagane*	Unikalny identyfikator Twojego agenta. *Dla widgetów obsługiwanych wyłącznie przez ludzi wystarczy sam `channelId`.
channelId	—	Identyfikator kanału widgetu. Wybiera, które ustawienia widgetu (stylizacja, wychodzące dymki/banery) mają zastosowanie, gdy jeden agent obsługuje kilka widgetów, i jest jedynym identyfikatorem dla widgetów obsługiwanych wyłącznie przez ludzi. Wymagany jest co najmniej jeden z `agentId` / `channelId`.
position	bottom-right	`bottom-right` lub `bottom-left`
primaryColor	#3B82F6	Kolor marki przycisku i nagłówka widgetu
title	Support	Tekst tytułu nagłówka
greeting	auto	Wiadomość powitalna (domyślnie ładowana z ustawień panelu)
language	page	Język widżetu jako kod BCP-47 (`de`, `pt-BR`). Ustawia interfejs, powitanie i szybkie pytania. Bez tej opcji widżet podąża za `<html lang>` strony: strona, której `lang` jest inny niż `en`, startuje teraz w tym języku niezależnie od przeglądarki odwiedzającego. Samo `<html lang="en">` traktowane jest jako domyślna wartość szablonu i ignorowane: odwiedzający zachowuje dotychczasowe zachowanie (zapamiętany wybór, potem język przeglądarki). Przekaż `'browser'`, aby całkowicie zignorować `<html lang>` i przywrócić zachowanie «tylko przeglądarka». Zmieniaj w locie przez `Respondo.setLanguage('fr')` — przydatne dla przełączników języka, które nie przeładowują strony.
placeholder	—	Niestandardowy tekst zastępczy pola wprowadzania
quickQuestions	—	Tablica sugerowanych pytań pokazywanych przed pierwszą wiadomością
logoUrl	—	URL Twojego logo pokazywanego w nagłówku widgetu
avatarUrl	—	URL awatara agenta AI pokazywanego obok wiadomości
identity	—	Wstępnie ustawiona tożsamość użytkownika w momencie init (te same pola co w `identify()`)
localStorageKey	—	Klucz localStorage do automatycznego odczytu `userId` (dla konfiguracji GTM / no-code)
chatSize	default	`compact`, `default` lub `large` — wymiary okna czatu
launcherSize	default	`small`, `default` lub `large` — rozmiar przycisku launchera
offsetBottom	20	Odległość od dolnej krawędzi (px)
offsetSide	20	Odległość od lewej/prawej krawędzi (px)
borderRadius	20	Zaokrąglenie narożników okna czatu (px)
zIndex	999999	CSS z-index kontenera widgetu
customCSS	—	Niestandardowy CSS wstrzykiwany do Shadow DOM widgetu dla zaawansowanej stylizacji
testMode	false	Oznacza rozmowy jako testowe (ukryte w głównych widokach)

Pełna konfiguracja#

Pełna konfiguracjajavascript

Respondo.init({
  agentId: 'YOUR_AGENT_ID',
  channelId: 'YOUR_CHANNEL_ID',
  position: 'bottom-right',        // 'bottom-right' | 'bottom-left'
  primaryColor: '#2563eb',
  language: 'de',                  // BCP-47; domyślnie: <html lang> (en = słaby sygnał), 'browser' go ignoruje
  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', // automatyczny odczyt userId z localStorage (GTM / no-code)
  chatSize: 'default',              // 'compact' | 'default' | 'large'
  offsetBottom: 20,                 // odległość od dołu (px)
  identity: {                      // opcjonalnie: ustaw w init, jeśli użytkownik jest już znany
    email: 'user@example.com',
    name: 'John Doe',
    userId: 'usr_123',
    properties: {                  // niestandardowe właściwości kontaktu
      account_type: 'enterprise',
      region: 'eu-west'
    }
  }
});

Większość ustawień (kolor, logo, powitanie, szybkie pytania) zarządzana jest z panelu Kanały. Widget pobiera je w momencie ładowania — z kodu osadzenia potrzebna jest tylko para agentId/channelId.