Skip to main content
IperChat
EN
Accedi

Il widget

Personalizza colori, saluto e bottone

Adatta il widget al tuo brand: colori, logo, messaggio di benvenuto, domande suggerite. Tutte le modifiche sono live.

Tutta la personalizzazione del widget si fa dal pannello operativo, sezione “Configurazioni Agenti” (menu laterale → gruppo Agents). Clicca sulla riga corrispondente al tuo Origin ID per aprire la configurazione: le impostazioni di aspetto sono raggruppate sotto “Aspetto” → “Configurazione”.

Le modifiche sono live: appena salvi, qualsiasi pagina che carica lo script vede la nuova versione (al massimo dopo 60 secondi di cache).

Colori

Sottosezione “Colori del brand”. Due valori, entrambi in formato esadecimale (#RRGGBB):

  • Colore primario — sfondo dei messaggi dell’agente, header della chat, pulsante flottante. Usa il colore principale del tuo brand.
  • Colore secondario — accenti, hover, link. Spesso una variante più scura del primario, o il colore complementare.

L’Anteprima Live in fondo alla configurazione aggiorna i cambiamenti appena digiti i valori.

Sottosezione “Identità”. I campi sono:

  • Nome — appare nell’header della chat. Esempi: “Studio Rossi AI”, “Assistente di Casa Bianca”, “Maria di Pasticceria del Borgo”.
  • Sottotitolo — una riga sotto al nome, configurabile per lingua. Tipicamente la specializzazione: “Sono qui con te”, “Disponibile 24/7”.
  • Agent Name — il titolo della pagina standalone / biglietto da visita digitale. Lascia vuoto per usare il Nome.
  • Logo URL — URL pubblico di un’immagine PNG o SVG (consigliato 32×32, 64×64 o 128×128 px). Appare nell’header del widget.

Messaggi iniziali e domande suggerite

Sottosezione “Avvio conversazione”.

Messaggi iniziali

Il messaggio che il visitatore vede quando apre per la prima volta la chat. Nel form trovi “Messaggi iniziali”: un messaggio per lingua (il codice lingua viene normalizzato in minuscolo). Usa “Aggiungi lingua” per aggiungerne altre, o “Ripristina default IT/EN” per tornare ai testi di base.

Ciao! Sono Maria, l'assistente di Pasticceria del Borgo.
Posso aiutarti con menu, prenotazioni e orari. Cosa cerchi?

Buone pratiche:

  • Sii specifico: spiega cosa l’agente sa fare. “Posso aiutarti con X, Y, Z” funziona meglio di “Come posso aiutarti?”.
  • Menziona un’azione: “Prova a chiedermi gli orari” abbassa la barriera all’ingaggio.
  • Personalità coerente: il messaggio iniziale definisce il tono di tutta la conversazione.

Domande suggerite

Sotto al messaggio iniziale puoi mostrare chip cliccabili di domande pronte (massimo 6 per lingua, una per riga). Se il visitatore clicca, la domanda viene inviata immediatamente all’agente.

Quali sono i vostri orari?
Posso prenotare per stasera?
Avete opzioni senza glutine?

Buone domande suggerite:

  • Brevi — entrano in un chip (max 6-8 parole).
  • Frequenti — quelle che ti senti chiedere ogni giorno.
  • Trasversali — rispondono a qualcosa che il sito non rende evidente.

Pulsante flottante

Sottosezione “Pulsante flottante” — riguarda come appare il widget quando è chiuso.

  • Messaggio widget chiuso — testo che appare accanto all’icona sul pulsante flottante (es. “Sono qui se hai bisogno”).
  • Mostra solo l’icona (senza testo) — interruttore: se attivo, il pulsante mostra solo l’icona, nascondendo il messaggio.

La posizione (bottom-right / bottom-left / inline) si imposta nello snippet HTML via data-position, non dal pannello.

Testi in chat

Sottosezione “Testi in chat”.

  • Placeholder input chat — il testo grigio visualizzato nel campo di scrittura prima che l’utente inizi a digitare (es. “Scrivi un messaggio…”).
  • Footer disclaimer — testo libero sotto al campo di input, utile in settori regolamentati (“Le risposte non sostituiscono un parere medico”).

Sottosezione “Link legali”. Se compilati, i link appaiono nel footer del widget; se vuoti, non vengono mostrati.

  • Link Privacy Policy — URL della tua pagina privacy (es. https://tuosito.it/privacy).
  • Link Termini di servizio — URL della tua pagina termini.

Per servizi sanitari, legali o finanziari valuta anche di compilare il Footer disclaimer nella sottosezione Testi in chat.

Lingue

L’agente rileva automaticamente la lingua del browser del visitatore e risponde nella stessa lingua. Non c’è nulla da attivare.

Se vuoi forzare una lingua specifica (es. solo italiano), aggiungi data-language="it" allo snippet:

<script
  src="https://widget.iperchat.ai/iperchat.iife.js"
  data-iperchat-auto-init
  data-tenant-id="IL_TUO_TENANT_ID"
  data-language="it"
></script>

Lettura vocale (TTS)

Sottosezione “Riproduzione vocale” (nella stessa pagina Configurazione, sotto le sezioni del widget). Se attivata, ogni risposta dell’agente avrà un pulsante “play” che la legge ad alta voce. Voce, tono e ritmo sono regolabili dall’interfaccia; puoi testare il risultato prima di salvare.

Prossimi passi