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.