# Come si svolge un percorso

> Percorsi guidati · Chi agisce, cosa può vedere l'assistente e cosa succede quando un passo non può essere eseguito.

Quando un visitatore chiede qualcosa che rientra in un percorso, l'assistente lo avvia e poi si fa da parte. Da quel momento i passi vengono eseguiti da un motore che gira **sulla tua pagina**, senza nessun modello coinvolto. L'assistente racconta; non guida.

## Cosa riceve l'assistente

Di un percorso l'assistente riceve due cose: il **nome** e la **frase di attivazione**. I passi, e gli elementi a cui puntano, non gli vengono mai inviati: né prima, né durante, né dopo.

> **Regola:** Ecco perché *"non compie mai un passo che nessuno ha scritto"* è un fatto e non un'intenzione. Il nome di un elemento che arriva al modello è un nome di cui il modello potrebbe produrre una variante. Non arriva mai al modello, quindi non c'è nessuna variante da produrre.

## Cosa vede il visitatore

- Una piccola scheda in chat che mostra quale passo è in corso e quanti sono in tutto.
- In un passo **guide**, l'istruzione di fare quel passo da solo, con l'elemento giusto indicato sulla pagina.
- In un passo **hold**, un pulsante **Continua**: nulla si muove finché non lo preme.
- Un modo per interrompere tutto, a qualsiasi passo, senza uscire dalla chat.

## Quando un passo non può essere eseguito

Prima di ogni azione il motore controlla l'elemento che sta per toccare: è davvero sulla pagina, è visibile, è interattivo, e corrisponde allo stesso elemento che gli è stato indicato? Se una di queste verifiche fallisce, il passo viene **scartato, non tentato**. Un passo su cui il motore ha dubbi è un passo che non esegue.

Se lo stesso passo viene scartato tre volte di seguito, il percorso si ferma e ne spiega il motivo. L'assistente riprende poi la conversazione normalmente. Una pagina che è cambiata sotto un percorso lo chiude con garbo; non lascia il visitatore a guardare qualcosa che riprova da solo.

## Come finisce

All'assistente viene comunicato il risultato **una sola volta per percorso**, non passo per passo, e solo quando è terminato: completato o interrotto. Finché quel messaggio non arriva, non afferma che qualcosa sia fatto, perché davvero non lo sa.

## Dove viene eseguito

Il pannello della chat si trova in un frame separato sul nostro dominio; il motore gira sulla tua pagina. Solo quattro cose attraversano quel confine: il piano da eseguire, *continua*, *interrompi* e a che punto è ogni passo. Chi è il visitatore, la sua sessione e il testo della conversazione restano dalla nostra parte e non entrano mai nella tua pagina.

> **Suggerimento:** In un progetto senza percorsi il motore non viene nemmeno scaricato: nessuna richiesta in più, nulla di aggiunto alla tua pagina.

### Il percorso non parte mai.

O la funzione non è attiva per il progetto (controlla nella pagina Journeys se un requisito è venuto meno), oppure la frase di attivazione non assomiglia a quello che ha scritto il visitatore. Le frasi di attivazione vengono confrontate con frasi reali, non con etichette di menu.

### Si ferma a metà.

Un passo non ha trovato per tre volte l'elemento su cui doveva fare clic. Di solito significa che la pagina è cambiata: un elemento è stato rinominato, spostato o ora compare solo dopo qualcos'altro. Apri il percorso, correggi quel passo e pubblicalo di nuovo.

### È in attesa e non succede nulla.

È su un passo hold o guide, esattamente dove deve aspettare il visitatore. Questi passi finiscono quando il visitatore agisce o preme Continua, mai da soli.

---

Leggi questa pagina sul web: [Come si svolge un percorso](/it/docs/journeys/how-a-journey-runs)
