# Escribir un recorrido

> Recorridos guiados · Pasos, frases de activación y cómo sabe el asistente que un paso ha terminado.

Un recorrido tiene un **nombre** (cómo lo llama el asistente en voz alta), una **frase de activación** y sus **pasos** en orden. Lo escribes en la página Journeys; un agente de programación conectado por MCP también puede redactarte un borrador, y un borrador nunca se ejecuta hasta que lo publicas.

## La frase de activación

La frase de activación se compara con **lo que escribió el visitante**, así que escribe una frase, no una etiqueta de menú: *"cuando el visitante quiere devolver algo que ha comprado"*. Un sustantivo suelto como "Devoluciones" no coincide con casi nada.

## Cómo termina un paso

Cada paso indica cómo sabemos que ha terminado. Es una lista cerrada, sin condiciones de texto libre, porque una condición que el motor no puede comprobar es una condición que nunca se cumple, sin avisar.

| Termina cuando | Necesita |
| --- | --- |
| `click_self` | Se hizo clic en el propio objetivo del paso. |
| `visible` / `hidden` | Un elemento objetivo aparece o desaparece. |
| `filled` | Un campo objetivo tiene un valor. |
| `url_change` | La dirección cambia a una que tú indicas. |
| `settled` | Un objetivo deja de cambiar. |
| `attempts` | Un número de intentos. |
| `user_continue` | El visitante pulsa Continue. Obligatorio en los pasos hold. |

> **Regla:** **Un paso que abre una página debe terminar con algo que la página pueda mostrar.** Abrir una página destruye el script y lo reconstruye en la nueva página, así que un evento que iba a ocurrir —un clic— nunca puede llegar: el paso volvería a abrir la página en cada carga. Por eso el editor solo ofrece `url_change`, `visible` y `filled` para un paso de "abrir una página", y el servidor rechaza un plan que diga otra cosa. Además, el motor detiene un paso tras dos navegaciones, así que un plan erróneo nunca puede dejar tu sitio recargándose sin fin.

Hay algo más que el motor hace por ti: **espera** a que aparezca el objetivo de un paso (unos segundos, comprobando continuamente) antes de decidir que falta. Es normal que una página muestre su formulario un momento después de cargar, y eso no debería detener un recorrido.

## Publicar

Lo que se publica es una **versión concreta**. Editar un recorrido publicado lo desactiva, así que un plan que nadie ha aprobado nunca puede estar ejecutándose en tu sitio. Revisa los pasos y vuelve a publicarlo.

> **Consejo:** La mayor parte del trabajo de un recorrido es nombrar los elementos correctos de tu página. El objetivo de un paso debe coincidir con **exactamente un** elemento: `#country-select` o `select[aria-label="Passport"]` sirven si solo hay un elemento en la página que les corresponda, mientras que un simple `button` se rechaza: una referencia que puede significar cuarenta cosas no apunta a nada. Si tienes conectado un agente de programación (consulta **Agentes de programación**), puede leer tus páginas y redactar los pasos; tú los revisas y los publicas.

---

Leer esta página en la web: [Escribir un recorrido](/es/docs/journeys/writing-a-journey)
