# 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:**
  * &#x20;**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! 🚀


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.aisuru.com/condivisione/condivisione-sezione-avanzata/cronologia-e-ripresa-di-chat.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
