Configurazione

Personalizza l’aspetto e il comportamento del widget.

Opzioni di init#

Opzione	Default	Descrizione
agentId	obbligatorio*	L’ID univoco del tuo agente. *Per i widget solo umani basta `channelId`.
channelId	—	ID del canale widget. Determina quali impostazioni del widget (stile, tooltip/banner outbound) si applicano quando un agente alimenta più widget, ed è l’unico identificatore per i widget solo umani. È richiesto almeno uno tra `agentId` / `channelId`.
position	bottom-right	`bottom-right` o `bottom-left`
primaryColor	#3B82F6	Colore del brand per il pulsante e l’intestazione del widget
title	Support	Testo del titolo dell’intestazione
greeting	auto	Messaggio di benvenuto (caricato dalle impostazioni della dashboard per impostazione predefinita)
language	page	Lingua del widget come codice BCP-47 (`de`, `pt-BR`). Imposta l'interfaccia, il saluto e le domande rapide. Se omessa, il widget segue il `<html lang>` della pagina: una pagina il cui `lang` non è `en` ora parte in quella lingua, qualunque sia il browser del visitatore. Un semplice `<html lang="en">` è trattato come valore predefinito del template e ignorato: il visitatore mantiene il comportamento precedente (scelta memorizzata, poi lingua del browser). Passa `'browser'` per ignorare del tutto `<html lang>` e tornare al comportamento «solo browser». Modificabile a runtime con `Respondo.setLanguage('fr')`: utile per i selettori di lingua che non ricaricano la pagina.
placeholder	—	Testo segnaposto personalizzato per l’input
quickQuestions	—	Array di domande suggerite mostrate prima del primo messaggio
logoUrl	—	URL del tuo logo mostrato nell’intestazione del widget
avatarUrl	—	URL dell’avatar dell’agente IA mostrato accanto ai messaggi
identity	—	Identità utente preimpostata al momento dell’init (stessi campi di `identify()`)
localStorageKey	—	Chiave localStorage da cui leggere automaticamente lo `userId` (per configurazioni GTM / no-code)
chatSize	default	`compact`, `default` o `large` — dimensioni della finestra di chat
launcherSize	default	`small`, `default` o `large` — dimensione del pulsante launcher
offsetBottom	20	Distanza dal bordo inferiore (px)
offsetSide	20	Distanza dal bordo sinistro/destro (px)
borderRadius	20	Border radius della finestra di chat (px)
zIndex	999999	z-index CSS per il contenitore del widget
customCSS	—	CSS personalizzato iniettato nello Shadow DOM del widget per uno stile avanzato
testMode	false	Contrassegna le conversazioni come test (nascoste dalle viste principali)

Configurazione completa#

Configurazione completajavascript

Respondo.init({
  agentId: 'YOUR_AGENT_ID',
  channelId: 'YOUR_CHANNEL_ID',
  position: 'bottom-right',        // 'bottom-right' | 'bottom-left'
  primaryColor: '#2563eb',
  language: 'de',                  // BCP-47; predefinito: <html lang> (en = segnale debole), 'browser' lo ignora
  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', // leggi automaticamente userId da localStorage (GTM / no-code)
  chatSize: 'default',              // 'compact' | 'default' | 'large'
  offsetBottom: 20,                 // distanza dal basso (px)
  identity: {                      // facoltativo: imposta all'init se l'utente è già noto
    email: 'user@example.com',
    name: 'John Doe',
    userId: 'usr_123',
    properties: {                  // proprietà di contatto personalizzate
      account_type: 'enterprise',
      region: 'eu-west'
    }
  }
});

La maggior parte delle impostazioni (colore, logo, saluto, domande rapide) è gestita dalla dashboard Channels. Il widget le recupera al caricamento — ti serve solo la coppia agentId/channelId del codice di embed.