> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vetox.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Ho bisogno di aiuto — sessioni di supporto

> Fai in modo che un agente di supporto Vetox ti assista live nella tua dashboard — cosa può vedere, cosa no e come terminarla.

Una sessione di supporto permette a un agente Vetox di vedere la tua dashboard live e guidarti attraverso un problema. Tu la approvi, la osservi e puoi terminarla in qualsiasi momento.

Il pulsante **I Need Help** si trova in fondo alla barra laterale del tuo server.

## Il tuo codice di supporto

Aprire il pannello mostra un codice monouso nella forma `XXXX-XXXX`.

<Warning>
  **Condividi questo codice solo con un membro dello staff Vetox contattato tramite canali ufficiali.**

  Non darlo mai a chi ti ha scritto per primo. Un codice di supporto è la chiave della tua dashboard — chiunque lo abbia può richiedere una sessione sul tuo server.
</Warning>

|                |                                       |
| -------------- | ------------------------------------- |
| **Ruota ogni** | 5 minuti                              |
| **Utilizzi**   | Uno                                   |
| **Ambito**     | L'unico server da cui lo hai generato |

Puoi aggiornarlo manualmente. Il pannello richiede un codice solo quando lo apri effettivamente.

<Note>
  Ti serve accesso admin al server per generare un codice. Il codice è legato a quel server nel momento in cui viene riscattato — un agente non può reindirizzarlo a un server diverso in seguito.
</Note>

## Approvare una sessione

<Steps>
  <Step title="Ricevi un prompt di approvazione">
    Che mostra il nome e l'avatar dell'agente. Hai **60 secondi** per rispondere.
  </Step>

  <Step title="Accetti o rifiuti">
    Rifiutare la termina immediatamente. Ignorarla la fa scadere.
  </Step>

  <Step title="La sessione inizia in sola lettura">
    L'agente può vedere la tua dashboard ma non può cambiare nulla.
  </Step>
</Steps>

<Note>
  **Le sessioni iniziano sempre in sola lettura.** La modifica è disattivata di default e solo tu puoi attivarla.
</Note>

## Durante una sessione

Un widget di controllo trascinabile resta sullo schermo mostrando il nome dell'agente e il tempo trascorso, con due controlli:

| Controllo         | Effetto                                                                                                       |
| ----------------- | ------------------------------------------------------------------------------------------------------------- |
| **Allow editing** | Concede all'agente il permesso di fare modifiche. Disattivato di default; puoi revocarlo in qualsiasi momento |
| **End session**   | La termina immediatamente                                                                                     |

C'è anche un pannello chat per parlare con l'agente.

Mentre la sessione è in sola lettura, uno scudo impedisce che click e tasti accidentali vengano interpretati come tuo input. Lo scrolling funziona comunque normalmente.

## Cosa può e non può fare un agente

<AccordionGroup>
  <Accordion title="Può vedere solo l'unico server" icon="lock">
    Una sessione è bloccata al singolo server da cui hai generato il codice. Ogni tentativo di raggiungere un altro server viene rifiutato.
  </Accordion>

  <Accordion title="Non può vedere fatturazione o dettagli di pagamento" icon="credit-card">
    Le pagine premium, i metodi di pagamento e le impostazioni del tuo account sono del tutto fuori ambito. La restrizione è applicata sul server, non solo nascosta nell'interfaccia.
  </Accordion>

  <Accordion title="Non può leggere i tuoi segreti" icon="key">
    URL webhook, token bot, chiavi API e signing secret vengono sostituiti con `[redacted]` prima che raggiungano l'agente — e risalvare un form che ha visto non può sovrascrivere il valore reale con il placeholder.
  </Accordion>

  <Accordion title="Non può cambiare nulla finché non lo permetti" icon="pen-slash">
    Ogni tentativo di modifica viene rifiutato mentre la sessione è in sola lettura, indipendentemente da cosa sembra permettere l'interfaccia.
  </Accordion>

  <Accordion title="Non può vedere il tuo schermo" icon="eye-slash">
    Nulla viene condiviso in screen sharing o rispecchiato. Il tuo browser renderizza la tua dashboard; le azioni dell'agente vengono trasmesse come istruzioni specifiche come scroll, click o evidenzia. La posizione del suo mouse non è mai tracciata.
  </Accordion>

  <Accordion title="Non può bypassare una blacklist server" icon="ban">
    Un server in blacklist resta bloccato durante una sessione. Una sessione non può essere usata per aggirarla.
  </Accordion>
</AccordionGroup>

## Limiti

| Limite                   | Valore                                 |
| ------------------------ | -------------------------------------- |
| Durata massima sessione  | **30 minuti**                          |
| Timeout di inattività    | 10 minuti, con un avviso a 8           |
| Finestra di approvazione | 60 secondi                             |
| Sessioni concorrenti     | Una per server, per utente, per agente |

Vieni avvisato 2 minuti prima che una sessione raggiunga il cap di 30 minuti.

## Terminare una sessione

Entrambe le parti possono terminarla, e termina anche da sola se chiudi la scheda, l'agente chiude la sua, viene raggiunto il timeout di inattività, o scade il cap di 30 minuti.

Dopo la fine ti viene chiesto di valutare la sessione. È opzionale.

## Cosa viene registrato

Ogni sessione viene registrata permanentemente: chi era l'agente, quale server, quando è iniziata e finita, perché è finita, quante modifiche sono state fatte e se hai concesso la modifica.

<Note>
  Questo record esiste per la tua protezione — c'è una traccia duratura e verificabile di ogni sessione di supporto sul tuo server, incluse le sessioni che hai rifiutato.
</Note>

## Risoluzione dei problemi

<AccordionGroup>
  <Accordion title="Non riesco a generare un codice">
    Ti serve accesso admin a quel server.
  </Accordion>

  <Accordion title="L'agente dice che il mio codice non è valido">
    I codici ruotano ogni 5 minuti e sono monouso. Aggiorna e invia quello nuovo.
  </Accordion>

  <Accordion title="Una sessione non parte">
    Solo una sessione può essere attiva per server alla volta, e devi essere online con la dashboard aperta per ricevere il prompt di approvazione.
  </Accordion>

  <Accordion title="L'agente non riesce a cambiare un'impostazione">
    La modifica non è stata concessa. Attiva **Allow editing** nel widget di controllo.
  </Accordion>

  <Accordion title="Voglio che si fermi subito">
    Premi **End session**, o semplicemente chiudi la scheda. L'accesso viene revocato immediatamente — viene ricontrollato ad ogni singola richiesta invece che essere considerato affidabile per la durata della sessione.
  </Accordion>
</AccordionGroup>