> For the complete documentation index, see [llms.txt](https://docs.dapta.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dapta.ai/dapta-docs-es/dforms/key-concepts.md).

# Conceptos clave

El vocabulario que se usa en toda la documentación de dForms: formulario, pregunta, paso y pantalla, diseño Diapositivas frente a Una página, puntaje, resultado, respuesta parcial, workspace, borrador

Esta página define el puñado de palabras que usa el resto de la documentación. Léela una vez por encima y el editor, la pestaña **Lógica** y la pestaña **Conectar** tendrán mucho más sentido.

***

## Formulario

Un formulario es lo que construyes, publicas y compartes. Cada formulario tiene un nombre (que solo ves tú, en el editor y en la lista de formularios), un título público opcional (lo que ven los visitantes), un diseño, una lista de preguntas, ajustes de diseño, lógica, puntaje, integraciones y sus propias páginas de **Respuestas** y **Analíticas**.

Los formularios pertenecen a un workspace. Cualquier miembro del workspace puede abrir, editar, publicar y borrar los formularios que hay en él.

## Pregunta, paso y pantalla

Una **pregunta** es cada elemento de la lista de la izquierda del editor. La mayoría recoge una respuesta (Nombre, Correo, Opción única, Deslizador y demás). Algunas no: un **Mensaje** muestra texto sin ningún campo, una **Pantalla de revelación** hace una pausa breve y cronometrada, y un **Agendador** deja que la persona agende una reunión.

En el diseño **Diapositivas**, quien responde avanza por **pantallas**. Una pregunta sola es un **paso**: una pantalla. También puedes agrupar preguntas seguidas en la misma pantalla (hasta 10), para que se respondan juntas y avancen con un solo botón. Mira [Varias preguntas en una pantalla](/dapta-docs-es/dforms/builder/screens.md). El estilo de progreso **Contador** cuenta pantallas (**Paso 2 de 3**), mientras que las respuestas, las analíticas y el abandono pregunta por pregunta siguen contando cada pregunta por separado. Cada pregunta tiene además una **clave del campo** (por ejemplo `email`, `team_size`), que es el nombre estable que se usa en las respuestas, en los webhooks, en el mapeo de HubSpot y en los marcadores `[campo]`.

<figure><img src="https://365551146-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMUYDYzjmxpzlYaw0gcaZ%2Fuploads%2Fgit-blob-cdb386b0082ad8881ccbcab3090b23c4de19e1fa%2Fforms-quickstart-04-edit-question.png?alt=media" alt="El editor de formularios con la lista de preguntas a la izquierda, el lienzo en vivo en el centro y los ajustes de la pregunta a la derecha"><figcaption><p>El editor: las preguntas a la izquierda, el lienzo en vivo en el centro y los ajustes de la pregunta seleccionada a la derecha.</p></figcaption></figure>

## Diseño: Diapositivas frente a Una página

Eliges el diseño al crear el formulario y puedes cambiarlo después en **Diseño → Diseño**.

| Diseño           | Cómo se comporta                                                                                                                                                                                                                                                                                                                                                                                |
| ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Diapositivas** | Una pantalla a la vez: una pregunta, o varias preguntas agrupadas en la misma pantalla. Quien responde pulsa **Siguiente** (o **Enter**) para avanzar, una respuesta de opción única avanza sola cuando es la única pregunta de su pantalla, y una flecha de **Atrás** vuelve a la pantalla anterior. Están disponibles la portada, las pantallas de revelación y las transiciones entre pasos. |
| **Una página**   | Todas las preguntas en una sola página con un único botón **Enviar**. La lógica sigue aplicando en vivo: las preguntas aparecen y se ocultan según cambian las respuestas. La portada se muestra como un encabezado arriba, el progreso dice **0 de 3 respondidas**, y una pantalla de revelación opcional se reproduce una vez tras pulsar **Enviar**.                                         |

<figure><img src="https://365551146-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMUYDYzjmxpzlYaw0gcaZ%2Fuploads%2Fgit-blob-56f9e4b50ee2f106256579133d2f65deaadd7ebc%2Fforms-key-concepts-02-layout.png?alt=media" alt="El panel Diseño con la sección Diseño mostrando las tarjetas Diapositivas y Una página con sus descripciones, y el interruptor de pantalla de revelación antes del resultado"><figcaption><p>Cambia de diseño cuando quieras desde el panel <strong>Diseño</strong>. La vista previa de la derecha se actualiza al instante.</p></figcaption></figure>

## Puntaje

Las opciones de las preguntas de elección y los rangos de las preguntas de deslizador pueden llevar **Puntos**. Cuando el puntaje está activado (Lógica → **Puntaje**), los puntos de cada opción elegida se suman en un solo número por respuesta: el puntaje. Las preguntas de contacto, de texto y de subir archivo nunca afectan al puntaje. El puntaje se guarda con la respuesta, se muestra en la tabla de **Respuestas**, se envía a los webhooks y a HubSpot, y puede alimentar la lógica («Puntaje hasta ahora») y los resultados.

## Resultado

Un resultado es un rango de puntaje asociado a lo que ve quien responde al final: una etiqueta (por ejemplo «Encajas perfecto»), un mensaje de agradecimiento, una redirección opcional y un retraso antes de ella. Los gestionas en Lógica → **Resultados**. Gana el primer rango que coincide, y el rango más alto no tiene límite superior, así que ningún puntaje se queda sin resultado. Los puntajes que caen en un hueco ven el final propio del formulario (Diseño → **Cuando termina el formulario**).

## Respuesta parcial

Por defecto las respuestas se guardan cuando quien responde llega al final. Si colocas el marcador **Punto de envío parcial** en la lista de preguntas (el editor sugiere **Capturar tras la pregunta de email** en cuanto tu formulario pide un correo), las respuestas se guardan en el momento en que la persona pasa ese punto, aunque cierre la pestaña después. Esas filas aparecen en **Respuestas** con el estado **Parcial** (fíltralas desde la columna **Estado**) y se convierten en el sitio a **Completada** si la persona termina. Los webhooks y HubSpot también pueden recibir las respuestas parciales, salvo que la [protección contra spam](/dapta-docs-es/dforms/connect/spam-protection.md) esté activa: entonces las parciales se guardan, pero solo se entrega la respuesta completa y verificada.

## Workspace

Un workspace es un espacio aparte con sus propios formularios, miembros, kit de marca, correos de aviso e integraciones. Los workspaces de Forms son los mismos que ves en la app de Dapta: mismo nombre, mismos miembros, mismos roles (owner, admin, member). El selector de workspace que está arriba del menú de la izquierda te mueve entre ellos; el activo es sobre el que actúa cada página.

## Borrador frente a publicado

Cada cambio que haces en el editor se guarda solo como **borrador**. El estado junto al nombre del formulario dice **Guardando…** y luego **Guardado**, pero todavía no hay nada en vivo. Al hacer clic en **Publicar**, el borrador actual pasa a ser la versión en vivo que sirve el enlace público. Hasta que vuelvas a publicar, las ediciones nuevas se quedan en privado y aparece la insignia **Cambios sin publicar** junto a **Publicar**.

> **⚠️ Nota:** Las integraciones de la pestaña **Conectar** (HubSpot, webhook, correos) se guardan en el formulario en vivo de inmediato, sin publicar. Los IDs de seguimiento, la protección contra spam, el diseño y las preguntas esperan a que pulses **Publicar**.

Si otra persona guarda el mismo formulario mientras lo editas, el editor deja de guardar y te pregunta con qué versión quedarte. Mira [Guardado automático, borradores y publicación](/dapta-docs-es/dforms/builder/autosave-and-publishing.md).

No hay botón para despublicar. Para sacar un formulario de circulación, bórralo desde la lista de formularios (eso borra también sus respuestas).

## Enlace público

Cada formulario tiene una URL pública con la forma `app.dforms.ai/{código de cuenta}/f/{slug del formulario}`, por ejemplo `app.dforms.ai/acme/f/lead-qualification-quiz`. El código de cuenta identifica tu workspace. La `f` del medio es siempre la misma, así que el enlace nunca nombra a la persona que construyó o compartió el formulario. El slug se genera a partir del nombre del formulario cuando lo creas; si luego renombras el formulario, el slug no cambia.

Para cambiar el slug, haz clic en **Editar enlace**, junto a **Copiar enlace** en la barra superior del editor. El cambio se aplica al instante, y los enlaces que ya compartiste siguen funcionando: llevan a los visitantes a la dirección nueva. Los enlaces antiguos que llevan el nombre de un miembro en el medio (por ejemplo `app.dforms.ai/acme/alex/lead-qualification-quiz`) también siguen funcionando.

Copias el enlace desde la barra superior del editor (**Copiar enlace**, o **Código QR** para una versión escaneable) o desde el ícono de copiar en la fila del formulario en la lista. Ese mismo enlace alimenta el fragmento para insertar el formulario y la tarjeta al compartir que se genera sola.

## Qué sigue

* [Primeros pasos](/dapta-docs-es/dforms/getting-started.md): entra y construye tu primer formulario.
* [Varias preguntas en una pantalla](/dapta-docs-es/dforms/builder/screens.md): agrupa preguntas en una pantalla de Diapositivas.
* [Lógica, puntaje y resultados](/dapta-docs-es/dforms/logic.md): condiciones, ramificaciones, puntos y resultados.
* [Respuestas parciales](/dapta-docs-es/dforms/builder/partial-submissions.md): captura leads antes de la última pregunta.
* [Tu enlace público](/dapta-docs-es/dforms/share/public-link.md): de qué está hecha la URL y cómo compartirla.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.dapta.ai/dapta-docs-es/dforms/key-concepts.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
