` è il punto di montaggio: il pannello della chat viene renderizzato al suo interno e ne riempie le dimensioni. Applica al div lo stile che preferisci (assegna un'altezza fissa, inseriscilo in un contenitore flex, posizionalo in una cella di una griglia, ecc.) e il pannello della chat si adatterà di conseguenza.
È necessario un **solo** tag `
```
{% endcode %}
Lo snippet incorporato la riporta invece sul `
`, così una pagina può contenere diverse chat dirette a luoghi diversi:
{% code overflow="wrap" %}
```html
```
{% endcode %}
Per un agente, la dicitura cambia in `?agent=AGENT_ID` o `data-agent="AGENT_ID"`.
Alcune cose utili da sapere:
- Usa il pulsante di copia invece di digitare l'ID a mano. Se l'ID non corrisponde a una campagna o a un agente nel tuo account, la chat funzionerà comunque ma tornerà all'instradamento predefinito.
- Chi è già nel bel mezzo di una conversazione rimane con chi l'ha iniziata, anche se in seguito approda su una pagina che punta altrove. Questo impedisce a una conversazione di cambiare personalità a metà.
- Una destinazione specifica per pagina ha la priorità sul valore predefinito dell'account e sui trigger delle parole chiave.
### Comunica al widget chi è il visitatore (Avanzato)
Se inserisci il widget di chat all'interno di un'area riservata, un portale clienti o un'app in cui gli utenti hanno già effettuato l'accesso, il tuo sito sa già chi sono. Puoi trasmettere queste informazioni al widget in modo che al visitatore non vengano richiesti dettagli già forniti in precedenza e affinché la tua IA possa utilizzare ciò che già sai su di lui.
Aggiungi un piccolo blocco di impostazioni **prima** dello script del widget:
{% code overflow="wrap" %}
```html
```
{% endcode %}
La tua pagina dovrebbe compilare tali valori lato server, in base all'utente che ha effettuato l'accesso.
Accadono due cose:
- **Il modulo "Prima di iniziare..." viene saltato.** Con nome ed email forniti, il visitatore passa direttamente alla conversazione e tali dettagli vengono salvati nel suo contatto esattamente come se li avesse digitati lui stesso.
- **Tutto ciò che si trova sotto `data` viene trasmesso alla tua IA.** Qualsiasi cosa inserita lì — piano, numero d'ordine, data di rinnovo, credito residuo, numero di postazioni — diventa parte delle informazioni che l'IA possiede su quella persona, così da poter rispondere a domande come "quando si rinnova il mio piano?" senza dover chiedere prima chi sia. Usa i nomi dei campi che preferisci; appariranno nel contatto sotto Campi Personalizzati. Fino a 20 valori, inviati aggiornati a ogni messaggio, quindi se il piano cambia durante la conversazione, l'IA vedrà quello nuovo.
Per gli embed inline, puoi inserire le stesse informazioni su `
`, il che è utile quando una pagina contiene diverse chat:
{% code overflow="wrap" %}
```html
```
{% endcode %}
Se il tuo sito conosce l'identità del visitatore solo dopo il caricamento della pagina — ad esempio in una single-page app in cui l'accesso avviene senza ricaricare la pagina — chiama questa funzione ogni volta che disponi dei dettagli e il widget si aggiornerà automaticamente:
{% code overflow="wrap" %}
```html
```
{% endcode %}
Alcune cose utili da sapere:
- Se due persone diverse effettuano l'accesso dallo stesso computer, la seconda inizierà una nuova conversazione invece di vedere la chat della prima. Il widget rileva il cambio di utente e si reimposta.
- Questo serve per il contesto, non per autenticare qualcuno. Le conversazioni rimangono separate come sempre, quindi passare un `id` non permette a nessuno di aprire la chat di qualcun altro, e chiunque utilizzi un dispositivo o un browser diverso inizierà una nuova conversazione lì.
- È facoltativo. Un widget su una normale pagina pubblica non ha bisogno di nulla di tutto ciò e si comporta esattamente come prima.
### Modifica le impostazioni del widget dal tuo codice (API)
Tutto ciò che si trova nel pannello **Gestisci** del widget può essere modificato anche tramite la [REST API](../api/reference.md), il che è utile se gestisci molti siti web o se desideri disattivare automaticamente il pulsante degli allegati per un cliente. Invia una `PATCH` a `https://api.youraiconnector.com/v1/chat-widget-configs/CONFIG_ID` con la tua chiave API e solo i campi che desideri modificare: ad esempio `{"show_upload_button": false}` nasconde il pulsante degli allegati, `{"show_emoji_button": false}` nasconde il selettore di emoji e `{"launcher_icon": "chat-dots"}` sostituisce l'icona di avvio. `CONFIG_ID` è lo stesso identificatore presente nel tuo script di incorporamento. L'elenco completo dei campi accettati (nome, messaggio di apertura, colori, icona di avvio, domini consentiti, modulo informazioni visitatore, informativa sulla privacy, tema, angolo e stile del carattere) si trova nel [Riferimento API](../api/reference.md) alla voce **Chat Widget**. I siti web recepiscono la modifica al caricamento successivo della pagina.
### Cosa aspettarsi dopo l'installazione
Una volta aggiunto lo script al tuo sito web, il widget della chat creerà automaticamente un pulsante di chat nell'angolo del tuo sito web (in basso a destra per impostazione predefinita). Il widget rimane in una posizione fissa mentre gli utenti scorrono le tue pagine, assicurando che sia sempre accessibile.
Quando i visitatori cliccano su questo pulsante, si espande in una finestra di chat completa dove possono iniziare una conversazione, mostrando il tuo messaggio di apertura. Se Raccogli informazioni visitatore è attivo, appare prima un piccolo modulo che richiede nome ed email (e facoltativamente il telefono) prima che possano scrivere.
L'interfaccia della chat si adatta automaticamente alle diverse dimensioni dello schermo, quindi funziona perfettamente sia su desktop che su dispositivi mobili.
### Test della tua implementazione
Dopo aver aggiunto il widget al tuo sito, verifica che funzioni:
1. Apri il tuo sito web in un browser.
2. Fai clic sul pulsante della chat per aprire il widget.
3. Invia un messaggio di prova e conferma di ricevere una risposta.
4. Ripeti l'operazione su un dispositivo o browser diverso per confermare che funzioni ovunque.
Se il widget della chat non appare sul tuo sito, controlla quanto segue:
1. Assicurati di aver sostituito `CONFIG_ID` con il tuo identificativo di configurazione effettivo.
2. Assicurati che il tag script sia posizionato prima del tag di chiusura `