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

# Risoluzione dei problemi

> Le cause più comuni dei problemi in Exoid e come risolverle, dai prerequisiti nascosti agli errori di configurazione.

Quando qualcosa non funziona come ti aspetti, quasi sempre la causa è una di poche. Qui trovi i punti in cui gli utenti si fermano davvero, descritti con le parole con cui te ne accorgeresti, e la soluzione con il link alla pagina di approfondimento.

<Tip>
  Se una funzione che cerchi non compare nell'interfaccia, controlla per prima cosa la **Modalità statistiche avanzate**: è la causa più frequente. Diverse funzionalità restano nascoste finché non la attivi dalle [impostazioni dell'intervista](/it/avanzate/statistiche-avanzate).
</Tip>

## Funzioni che non compaiono nell'interfaccia

<AccordionGroup>
  <Accordion title="Non trovo l'export SPSS" icon="download">
    L'export SPSS `.sav` richiede la **Modalità statistiche avanzate** attiva nelle impostazioni della campagna. Finché non la attivi, il formato non compare tra le opzioni di esportazione.

    Attivala dalle [impostazioni dell'intervista](/it/avanzate/statistiche-avanzate), poi torna in **Risultati → Risposte** e riprova l'export. Vedi [Export dei dati](/it/analisi/export) per i formati disponibili.
  </Accordion>

  <Accordion title="Non riesco a usare le variabili di contesto" icon="braces">
    Stesso prerequisito: le variabili di contesto richiedono la **Modalità statistiche avanzate**, che attivi dalle impostazioni nel menu laterale.

    Vedi [Modalità statistiche avanzate](/it/avanzate/statistiche-avanzate) e [Variabili di contesto](/it/logica/variabili).
  </Accordion>

  <Accordion title="Cerco la condizione di visibilità e non trovo il pulsante" icon="eye">
    La condizione di visibilità sta sul blocco, ed è disponibile su qualsiasi blocco da dove lo apri: canvas o vista a elenco. Quello che spiazza è l'etichetta: il pulsante si chiama **Condizione di salto**, ma il modale che apre si intitola **Visibility condition** e in cima ha un selettore **Show / Skip**.

    Vedi [Logiche e condizioni](/it/logica/condizioni).
  </Accordion>

  <Accordion title="Non trovo l'export CSV" icon="download">
    Non esiste. Exoid esporta Excel e SPSS dalle Risposte, PDF ed Excel dal Riepilogo, PowerPoint e Word dall'AI Report.

    Se un tool a valle richiede un CSV, esporta l'Excel dalle Risposte e convertilo. Vedi [Export dei dati](/it/analisi/export).
  </Accordion>

  <Accordion title="Cerco i template" icon="layout-template">
    Non c'è una galleria di template. Una campagna nasce in un modo solo: **Nuova campagna** apre **What do you want to build?**, dove descrivi lo studio all'AI — allegando un PDF o un DOCX se hai un brief — oppure scegli **Start from scratch**.

    Vedi [Il Builder](/it/builder/panoramica) e [AI Interview Builder](/it/builder/ai-builder).
  </Accordion>
</AccordionGroup>

## Il flusso dell'intervista non si comporta come previsto

<AccordionGroup>
  <Accordion title="Una domanda non appare ai rispondenti, ma la vedo nei risultati" icon="alert-triangle">
    Il blocco esiste nel builder ma non è collegato al flusso, quindi i rispondenti non lo raggiungono — pur restando presente nei risultati.

    In fase di pubblicazione il sistema segnala il problema con l'avviso **Nodi non collegati — Una domanda non è collegata e non apparirà nel tuo sondaggio.** Collega il blocco trascinando il connettore dal punto di uscita del blocco precedente, oppure cancellalo. Vedi [Il Builder](/it/builder/panoramica).
  </Accordion>

  <Accordion title="Ho impostato un'espressione logica ma non succede niente" icon="code">
    L'espressione richiama il codice della domanda di origine. Se il campo **Codice domanda** del blocco di origine è rimasto al valore di default, l'espressione non può essere valutata e la logica non funziona.

    Apri le impostazioni del blocco di origine, imposta un codice esplicito (per esempio `D8`) e richiamalo nel blocco di destinazione. Vedi [Espressioni logiche avanzate](/it/logica/espressioni).
  </Accordion>

  <Accordion title="Non riesco a eliminare o riordinare le domande" icon="move">
    È un limite attuale del Linear Builder: nella vista lineare non puoi modificare la struttura dell'intervista, quindi non elimini né sposti le domande su o giù.

    Esci dalla vista lineare con la ✕ in alto a destra, torna al Visual Builder, cancella o riordina i blocchi sul canvas e rientra nel Linear Builder per continuare a lavorare su logiche e condizioni. Vedi [Linear Builder](/it/builder/linear-builder).
  </Accordion>

  <Accordion title="Nel testo della domanda vedo il nome della variabile invece del valore" icon="braces">
    Due cause possibili. La prima è la sintassi: una variabile si scrive con le doppie graffe, come `{{nome_variabile}}`. La seconda è che la variabile non è mai stata impostata — un valore le arriva in tre modi: manualmente, da un parametro dell'URL, oppure dalla risposta a una domanda.

    Ricorda anche che se lo stesso nome viene riusato più avanti, vince l'ultimo valore assegnato. Vedi [Variabili di contesto](/it/logica/variabili).
  </Accordion>
</AccordionGroup>

## Distribuzione e recruiting

<AccordionGroup>
  <Accordion title="Non riesco a lanciare il recruiting: il pulsante è disattivato" icon="users-round">
    Per lanciare il reclutamento devono essere soddisfatte tre condizioni insieme:

    * almeno un profilo configurato nella sezione **Profiling**
    * tutti i campi obbligatori compilati — il **Tempo di fielding** è l'unico marcato come tale
    * **Feasibility** maggiore di zero

    Se la Feasibility è a zero il lancio resta bloccato finché non allenti i filtri di targeting. Vedi [Recluta partecipanti](/it/distribuzione/recruiting).
  </Accordion>

  <Accordion title="Il costo stimato è più alto di quanto mi aspettavo" icon="credit-card">
    Il costo totale è il CPI moltiplicato per i completamenti richiesti. Il CPI sale quando l'**Incidenza attesa** è bassa — il sistema deve contattare più persone per raggiungere il campione — e quando la **durata attesa dell'intervista** è lunga.

    Rivedi questi due parametri e la restrittività dei profili applicati prima di lanciare. Vedi [Recluta partecipanti](/it/distribuzione/recruiting).
  </Accordion>

  <Accordion title="Un rispondente ha perso le risposte a metà intervista" icon="repeat">
    Exoid salva automaticamente le risposte mentre l'intervista è in corso, nel browser del partecipante, e ripristina pagina corrente, risposte già inserite e avanzamento.

    Il recupero però richiede lo **stesso browser e lo stesso dispositivo** usati per iniziare: chi riprende da un altro dispositivo o da un browser diverso riparte da capo. Vedi [Condividere il link](/it/distribuzione/link).
  </Accordion>

  <Accordion title="I rispondenti non riescono ad aprire l'intervista" icon="circle-play">
    Finché l'intervista è in stato **Bozza** non è accessibile ai rispondenti. Controlla lo stato in cima alla pagina e attiva l'interruttore **Abilita sondaggio**: la campagna passa da Bozza a Live e l'intervista si può condurre tramite link o canali di distribuzione.

    Vedi [Pubblicare il tuo studio](/it/distribuzione/pubblicazione).
  </Accordion>

  <Accordion title="Cerco il codice di embed o il QR code" icon="link">
    Non esistono né l'uno né l'altro. **Copia link sondaggio** mette l'URL negli appunti e basta: non apre nessun pannello, e non c'è un'interfaccia per codici di embed, QR code o parametri del link.

    Tutto quello che fai con il link avviene fuori da Exoid — mettilo dietro una call to action su una landing page, in una newsletter, o genera il QR code con un tuo strumento. Vedi [Condividere il link](/it/distribuzione/link).
  </Accordion>
</AccordionGroup>

## Webhook

<AccordionGroup>
  <Accordion title="Il mio endpoint non riceve nulla" icon="webhook">
    Controlla nell'ordine:

    * **Abilita Webhook** deve essere attivo per quella campagna, da **Impostazioni → Webhook**
    * l'**URL Webhook** deve essere l'indirizzo completo dell'endpoint corretto
    * nei **Webhook Requests** verifica il codice di stato restituito

    Se vedi risposte `400`, `401`, `403` o `404`, si tratta di errori permanenti: non generano alcun ritentativo e l'evento viene perso. Usa **Test Webhook** per una prova a vuoto. Vedi [Configurazione](/it/webhooks/configurazione) e [Come funzionano](/it/webhooks/introduzione).
  </Accordion>

  <Accordion title="La verifica della firma fallisce sempre" icon="shield">
    Exoid firma il **raw body** della richiesta, cioè il corpo non parsato, con HMAC-SHA256. Se applichi `JSON.parse` (o un middleware come `express.json()`) prima della verifica e poi ri-serializzi l'oggetto, i byte cambiano — spaziatura, ordine delle chiavi, escaping — e il confronto fallisce anche su richieste legittime.

    Calcola l'HMAC sul raw Buffer, ad esempio con `express.raw`, e fai `JSON.parse` solo dopo aver validato la firma. Vedi [Firma e sicurezza](/it/webhooks/sicurezza).
  </Accordion>
</AccordionGroup>

## Team e permessi

<AccordionGroup>
  <Accordion title="Non trovo un collega tra i collaboratori della campagna" icon="users">
    Nell'elenco dei collaboratori compaiono esclusivamente gli utenti già presenti nel workspace.

    Aggiungi prima la persona da **Membri → Gestione utenti** nel menu laterale, poi riapri la finestra dei collaboratori della campagna e selezionala. Vedi [Collaborare alle campagne](/it/workspace/collaborazione) e [Ruoli e permessi](/it/workspace/ruoli).
  </Accordion>

  <Accordion title="Un utente vede la campagna ma non può modificarla" icon="shield-check">
    Visibilità e permessi sono due cose distinte. L'impostazione pubblica/privata della campagna controlla solo chi la vede: non modifica i permessi di modifica o di pubblicazione, che dipendono dal ruolo assegnato nell'organizzazione.

    Per cambiare cosa può fare un utente intervieni sul ruolo, dalla tendina sulla sua riga in **Gestione utenti**. I ruoli sono due: Amministratore e Ospite. Vedi [Ruoli e permessi](/it/workspace/ruoli) e [Collaborare alle campagne](/it/workspace/collaborazione).
  </Accordion>
</AccordionGroup>

## Risultati

<AccordionGroup>
  <Accordion title="L'AI Report contiene imprecisioni" icon="file-text">
    Il report generato va sempre revisionato prima della condivisione: l'AI accelera la prima versione, ma il controllo finale resta tuo.

    Correggi il documento nel workspace dedicato, manualmente tramite l'editor oppure chiedendo all'AI di riscrivere le sezioni specifiche, ed esporta solo dopo la revisione. Vedi [AI Report](/it/analisi/ai-report).
  </Accordion>

  <Accordion title="L'export non contiene le risposte che mi aspettavo" icon="table">
    Esporti ciò che selezioni: la tipologia di risposta scelta in alto a sinistra nella tabella determina il dataset dell'export. Se sono attive le **Risposte Screened Out**, il file conterrà i rispondenti non qualificati, non il campione principale.

    Controlla sempre il selettore prima di lanciare l'esportazione. Vedi [Export dei dati](/it/analisi/export).
  </Accordion>

  <Accordion title="Non riesco a filtrare i risultati per età, genere o area geografica" icon="filter">
    I filtri del Riepilogo si costruiscono sulle **tue** domande, non su una libreria di attributi demografici pronti. Ogni condizione è una domanda — scelta dal suo codice — un operatore e un valore.

    Se ti serve segmentare per un attributo, quell'attributo deve essere una domanda dell'intervista. Dagli un codice domanda chiaro e diventa filtrabile, oltre che utilizzabile come cluster di confronto. Vedi [Riepilogo](/it/analisi/riepilogo).
  </Accordion>
</AccordionGroup>

## Prossimi passi

<CardGroup cols={2}>
  <Card title="Modalità statistiche avanzate" icon="sigma" href="/it/avanzate/statistiche-avanzate">
    Il prerequisito dietro la maggior parte delle funzioni che non trovi.
  </Card>

  <Card title="Contatta il supporto" icon="send" href="mailto:support@exoid.io">
    Se il problema non è qui, scrivi al team Exoid.
  </Card>
</CardGroup>


## Related topics

- [Feedback e richieste](/it/feedback.md)
- [Documentazione Exoid](/it/index.md)
- [1 luglio 2026](/it/novita/2026-07-01.md)