Escrevendo uma jornada
Passos, gatilhos e como o assistente sabe que um passo terminou.
Uma jornada tem um nome (como o assistente se refere a ela em voz alta), uma frase de gatilho e seus passos, em ordem. Você a escreve na página Journeys; um agente de programação conectado via MCP também pode criar um rascunho para você — um rascunho nunca roda até você publicá-lo.
A frase de gatilho#
O gatilho é comparado com o que o visitante digitou, então escreva uma frase, não um rótulo de menu: *"quando o visitante quer devolver ou mandar de volta algo que comprou"*. Um substantivo solto como "Devoluções" não corresponde a quase nada.
Como um passo termina#
Todo passo diz como sabemos que ele terminou. É uma lista fechada — não existe condição em texto livre, porque uma condição que o motor não consegue verificar é uma condição que, em silêncio, nunca dispara.
| Termina quando | Precisa de |
|---|---|
click_self | O próprio alvo do passo foi clicado. |
visible / hidden | Um elemento alvo aparece ou desaparece. |
filled | Um campo alvo tem um valor. |
url_change | O endereço muda para algo que você indica. |
settled | Um alvo para de mudar. |
attempts | Um número de tentativas. |
user_continue | O visitante aperta Continuar. Obrigatório em passos hold. |
Regra: Um passo que abre uma página precisa terminar em algo que a página consiga mostrar. Abrir uma página desmonta o script e o reconstrói na nova página, então um evento que ia acontecer — um clique — nunca chega: o passo abriria a página de novo a cada carregamento. Por isso o editor oferece só url_change, visible e filled para um passo de "abrir uma página", e o servidor recusa um plano que diga o contrário. O motor também interrompe um passo depois de duas navegações, então um plano errado nunca deixa seu site recarregando sem parar.
Mais uma coisa que o motor faz por você: ele espera o alvo de um passo aparecer (alguns segundos, verificando continuamente) antes de concluir que ele não existe. Uma página que renderiza o formulário um instante depois de carregar é normal, e isso não deve interromper uma jornada.
Publicação#
O que é publicado é uma versão específica. Editar uma jornada publicada a tira do ar, para que um plano que ninguém aprovou nunca esteja rodando no seu site. Leia os passos e publique de novo.
Dica: A maior parte do trabalho em uma jornada é nomear os elementos certos da sua página. O alvo de um passo precisa corresponder a exatamente um elemento — #country-select ou select[aria-label="Passport"] servem se só uma coisa na página corresponder a eles, enquanto um button sozinho é recusado: uma referência que pode significar quarenta coisas não é um ponteiro. Se você tem um agente de programação conectado (veja Agentes de programação), ele pode ler suas páginas e rascunhar os passos — você revisa e publica.