> ## Documentation Index
> Fetch the complete documentation index at: https://wondeya.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Páginas

> Crear una página, darle una dirección y publicarla al mundo

Una página es una dirección dentro de tu sitio, con un agente que responde en ella. El agente es dueño del conocimiento, las imágenes y la identidad, y varias páginas pueden compartir un agente: una página principal, una línea de producto y una campaña sobre una misma base de conocimiento. La apariencia (logo, barra de navegación, pie de página, tema) es del sitio, así que todas las páginas la llevan. Dos productos sin relación quedan aislados dándole a cada uno su propio agente.

## Dos tipos de página

Una página puede ser de dos tipos, y eliges cuál al crearla:

* **Conversacional** es el tipo predeterminado: un agente responde a los visitantes, y tú escribes el editorial (etiqueta, titular, la línea debajo) que se muestra sobre el chat. A este tipo se refiere todo lo que sigue, salvo que una sección diga lo contrario.
* **Documento** es un archivo markdown que subes (una política de privacidad, términos de servicio, una página "acerca de"). No tiene **ni agente, ni editorial, ni chat**: renderiza tu markdown dentro de la barra de navegación y el pie de página del sitio, y todo lo que lee un visitante viene del archivo, incluido el título de la página, que se toma del primer encabezado. Úsalo para las páginas estáticas, legales o informativas que un sitio necesita junto a las conversacionales.

Ambos tipos viven en una dirección dentro de tu sitio, ambos se publican de la misma manera y ambos llevan la marca del sitio (logo, barra de navegación, pie de página, tema).

## Páginas de documento

Una página de documento es lo más simple de publicar: un nombre, una dirección y el markdown.

* **Sube un archivo `.md` o pega el markdown** en la consola al crear la página, y de nuevo cada vez que quieras editarla.
* **Se respetan los encabezados, listas, tablas, enlaces y énfasis** (GitHub-Flavored Markdown). El primer encabezado se convierte en el título de la pestaña del navegador.
* **Es totalmente indexable.** Una página de documento se renderiza en el servidor sin JavaScript, así que los buscadores leen el documento completo.
* **El HTML crudo dentro del markdown se ignora, no se renderiza.** El contenido se muestra de forma segura (un `<script>` o un atributo `onerror` nunca pasa a formar parte de la página), así que un documento es seguro de publicar en tu propio dominio.
* **Se escribe en el idioma fuente de la página, que queda fijado al crearla.** Una versión traducida es una subida aparte; las páginas de documento nunca se traducen automáticamente, porque la redacción de un documento legal es tuya.

<Note>
  Una página de documento cuenta contra el cupo de **páginas** de tu plan como cualquier otra página. Nunca gasta créditos de mensajes: no hay agente ni conversación en ella.
</Note>

## Enlazar a tus propias páginas

La barra de navegación y el pie de página de tu sitio (la **marca** del sitio) pueden enlazar a cualquiera de tus páginas por su **ruta**, sin escribir ningún dominio:

```
/privacy      → the page whose address is /privacy
/pricing      → the page whose address is /pricing
```

Una ruta que empieza con `/` enlaza una página de *este* sitio, así que el mismo enlace funciona en tu subdominio `*.wondeya.app` **y** en tu dominio propio. Nunca escribes el host a mano. Servir en un dominio propio todavía no está disponible; hasta que lo esté, tu sitio responde en su subdominio de `wondeya.app`. Cuando editas un enlace de la barra de navegación o del pie de página, la consola te sugiere las rutas de las páginas de tu sitio; también puedes escribir una URL completa `https://…` para un destino fuera de tu sitio.

## Anatomía

| Parte | Qué decide |
| - | - |
| **Nombre** | Cómo la llamas en la consola. |
| **Dirección** (ruta) | Dónde responde bajo el host de tu sitio. |
| **Estado** | `draft` o `published`. Solo `published` es visible para el público. |
| **Idioma fuente** | El idioma en que escribes esta página; debe ser uno de los que sirve tu sitio. Qué idiomas sirve el sitio (hoy español e inglés) es una configuración del sitio, compartida por todas las páginas. |
| **Identidad del agente** | Por quién habla el agente, cómo suena, qué acciones y enlaces puede ofrecer. |
| **Política de contenido** | Si su agente también usa el conocimiento y las imágenes de todo el espacio de trabajo. Los interruptores son del agente, así que aplican en cada página donde el agente responde. |
| **Tema** | El tema del sitio, compartido por todas las páginas del sitio. |
| **Textos de presentación** | El subtítulo, la descripción y las preguntas sugeridas que un visitante lee antes de escribir, compuestos desde el conocimiento del propio agente y compartidos por todas las páginas que usan el agente. |

## La dirección

Una página vive en una ruta bajo el host de su sitio:

```
https://your-site.wondeya.app           → the home page, whose path is /
https://your-site.wondeya.app/pricing   → the page whose path is /pricing
```

