Ogni passaggio all'interno di un questionario Flusso e un nodo. Questo riferimento documenta tutti i tipi di nodo disponibili: cosa fa ciascuno, come configurarlo e quale ruolo svolge nella sessione di un rispondente. I nodi sono collegati da archi sul canvas del grafo per definire il flusso che il rispondente segue.
Il componente fondamentale di ogni questionario. Un nodo Domanda presenta un prompt al rispondente e attende la sua risposta prima di avanzare la sessione al nodo successivo. Il tipo di risposta del nodo determina quale tipo di input viene accettato e quante porte di uscita il nodo espone sul canvas.
| Campo | Descrizione |
|---|---|
| Testo della domanda | Il prompt mostrato al rispondente. Solo testo semplice. |
| Tipo di risposta | Controlla quale tipo di risposta viene accettata e come vengono generate le porte di uscita. Vedi la tabella Tipi di Risposta qui sotto. |
| Opzioni | (Solo Scelta Singola e Scelta Singola + Altro) L'elenco delle scelte presentate al rispondente. Ogni opzione ha una chiave (usata internamente come handle della porta e identificatore della risposta) e un'etichetta (mostrata al rispondente). |
Ogni tipo di risposta genera un diverso set di porte di uscita sul bordo destro del nodo. Collega ogni porta di uscita al nodo verso cui la sessione deve avanzare quando viene data quella risposta.
| Tipo di risposta | Porte di uscita | Note |
|---|---|---|
| Booleano (Si / No) | Si, No | Due porte fisse. Collega ciascuna a un ramo diverso del grafo. Nella distribuzione WhatsApp, Flusso accetta frasi affermative/negative comuni e, in caso di ambiguita, ricorre al provider AI configurato. |
| Scelta Singola | Una porta per opzione | Definisci l'elenco delle scelte. Ogni opzione diventa una porta di uscita con il nome della chiave dell'opzione. Nella distribuzione WhatsApp, il rispondente puo rispondere con il numero dell'opzione, il testo dell'etichetta o una parafrasi — il classificatore AI risolve le risposte ambigue. |
| Scelta Singola + Altro | Una porta per opzione, piu Altro | Come Scelta Singola ma aggiunge una porta Altro extra. Se il rispondente digita una risposta che non corrisponde a nessuna opzione elencata e la classificazione AI non riesce a mapparla a una scelta nota, la sessione procede attraverso Altro. |
| Testo Libero | Risposta | Una singola porta di uscita. Il rispondente digita una risposta libera che viene memorizzata cosi com'e. Il classificatore AI non viene coinvolto — tutte le risposte passano attraverso la porta Risposta indipendentemente dal contenuto. |
| Valutazione Numerica | Una porta per valore (fino a 10), oppure Risposta | Il rispondente seleziona un valore numerico da un intervallo configurabile. Configura Min, Max e Step per definire la scala (es. 1–5, 0–10). Se l'intervallo produce 10 o meno valori, ogni valore ottiene la propria porta di uscita per la ramificazione per valore. Se piu di 10, viene usata una singola porta Risposta. Nell'incorporamento web, i valori sono visualizzati come una riga orizzontale di pulsanti. |
| Selezione Multipla | Risposta | Il rispondente seleziona una o piu opzioni da un elenco di caselle di controllo. Configura Selezioni Minime (predefinito 1) e opzionalmente Selezioni Massime per limitare quante opzioni possono essere scelte. Viene usata una singola porta Risposta — le chiavi selezionate vengono memorizzate come stringa separata da virgole. Su WhatsApp, un pulsante "Fatto" conferma la selezione. |
| Testo Validato | Risposta | Una singola porta di uscita. Come Testo Libero, ma l'input viene validato rispetto a un formato specifico: Email, Telefono o URL. Le voci non valide vengono rifiutate con un errore di validazione (puoi impostare un messaggio di errore personalizzato). L'incorporamento web mostra un suggerimento sul formato sotto il campo di input. |
| Scala Likert | Una porta per punto della scala | Il rispondente sceglie da un set di punti etichettati della scala (es. da "Fortemente in disaccordo" a "Fortemente d'accordo"). Definisci ogni punto con una chiave e un'etichetta. Ogni punto diventa una porta di uscita con nome, abilitando la ramificazione basata sul sentimento. Nell'incorporamento web, i punti sono visualizzati come una riga orizzontale. |
Ogni nodo domanda puo avere fino a 5 allegati — immagini, PDF o documenti. Gli allegati vengono caricati dal pannello di configurazione del nodo domanda nell'editor. Nell'incorporamento web, le immagini allegate appaiono come una galleria orizzontale sopra i controlli di risposta, mentre i file non immagine (PDF, documenti) sono mostrati come schede file scaricabili con nome e dimensione. Su WhatsApp, gli allegati non vengono inviati inline — i rispondenti vi accedono tramite l'URL dell'incorporamento web.
| Dettaglio | Valore |
|---|---|
| Allegati massimi per nodo | 5 |
| Dimensione massima file | 10 MB |
| Formati consentiti | PDF, JPG, JPEG, PNG, GIF, WebP, TXT, DOC, DOCX |
| Archiviazione | I file sono archiviati privatamente sul server e serviti attraverso un endpoint protetto da token pubblico. Non e richiesta archiviazione file esterna. |
| Pulizia | Quando un nodo o un questionario viene eliminato, i file allegati vengono automaticamente rimossi dall'archiviazione. |
Ogni nodo domanda puo includere fino a 20 voci FAQ — coppie di domanda e risposta che aiutano i rispondenti a capire cosa viene chiesto. Le FAQ vengono aggiunte dal pannello di configurazione del nodo domanda nell'editor.
Un nodo terminale che conclude la sessione del rispondente. Ogni ramo nel grafo di un questionario deve terminare con un nodo di Completamento — la sessione non puo avanzare oltre questo punto. Il nodo viene visualizzato in verde sul canvas.
| Campo | Descrizione |
|---|---|
| Stato | Successo o Fallimento. Controlla l'icona e il trattamento visivo mostrato al rispondente quando la sessione termina. |
| Messaggio di successo | Testo visualizzato al rispondente quando la sessione termina con stato Successo. |
| Messaggio di fallimento | Opzionale. Mostrato quando lo stato e Fallimento al posto del messaggio di successo. |
| URL di reindirizzamento | Opzionale. Dopo aver mostrato il messaggio di completamento, l'incorporamento web reindirizza automaticamente il browser del rispondente a questo URL. Non ha effetto per la distribuzione WhatsApp. |
Ogni nodo di completamento puo opzionalmente esportare le risposte del rispondente in un foglio Google Sheets quando la sessione si completa. Questo viene configurato nel pannello di configurazione del nodo di completamento nella sezione Esportazione Google Sheets.
/spreadsheets/d/ e /edit.
| Modalita | Descrizione |
|---|---|
| Auto | Esporta automaticamente tutte le risposte come una singola riga. Le colonne corrispondono ai nodi domanda nell'ordine di attraversamento del grafo. Le intestazioni sono il testo della domanda (o la chiave del nodo se vuoto). Tre colonne di metadati vengono aggiunte: ID Sessione, Canale e Completato il. Alla prima esportazione su un foglio vuoto, una riga di intestazione viene inserita automaticamente prima della riga dati. |
| Manuale |
Utilizza un template JSON personalizzato per definire esattamente quali valori esportare.
Il template e un array JSON di valori con segnaposto
{{ "{{" }}answer.KEY{{ "}}" }} che vengono risolti rispetto alle risposte
raccolte nella sessione. Usa questa modalita quando hai bisogno di un layout colonne
specifico o vuoi includere valori calcolati.
|
Effettua una richiesta HTTP in uscita quando la sessione raggiunge questo nodo. La richiesta viene eseguita in background — il rispondente non resta in attesa della risposta. Usa questo nodo per inviare dati della sessione ad API esterne, CRM o webhook durante il questionario. Il nodo viene visualizzato in ambra sul canvas.
| Campo | Descrizione |
|---|---|
| URL | L'endpoint da chiamare. Deve essere un URL completo (includi https://). |
| Metodo | GET, POST, PUT, PATCH o DELETE. |
| Body |
Corpo JSON inviato con la richiesta (applicabile per POST/PUT/PATCH). Puoi fare
riferimento alle risposte raccolte in precedenza nella sessione usando la sintassi delle
variabili: {{ answers.question_key }}.
|
Attiva un Workflow Flusso quando la sessione raggiunge questo nodo. Usalo per trasferire i dati raccolti durante il questionario — come risposte, metadati del rispondente o stato della sessione — in un workflow di automazione completo per elaborazione, arricchimento o notifica. Il nodo viene visualizzato in viola sul canvas.
| Campo | Descrizione |
|---|---|
| ID Workflow | L'ID del workflow Flusso da attivare. Il workflow di destinazione deve avere un nodo Trigger Manuale come punto di ingresso per poter accettare un payload esterno. |
| Mappatura Payload |
Mappa le chiavi delle risposte del questionario ai nomi delle variabili di input del
workflow. Ogni riga definisce una mappatura: chiave risposta → nome
variabile workflow. I valori mappati sono disponibili nel workflow attivato come
{{ trigger.output.variable_name }}.
|
Invia una notifica HTTP POST a un URL esterno quando la sessione raggiunge questo nodo. Simile al nodo HTTP ma progettato specificamente per pattern di distribuzione webhook — invia sempre un POST con un payload JSON configurabile. Il nodo viene visualizzato in rosa sul canvas.
| Campo | Descrizione |
|---|---|
| URL Webhook | L'URL di destinazione per la richiesta POST. |
| Payload |
Corpo JSON da inviare. Puoi incorporare le risposte della sessione usando la sintassi
delle variabili: {{ answers.question_key }}.
|