# Escrevendo uma jornada

> Jornadas · 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.

---

Leia esta página na web: [Escrevendo uma jornada](/pt/docs/journeys/writing-a-journey)
