Documentazione · 🧭 Percorsi guidati

Come si svolge un percorso

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.