🔄 Ripresa delle Sessioni

La funzionalità di ripresa delle sessioni permette agli utenti di continuare conversazioni precedenti senza perdere il contesto, migliorando significativamente l'esperienza utente.

Come funziona

Quando viene fornito un sessionID, AIsuru verifica automaticamente la validità della sessione:

  • Sessione valida: recupera lo storico della conversazione e ripopola la chat, mostrando l'ultimo messaggio dell'Agente

  • Sessione non valida: crea una nuova sessione e mostra il messaggio di benvenuto

Importante: Le sessioni scadono dopo 1 ora di inattività.

Ottenere il sessionID

Dall'interfaccia di AIsuru

Il modo più semplice per trovare l'ID di una sessione:

  1. Accedi alla sezione <img src="../.gitbook/assets/conversazioni.svg" alt="" data-size="line"> Conversazioni del tuo Agente

  2. Clicca su <img src="../.gitbook/assets/URL.svg" alt="" data-size="line"> Apri per la conversazione desiderata

  3. Nella sezione "Informazioni sessione", troverai l'ID sessione

Tramite JavaScript

Per ottenere programmaticamente l'ID di una sessione attiva:

javascript// Sessione correnteconst sessionID = getMemoriState().sessionID;// Per widget con integrationID specificoconst sessionID = getMemoriState("mio-integration-id").sessionID;

Implementazione

Web Component

html<memori-client  memoriName="MioMemori"  ownerUserName="utente"  tenantID="aisuru.com"  sessionID="uuid-della-sessione-da-riprendere"></memori-client>

Componente React

tsx<Memori  memoriName="MioMemori"  ownerUserName="utente"  tenantID="aisuru.com"  sessionID="uuid-della-sessione-da-riprendere"/>

Casi d'uso comuni

Salvare e riprendere sessioni

javascript// Salva sessionIDdocument.addEventListener('MemoriNewDialogState', (e) => {  const sessionID = e.detail.sessionID;  localStorage.setItem('memori-session', sessionID);});// Riprendi sessione salvataconst savedSessionID = localStorage.getItem('memori-session');// Usa savedSessionID nell'attributo sessionID del componente

Integrazione con autenticazione utente

javascript// Associa sessione all'utente loggatoconst userSessionKey = `memori-session-${userId}`;localStorage.setItem(userSessionKey, sessionID);// Riprendi sessione per utente specificoconst userSessionID = localStorage.getItem(userSessionKey);

Vantaggi

  • Continuità dell'esperienza: gli utenti possono riprendere conversazioni interrotte

  • Mantenimento del contesto: l'Agente ricorda le informazioni della conversazione precedente

  • Gestione automatica: AIsuru gestisce automaticamente sessioni scadute o non valide

  • Flessibilità: compatibile con tutti i layout e le configurazioni

Last updated