> 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/dapta-forms/key-concepts.md).

# Conceptos clave

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

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 y paso

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**, cada pregunta es un **paso**: una pantalla por la que avanza quien responde. Por eso el estilo de progreso **Contador** dice **Paso 2 de 3** y por eso las analíticas hablan de «abandono pregunta por pregunta». Cada pregunta tiene además una **clave de 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-a446c2b90ed9a229a0bd5b8f7831f39b553d277d%2Fforms-key-concepts-02-layout.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 pregunta por pantalla. Quien responde pulsa **Siguiente** (o **Enter**) para avanzar, las respuestas de opción única avanzan solas, y una flecha de **Atrás** vuelve al paso 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-a446c2b90ed9a229a0bd5b8f7831f39b553d277d%2Fforms-key-concepts-02-layout.png?alt=media" alt="El panel Diseño con la sección Diseño mostrando las opciones Diapositivas y Una página y el interruptor de pantalla de revelación antes de los resultados"><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 y de texto 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 el formulario termina**).

## 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 después de la pregunta de correo** 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 filtro **Parcial** y se convierten en el sitio a **Completada** si la persona termina. Los webhooks también pueden dispararse con las respuestas parciales.

## 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, el diseño y las preguntas esperan a que pulses **Publicar**.

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 publicado tiene una URL con la forma `forms.dapta.ai/{código de cuenta}/{handle}/{slug del formulario}`, por ejemplo `forms.dapta.ai/k7m2xq/alex/lead-qualification-quiz`. El código de cuenta identifica tu workspace, el handle te identifica a ti, y el slug se genera a partir del nombre del formulario. Lo copias desde la barra superior del editor (**Copiar enlace**) o desde el ícono de copiar en la fila del formulario en la lista. Ese mismo enlace alimenta el fragmento para incrustar y la tarjeta al compartir que se genera sola.

## Qué sigue

* [Primeros pasos](/dapta-docs-es/dapta-forms/getting-started.md): entra y construye tu primer formulario.
* [Lógica, puntaje y resultados](/dapta-docs-es/dapta-forms/logic.md): condiciones, ramificaciones, puntos y resultados.
* [Respuestas parciales](/dapta-docs-es/dapta-forms/builder/partial-submissions.md): captura leads antes de la última pregunta.
* [Tu enlace público](/dapta-docs-es/dapta-forms/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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
