> For the complete documentation index, see [llms.txt](https://docs.aisuru.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.aisuru.com/condivisione/condivisione-sezione-avanzata/cronologia-e-ripresa-di-chat.md).

# Cronologia e ripresa di chat

La **Cronologia Chat** è una funzionalità fondamentale sempre disponibile in tutti i widget AIsuru che permette agli utenti di accedere, gestire e riprendere tutte le loro conversazioni passate con il tuo Agente. Questa caratteristica trasforma l'interazione da singoli scambi isolati a un'esperienza conversazionale continua e persistente.

### Come accedere alla cronologia

In ogni widget AIsuru gli utenti possono facilmente accedere alla loro cronologia personale:

1. **Individuare l'icona chat** nella toolbar del widget;
2. **Cliccare sull'icona** per aprire la pagina dedicata alla cronologia;
3. **Visualizzare immediatamente** tutte le loro conversazioni passate con l'Agente.

💡 **Nota importante**: La cronologia è sempre disponibile, anche nelle modalità "Prova" dell'Agente, senza necessità di configurazioni aggiuntive da parte del creatore dell'Agente.

### Interfaccia della cronologia chat

#### Intestazione e controlli principali

La pagina della cronologia presenta un'interfaccia pulita e funzionale:

* **Cronologia chat**: titolo principale della sezione per orientare l'utente;
* **Scarica chat**: pulsante per scaricare in formato .txt la conversazione attualmente visualizzata;
* **Filtri:**
  *  **Filtro temporale:** per organizzare e cercare tramite la data della conversazione: "Tutti", "Oggi", "Ieri", "Ultimi 7 giorni" e "Ultimi 30 giorni";
  * **Filtro messaggi minimi:** per organizzare le chat con un numero di messaggi minimi: "Qualunque", "2", "3", "5", "10", "15", "20" e custom.

#### Visualizzazione delle conversazioni

Ogni conversazione nell'elenco è presentata in modo chiaro e informativo:

**Titolo automatico intelligente**

* **Generazione automatica**: il titolo viene creato automaticamente dal primo messaggio dell'utente;
* **Troncamento intelligente**: se il messaggio è troppo lungo, viene tagliato con "..." mantenendo la leggibilità;
* **Riconoscimento immediato**: permette agli utenti di identificare rapidamente le conversazioni.

**Timestamp preciso**

* **Data e ora complete**: ogni conversazione mostra quando è iniziata (es. "21 Gen 2025, 15:34");
* **Numero di messaggi e media:** indica il numero di messaggi e media scambiati;
* **Ordinamento cronologico**: le conversazioni sono ordinate dalla più recente alla più vecchia;
* **Riferimento temporale**: aiuta gli utenti a contestualizzare le loro interazioni.

### Ripresa delle conversazioni

#### Visualizzazione completa

Cliccando su qualsiasi conversazione nell'elenco:

* **Vista dettagliata**: si apre la conversazione completa con tutti i messaggi scambiati;
* **Contesto preservato**: tutti i dati della sessione vengono mantenuti;
* **Interfaccia familiare**: la conversazione appare nello stesso formato del widget originale.

#### Funzionalità di continuazione

La vera potenza della cronologia si manifesta nella capacità di ripresa:

* **Pulsante "RIPRENDI"**: prominente e facilmente accessibile;
* **Continuità seamless**: cliccando "RIPRENDI", l'utente torna esattamente dove aveva lasciato;
* **Mantenimento del contesto**: l'Agente ricorda tutto il contesto della conversazione precedente;
* **Ripristino dell'ambiente**: la chat riprende nel widget/layout originale con tutte le configurazioni.

### Vantaggi strategici

#### Per gli utenti finali

* **Eliminazione della frustrazione**: non più perdita di informazioni importanti;
* **Continuità dell'esperienza**: conversazioni che si sviluppano nel tempo;
* **Riferimento storico**: possibilità di rivedere consigli e informazioni ricevute;
* **Flessibilità temporale**: libertà di interrompere e riprendere quando conveniente.

#### Per i creatori di Agenti

* **Engagement aumentato**: gli utenti sono più propensi a tornare;
* **Conversazioni più profonde**: possibilità di sviluppare relazioni durature;
* **Riduzione del lavoro ripetitivo**: l'Agente non deve ripartire da zero;
* **Migliore comprensione degli utenti**: storico delle interazioni per ottimizzazioni.

### Aspetti tecnici e privacy

#### Gestione dei dati

* **Isolamento utente**: ogni utente vede esclusivamente le proprie conversazioni;
* **Persistenza garantita**: le conversazioni rimangono disponibili anche dopo chiusura del browser;
* **Identificazione sicura**: sistema di associazione basato sull'account utente;
* **Gestione automatica**: nessun intervento richiesto dal creatore dell'Agente.

#### Integrazione con sessionID

La cronologia chat è strettamente legata al sistema di gestione delle sessioni di AIsuru:

* **SessionID univoci**: ogni conversazione ha un identificativo unico;
* **Ripristino tecnico**: quando si riprende una chat, viene ripristinato il sessionID originale;
* **Compatibilità API**: funziona perfettamente con le integrazioni avanzate.

### Best Practices

#### Per massimizzare l'efficacia

1. **Concludi con aperture**: termina le conversazioni con domande o suggerimenti per il futuro;
2. **Riferimenti temporali**: configura l'Agente per fare riferimento a conversazioni passate quando appropriato;
3. **Progressione logica**: struttura i contenuti per creare percorsi conversazionali che si sviluppano nel tempo;
4. **Testing continuativo**: testa regolarmente l'esperienza di ripresa per assicurarti che funzioni fluidamente.

#### Considerazioni UX

* **Onboarding**: spiega agli utenti come accedere alla cronologia durante le prime interazioni;
* **Promemoria**: ricorda periodicamente la disponibilità di questa funzionalità;
* **Feedback**: raccogli feedback degli utenti sull'utilità della cronologia per ottimizzare l'esperienza.

La cronologia e ripresa di chat rappresenta un salto qualitativo nell'esperienza utente con gli Agenti AIsuru, trasformando interazioni sporadiche in relazioni durature e produttive. Sfruttala al massimo per creare esperienze conversazionali che crescono e migliorano nel tempo! 🚀