> For the complete documentation index, see [llms.txt](https://smartypilot.gitbook.io/smartypilot/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://smartypilot.gitbook.io/smartypilot/chatbot-ai/impostazioni.md).

# Impostazioni generali

In questa pagina puoi configurare i parametri principali del tuo chatbot: nome, messaggi e visibilità.

{% hint style="info" %}
Il modo in cui il chatbot si rivolge ai clienti — se dare del tu o del lei, con che tono, quanto scrivere — si imposta nella pagina [Comportamento](/smartypilot/chatbot-ai/comportamento.md).
{% endhint %}

<figure><img src="/files/c1sFtJ6hyMjLVZo3luve" alt=""><figcaption><p>La parte alta della pagina Impostazioni generali</p></figcaption></figure>

## Attivare o disattivare il chatbot

All'inizio della pagina trovi un interruttore **Attivo**. Quando è acceso, il chatbot è visibile sul tuo sito. Quando è spento, il pulsante di chat non viene mostrato ai visitatori.

## Campi principali

### Tipo di sito web

Seleziona il tipo di sito che ospita il chatbot. Le opzioni disponibili sono sei:

* **eCommerce** — negozio online: catalogo, carrello, pagamenti. È l'unico tipo che abilita le funzioni sui prodotti e sugli ordini.
* **Blog** — articoli e contenuti editoriali.
* **Corporate** — sito aziendale o istituzionale: servizi, chi siamo, contatti.
* **Portfolio** — presentazione di lavori o progetti.
* **News** — sito di notizie e informazione.
* **Educational** — corsi e lezioni online.

Il tipo scelto dice al chatbot con che obiettivo è nato il sito, e quindi come impostare le risposte. Su tutti i tipi diversi da **eCommerce** il chatbot risponde su servizi, contatti e informazioni, senza le funzioni legate a catalogo e ordini.

### Nome del chatbot

Il nome che il chatbot userà per riferirsi a se stesso durante le conversazioni. Ad esempio: "Smarty", "Assistente", "Lilly".

### Nome del tuo sito web

Il nome del negozio o del sito su cui viene installato il chatbot. Il chatbot lo userà quando si presenterà ai clienti.

### Lingua predefinita

È la lingua in cui scrivi i contenuti del chatbot, e serve a due cose:

* **Base delle traduzioni**: i campi che lasci vuoti nelle altre lingue usano il testo scritto in questa.
* **Ripiego**: viene usata quando la lingua della pagina che il cliente sta guardando non è fra quelle del chatbot.

{% hint style="warning" %}
Non è la lingua delle risposte. Su un sito eCommerce il chatbot risponde nella lingua del catalogo collegato alla pagina che il visitatore sta guardando.
{% endhint %}

### Testo introduttivo

Un messaggio breve che appare all'apertura della conversazione, prima del messaggio di benvenuto vero e proprio. Se lasci il campo vuoto, viene usato un testo automatico predefinito.

### Primo messaggio del chatbot

Il primo messaggio che il chatbot invia al cliente quando apre la chat. Ad esempio: "Ciao! Come posso aiutarti oggi?".

### URL Privacy Policy

Inserisci il link alla pagina della privacy policy del tuo sito. Il chatbot chiederà al cliente di accettarla prima di iniziare la conversazione.

## Se il chatbot parla più lingue

Riconosci i campi da scrivere in ogni lingua dalla piccola tendina con la lingua che compare accanto all'etichetta. Sono:

* Testo introduttivo
* Primo messaggio del chatbot
* URL Privacy Policy
* Link aggiungi al carrello
* URL del link di ricerca
* URL, testo del bottone e testo introduttivo del **contatto con un operatore**

Per tradurre:

1. Scegli la lingua da una qualsiasi di quelle tendine: cambiano tutte insieme, così non rischi di salvare metà pagina in una lingua e metà in un'altra.
2. Scrivi i testi in quella lingua.
3. Ripeti per le altre lingue.
4. Clicca su **Salva** una volta sola: il salvataggio scrive tutte le lingue insieme. Cambiare tendina non ti fa perdere quello che hai appena scritto.

<figure><img src="/files/SKTl8ZkcWd4270aSDNdV" alt=""><figcaption><p>La tendina della lingua accanto ai campi traducibili</p></figcaption></figure>

I campi lasciati vuoti nelle lingue secondarie usano il testo della lingua predefinita, e il campo stesso te lo ricorda mostrandolo in grigio.

{% hint style="warning" %}
L'**URL Privacy Policy** fa eccezione: va indicato in ogni lingua, perché il consenso deve essere mostrato al cliente nella sua lingua. Qui non c'è ricaduta sulla lingua predefinita.
{% endhint %}

Le lingue disponibili sono quelle configurate per il tuo chatbot. Se ti serve una lingua in più, contatta il supporto Smartypilot.

{% hint style="info" %}
Anche il testo del pulsante di apertura si scrive per lingua: lo trovi nella pagina [Layout](/smartypilot/chatbot-ai/layout.md). Le impostazioni di [Comportamento](/smartypilot/chatbot-ai/comportamento.md), invece, non sono testi da tradurre e valgono per tutte le lingue.
{% endhint %}

### Quali utenti possono vedere il chatbot

Puoi scegliere a chi mostrare il chatbot:

* **Mostra sempre**: il pulsante del chatbot è visibile a tutti i visitatori, sia registrati che non.
* **Mostra solamente agli utenti registrati**: solo ai clienti che hanno effettuato l'accesso al tuo sito.
* **Mostra solamente agli utenti guest**: solo ai visitatori non registrati.

### Domini autorizzati per il widget

I domini su cui il chatbot può comparire. Su un sito che non è di tipo eCommerce il campo è obbligatorio: senza almeno un dominio il widget non viene mostrato. Scrivi il dominio e premi Invio per aggiungerlo.

## Indice di ricerca collegato

{% hint style="warning" %}
Questo campo va **sempre** compilato su un sito eCommerce. Non esiste alcuna scelta automatica: se lo lasci vuoto il chatbot perde tutte le funzioni legate al catalogo — non può più cercare prodotti, mostrare una scheda, proporre articoli simili o compatibili, né fare confronti.
{% endhint %}

Scegli quale catalogo prodotti collegare al chatbot: userà i dati di quel catalogo quando risponde su prodotti e disponibilità.

La sezione compare se il tuo store non è di tipo corporate e ha il modulo [Ricerca](/smartypilot/ricerca/impostazioni-generali.md) attivo.

## CMS e integrazione ordini

Seleziona il CMS che utilizzi per il tuo sito (es. WooCommerce, Prestashop, NopCommerce). Questa configurazione permette al chatbot di collegarsi all'API degli ordini del tuo negozio, per consentire ai clienti di richiedere informazioni sullo stato dei loro acquisti direttamente in chat.

Se utilizzi un CMS non standard, puoi configurare manualmente l'indirizzo e la chiave di accesso per l'API degli ordini.

## Opzioni aggiuntive

### Visualizza lo SKU del prodotto

Se attivo, il chatbot mostra il codice SKU accanto al nome del prodotto quando suggerisce articoli ai clienti. Disattivalo se preferisci non mostrare i codici interni.

### Visualizza il prezzo scontato

Se attivo, il chatbot mostra sia il prezzo originale che quello scontato quando presenta un prodotto. Se disattivi questa opzione, verrà mostrato solo il prezzo corrente.

### Aggiunta al carrello

Se attivi questa opzione, il chatbot mostrerà un pulsante per aggiungere un prodotto al carrello direttamente dalla chat.

{% hint style="info" %}
Il campo **Link aggiungi al carrello**, per personalizzare l'indirizzo usato, compare solo se il CMS selezionato è PrestaShop.
{% endhint %}

## Contatto con un operatore

Questa card raccoglie tutto quello che serve quando il cliente vuole parlare con una persona.

### Tipo chat umana

Scegli come il cliente viene messo in contatto:

* **-- nessuna chat umana --**: il chatbot non propone il passaggio a un operatore.
* **WhatsApp**
* **Altro**: qualsiasi altro servizio di chat, indicandone l'indirizzo.

Se scegli un tipo diverso da "nessuna", compili anche l'**URL del link**, il **testo del bottone** e un **testo introduttivo**. Tutti e tre si scrivono per lingua.

### Indirizzi email per contatto da chatbot

Uno o più indirizzi email (separati da punto e virgola) a cui arriva una notifica quando un cliente chiede assistenza. Ad esempio: `assistenza@miosito.it;supporto@miosito.it`. Il campo è obbligatorio quando la richiesta di assistenza è attiva.

{% hint style="info" %}
I due blocchi di questa card compaiono solo se le funzioni corrispondenti — passaggio a operatore e richiesta di assistenza — sono attive sul tuo chatbot. Se non le vedi, chiedi al supporto Smartypilot.
{% endhint %}

## Chatbot GUID

In fondo alla pagina trovi il codice identificativo del tuo chatbot, con un pulsante per copiarlo. Serve al supporto Smartypilot quando devi segnalare un problema.

## Come salvare le modifiche

1. Compila o modifica i campi desiderati.
2. Clicca sul pulsante **Salva** in fondo alla pagina.

Le modifiche diventano operative immediatamente, senza bisogno di svuotare la cache.