Configuratie

Pas het uiterlijk en gedrag van de widget aan.

Init-opties#

Optie	Standaard	Beschrijving
agentId	vereist*	De unieke ID van je agent. *Voor widgets met alleen menselijke medewerkers is `channelId` alleen voldoende.
channelId	—	ID van het widgetkanaal. Bepaalt welke widgetinstellingen (styling, uitgaande tooltips/banners) van toepassing zijn wanneer één agent meerdere widgets aandrijft, en is de enige identifier voor widgets met alleen menselijke medewerkers. Ten minste één van `agentId` / `channelId` is vereist.
position	bottom-right	`bottom-right` of `bottom-left`
primaryColor	#3B82F6	Merkkleur voor de widget-knop en koptekst
title	Support	Titeltekst van de koptekst
greeting	auto	Welkomstbericht (standaard geladen uit de dashboardinstellingen)
language	page	Taal van de widget als BCP-47-code (`de`, `pt-BR`). Bepaalt de interface, de begroeting en de snelle vragen. Zonder opgave volgt de widget de `<html lang>` van de pagina: een pagina waarvan de `lang` niet `en` is, start nu in die taal, ongeacht de browser van de bezoeker. Alleen `<html lang="en">` geldt als template-standaard en wordt genegeerd: de bezoeker houdt het vorige gedrag (onthouden keuze, daarna browsertaal). Geef `'browser'` op om `<html lang>` volledig te negeren en het gedrag «alleen browser» te herstellen. Tijdens runtime te wijzigen met `Respondo.setLanguage('fr')` – handig voor taalwisselaars die de pagina niet herladen.
placeholder	—	Aangepaste placeholder-tekst voor het invoerveld
quickQuestions	—	Array van voorgestelde vragen die vóór het eerste bericht worden getoond
logoUrl	—	URL van je logo dat in de widget-koptekst wordt getoond
avatarUrl	—	URL van de avatar van de AI-agent die naast berichten wordt getoond
identity	—	Vooraf ingestelde gebruikersidentiteit bij init (dezelfde velden als `identify()`)
localStorageKey	—	localStorage-sleutel om automatisch `userId` uit te lezen (voor GTM / no-code-opstellingen)
chatSize	default	`compact`, `default` of `large` — afmetingen van het chatvenster
launcherSize	default	`small`, `default` of `large` — grootte van de launcher-knop
offsetBottom	20	Afstand tot de onderrand (px)
offsetSide	20	Afstand tot de linker-/rechterrand (px)
borderRadius	20	Randstraal van het chatvenster (px)
zIndex	999999	CSS z-index voor de widget-container
customCSS	—	Aangepaste CSS die in de Shadow DOM van de widget wordt geïnjecteerd voor geavanceerde styling
testMode	false	Markeer gesprekken als test (verborgen in de hoofdweergaven)

Volledige configuratie#

Volledige configuratiejavascript

Respondo.init({
  agentId: 'YOUR_AGENT_ID',
  channelId: 'YOUR_CHANNEL_ID',
  position: 'bottom-right',        // 'bottom-right' | 'bottom-left'
  primaryColor: '#2563eb',
  language: 'de',                  // BCP-47; standaard: <html lang> (en = zwak signaal), 'browser' negeert het
  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', // lees userId automatisch uit localStorage (GTM / no-code)
  chatSize: 'default',              // 'compact' | 'default' | 'large'
  offsetBottom: 20,                 // afstand tot onderkant (px)
  identity: {                      // optioneel: instellen bij init als de gebruiker al bekend is
    email: 'user@example.com',
    name: 'John Doe',
    userId: 'usr_123',
    properties: {                  // aangepaste contacteigenschappen
      account_type: 'enterprise',
      region: 'eu-west'
    }
  }
});

De meeste instellingen (kleur, logo, begroeting, snelle vragen) worden beheerd vanuit het Channels-dashboard. De widget haalt deze op bij het laden — je hebt alleen het paar agentId/channelId uit de insluitcode nodig.