La parte del sitio en la dirección es la mitad globalmente única, y por eso dos sitios distintos, incluso dentro de un mismo espacio de trabajo, pueden tener cada uno su `/pricing`.

Reglas de la ruta:

* Hasta 4 tramos de 2 a 48 caracteres cada uno (`/pymes`, `/enterprise/latam`), 200 caracteres en total. Cada tramo son letras minúsculas y dígitos con guiones simples entre ellos.
* No distingue mayúsculas de minúsculas: `/Pricing` y `/pricing` son la misma dirección, guardada en minúsculas.
* Única dentro de su sitio.
* Tu primera página recibe `/` automáticamente si no escribes una ruta. Después de eso, una ruta que dejas en blanco se deriva del nombre y se deduplica automáticamente (`/pricing`, luego `/pricing-2`); una ruta que escribes se respeta tal cual.
* Reservadas por la plataforma, cada una junto con todo su subárbol (`/api/anything` también se rechaza): `admin`, `api`, `app`, `cdn`, `console`, `docs`, `embed`, `mail`, `status`, `storage`, `well-known`, `widget`, `www`, más los prefijos de idioma `es` y `en`, que direccionan las variantes traducidas.

<Warning>
  Cambiar una ruta mueve la dirección pública de inmediato y no hay redirección desde la anterior. Los enlaces ya compartidos, y todo lo que un buscador haya indexado, dejarán de resolver.
</Warning>

## Borrador y publicada

Una página nace como **borrador**, y publicar es un acto separado y deliberado (su propio control en la consola, su propio endpoint en la API), nunca un campo en un formulario de configuración. Publicar pone a un agente frente a desconocidos hablando en tu nombre, y eso no debería quedar al alcance de una clave perdida en una solicitud de renombrado.

Mientras una página es un borrador:

* toda dirección pública responde 404, el mismo 404 que recibirías con una página que no existe;
* no responde a nadie en una conversación en su dirección (el [widget](/docs/es/widget) es aparte: una site key incrusta al **agente**, no a la página, y no depende de este estado);
* puedes seguir trabajando en ella, y conversar con ella en la **Vista previa** de la consola.

Publicar requiere un correo electrónico verificado; todo lo demás (crear, editar, previsualizar) funciona antes del clic de verificación.

Publicar también registra el host de tu sitio, y el host sirve la **página principal: la página cuya ruta es `/`**. Tu primera página recibe esa ruta automáticamente, y una página en cualquier otra ruta no puede publicarse hasta que algo esté publicado en `/` (la solicitud se rechaza con un 409, código `wondeya.page.root_required`). Por la misma razón, mientras otras páginas del sitio estén publicadas, la página principal no puede pasarse a borrador, moverse fuera de `/` ni borrarse: pasa primero las demás a borrador, o mueve `/` a una de ellas. Pasar a borrador surte efecto en la siguiente solicitud, y pasar a borrador la última página publicada deja el sitio fuera de línea.

Una página conserva la fecha en que se publicó por primera vez incluso después de pasarla a borrador: es un registro histórico. Lo que decide si algo se sirve es el estado, nunca esa fecha.

## Lo que un desconocido lee primero

Una página conversacional que es solo un cuadro de texto no tiene nada que mostrarle a alguien que todavía no escribe, y nada que un buscador pueda leer. Por eso todo agente lleva **textos de presentación**: un subtítulo, una descripción corta y un puñado de preguntas sugeridas, todos escritos desde el conocimiento aprobado de ese agente.

Este copy es del **agente**, no de la página. Se compone una vez y lo reúsan todas las páginas donde el agente responde y cada lugar donde su widget está incrustado: el mismo cerebro dice lo mismo en todas partes, y nunca se compone dos veces en dos versiones distintas. Es parte de lo que un visitante recibe antes de que corra cualquier JavaScript, y es lo que los buscadores indexan.

**Se escribe para ti, no lo escribes tú.** wondeya lo compone:

* cuando tu **conocimiento cambia de verdad**: un documento agregado, re-rastreado o eliminado. Volver a subir el mismo archivo no cambia nada, así que no se reescribe nada;
* cuando cambias **por quién habla el agente**;
* cuando **publicas** una página que usa el agente.

Componerlo toma unos segundos y nunca ocurre mientras un visitante carga la página: el copy se escribe en segundo plano y se guarda, así que las páginas siempre se sirven al instante.

<Note>
  **El titular de una página es suyo.** El subtítulo, la descripción y las preguntas sugeridas vienen del agente; el titular sobre el chat es el editorial de la página, que escribe su dueño. No hay una "portada" por página ni nada que reescribir a mano.
</Note>

**Si todavía no hay conocimiento suficiente**, el copy se degrada con honestidad: sin subtítulo inventado y sin preguntas inventadas. No se fabrica nada para llenar la página. Agrega conocimiento y se completa.

