# Scrivere un percorso

> Percorsi guidati · Passi, frasi di attivazione e come l'assistente capisce che un passo è finito.

Un percorso ha un **nome** (come lo chiama l'assistente ad alta voce), una **frase di attivazione** e i suoi **passi** in ordine. Lo scrivi nella pagina Journeys; anche un agente di programmazione collegato tramite MCP può prepararne una bozza per te, e una bozza non viene mai eseguita finché non la pubblichi.

## La frase di attivazione

La frase di attivazione viene confrontata con **quello che ha scritto il visitatore**, quindi scrivi una frase e non un'etichetta di menu: *"quando il visitatore vuole restituire o rimandare indietro qualcosa che ha acquistato"*. Un sostantivo come "Resi" non corrisponde quasi a nulla.

## Come finisce un passo

Ogni passo indica come sappiamo che è finito. È un elenco chiuso, senza condizioni in testo libero, perché una condizione che il motore non può verificare è una condizione che, in silenzio, non scatta mai.

| Finisce quando | Richiede |
| --- | --- |
| `click_self` | È stato fatto clic sul target del passo stesso. |
| `visible` / `hidden` | Un elemento target compare o scompare. |
| `filled` | Un campo target ha un valore. |
| `url_change` | L'indirizzo cambia in quello che indichi. |
| `settled` | Un target smette di cambiare. |
| `attempts` | Un numero di tentativi. |
| `user_continue` | Il visitatore preme Continua. Obbligatorio per i passi hold. |

> **Regola:** **Un passo che apre una pagina deve finire con qualcosa che la pagina può mostrare.** Aprire una pagina smonta lo script e lo ricostruisce sulla nuova pagina, quindi un evento atteso, come un clic, non può mai arrivare: il passo riaprirebbe la pagina a ogni caricamento. Per questo l'editor propone solo `url_change`, `visible` e `filled` per un passo "apri una pagina", e il server rifiuta un piano che dica il contrario. Il motore inoltre ferma un passo dopo due navigazioni, così un piano sbagliato non può mai lasciare il tuo sito a ricaricarsi.

C'è un'altra cosa che il motore fa per te: **aspetta** che il target di un passo compaia (qualche secondo, controllando di continuo) prima di decidere che manca. Una pagina che mostra il suo modulo un attimo dopo il caricamento è normale, e non deve fermare un percorso.

## Pubblicazione

Ciò che viene pubblicato è una **versione specifica**. Modificare un percorso pubblicato lo mette offline, così un piano che nessuno ha approvato non può mai essere in esecuzione sul tuo sito. Rileggi i passi, poi pubblica di nuovo.

> **Suggerimento:** Gran parte del lavoro su un percorso consiste nell'indicare gli elementi giusti della pagina. Il target di un passo deve corrispondere a **un solo** elemento: `#country-select` o `select[aria-label="Passport"]` vanno bene se sulla pagina c'è una sola cosa che vi corrisponde, mentre un semplice `button` viene rifiutato: un riferimento che può indicare quaranta cose non è un puntatore. Se hai collegato un agente di programmazione (vedi **Agenti di programmazione**), può leggere le tue pagine e preparare i passi: tu controlli e pubblichi.

---

Leggi questa pagina sul web: [Scrivere un percorso](/it/docs/journeys/writing-a-journey)