## Búsqueda y redes sociales

Lo que muestra un resultado de búsqueda o una tarjeta social son los metadatos SEO de la página: un `<title>` y una meta descripción por idioma, distintos del titular en la página, más una imagen social opcional. Un campo que dejas vacío recurre al contenido de la propia página y luego a los valores de tu página principal, resueltos en vivo. [SEO](/docs/es/seo) cubre los textos, los límites, la herencia y la imagen social.

## Por quién habla el agente

La identidad del agente es lo que convierte a un asistente genérico en el asistente de *este negocio*. Tiene cinco partes, y cualquiera de ellas puede estar vacía:

| Campo | Qué hace |
| - | - |
| `businessName` | El negocio por el que habla el agente. |
| `description` | Un párrafo sobre qué hace el negocio. Se renderiza en cada prompt. |
| `tone` | Cómo debería sonar. |
| `actions` | Hasta 8 CTA que el agente puede ofrecer, cada uno un id más una descripción en inglés de cuándo es el siguiente paso correcto. |
| `links` | Hasta 16 destinos aprobados, cada uno un id, una URL real, etiquetas en ambos idiomas y una descripción en inglés. |

**Vacío es un significado, no un hueco.** Un agente sin descripción nunca describe el negocio; sin acciones no ofrece ningún CTA; sin enlaces no apunta a ningún lado. No hay un valor predeterminado de la plataforma y nunca debe haberlo: una identidad predeterminada es la forma en que la página de una empresa termina describiendo el producto de otra.

Las listas `actions` y `links` son también la razón por la que un CTA es seguro. El agente emite un id, nunca un destino; el servidor cambia el id por la URL que registraste, después de que el componente fue validado.

## Material del agente o material del espacio de trabajo

El conocimiento y las imágenes pertenecen a un agente o a todo el espacio de trabajo, y cada **agente** tiene dos interruptores, ambos encendidos por defecto: si también responde desde el conocimiento del espacio de trabajo, y si también puede usar las imágenes del espacio de trabajo. Como varias páginas pueden compartir un agente, cambiar un interruptor cambia todas las páginas donde el agente responde y todos los embeds, nunca una sola página.

Esto es lo que necesita un espacio de trabajo con dos productos sin relación. Dale a cada producto su propio agente y apaga el conocimiento del espacio de trabajo en ambos, y ninguno puede responder en nombre del otro, no porque al modelo se le pidió amablemente, sino porque el material nunca llega al turno.

## Tema

El tema es del sitio, y todas las páginas del sitio lo llevan; no hay excepciones por página. Edítalo en la pestaña **Marca** del sitio y todas las páginas cambian juntas. [Tema](/docs/es/theme) describe los tokens en sí.

## Borrar

Borrar una página es real (no queda una lápida que siga respondiendo), y elimina solo lo que pertenece a la página: la página en sí, su dirección pública y su propia imagen social subida. La dirección se retira primero, así que la página deja de resolver antes de que cambie cualquier otra cosa.

El conocimiento y las imágenes son del **agente** y sobreviven, y siguen respondiendo en las otras páginas del agente y en cada embed. Las site keys de su widget sobreviven por la misma razón: son del agente, no de la página, así que un embed sigue respondiendo después de que la página ya no está. Eliminar un corpus significa borrar el agente, lo que se rechaza mientras alguna página todavía apunte a él.

Borrar la página principal publicada mientras otras páginas del sitio están publicadas se rechaza: se sirven bajo el mismo host y dejarían de resolver con ella.

## Quién puede hacer qué

| Acción | Propietario | Administrador | Miembro |
| - | - | - | - |
| Ver páginas | ✅ | ✅ | ✅ |
| Crear, renombrar, cambiar la dirección | ✅ | ✅ | ❌ |
| Publicar y pasar a borrador | ✅ | ✅ | ❌ |
| Borrar | ✅ | ✅ | ❌ |

Una página es la cara pública de un negocio, así que publicar no es una acción de nivel miembro. Cada llamada se autoriza en el servidor sin importar lo que una pantalla decida mostrar.

## Qué cubre la consola hoy

La pantalla **Páginas** de la consola cubre la mayor parte de la vida de una página: crear ambos tipos (con subida o pegado de markdown), la configuración (nombre, dirección, agente), el editorial, los textos SEO y la imagen social, el markdown de un documento, publicar, pasar a borrador y borrar. La identidad del agente (nombre del negocio, descripción, tono, acciones, enlaces) se edita en la pantalla del propio agente.

<Note>
  Dos palancas hoy son solo por API: los interruptores de política de contenido del agente y las señales de sitemap por página (prioridad, frecuencia de cambio, exclusión). La [referencia de la API](/docs/es/api-reference/introduction) documenta los payloads exactos.
</Note>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.