# Inserción de respuestas

Usa menciones @ para referenciar respuestas en cualquier parte de tu formulario.

## Inserción de respuestas

Escribe @ para referenciar la respuesta de cualquier campo — en títulos de preguntas, bloques de contenido, páginas de agradecimiento, notificaciones por correo y mensajes de integración. Los valores se actualizan dinámicamente para que cada encuestado vea contenido personalizado.

<h2 id="how-it-works">Cómo funciona</h2>

<p>
  Escribe <strong>@</strong> en cualquier texto que lo admita (ver más abajo). Aparece un menú de menciones con los campos de tu formulario
  agrupados por tipo: <strong>Campos ocultos</strong>, <strong>Respuestas</strong>, <strong>Grupos repetibles</strong>,{' '}
  <strong>Campos calculados</strong> y <strong>Metadatos</strong>. Selecciona un campo y Formstep inserta un chip de variable en la posición
  del cursor.
</p>

<p>
  En el editor, los valores insertados aparecen como un chip (p. ej. <strong>@First name</strong>). Cuando un encuestado rellena el
  formulario, Formstep reemplaza cada chip con su respuesta real.
</p>

<p>
  Para escribir un <strong>@</strong> normal en su lugar — una dirección de correo o un nombre de usuario — pulsa <kbd>Esc</kbd> para cerrar
  el menú y sigue escribiendo. El menú también se cierra por sí solo cuando nada coincide con lo que escribiste después del{' '}
  <strong>@</strong>.
</p>

<h2 id="where-it-works">Dónde funciona la inserción</h2>

<ul>
  <li>Títulos de preguntas — una pregunta nunca ofrece su propia respuesta, porque sería circular</li>
  <li>Bloques de contenido: párrafos, encabezados, elementos de lista, celdas de tabla, enlaces y pies de imagen</li>
  <li>Contenido de la página de agradecimiento</li>
  <li>Traducciones de cualquiera de las anteriores, cuando la mención se traslada a cada idioma</li>
  <li>
    Asuntos y cuerpos de las notificaciones por correo: autonotificación, confirmación al encuestado y correos de recordatorio de formulario
    abandonado, además de la invitación de la solicitud
  </li>
  <li>
    Plantillas de integración: mensajes de <a href="/es/integrations/slack">Slack</a> y <a href="/es/integrations/discord">Discord</a>,
    títulos y descripciones de incidencias de <a href="/es/integrations/github">GitHub</a> y <a href="/es/integrations/linear">Linear</a>, y
    asignaciones de campos de <a href="/es/integrations/notion">Notion</a> y <a href="/es/integrations/airtable">Airtable</a>
  </li>
</ul>

<p>
  Las etiquetas de las opciones de elección y de las filas y columnas de una matriz también admiten menciones, pero con un menú más
  reducido: solo Campos ocultos, Campos calculados y Metadatos — los valores que existen antes de que nadie responda. La etiqueta de una
  opción es como se lee en el resumen, en las exportaciones y en el selector de lógica, así que no puede depender de otra respuesta.
</p>

<p>
  Las etiquetas de los botones y los títulos de los grupos repetibles no admiten menciones. Dos funciones relacionadas funcionan de forma
  diferente: <a href="/es/building-forms/redirect-after-submit#query-parameters">los parámetros de consulta de redirección</a> eligen un
  campo de una lista desplegable para cada parámetro, y <a href="#input-defaults">los valores predeterminados de campo</a> colocan un valor
  dentro de un campo en lugar de en texto.
</p>

<h2 id="input-defaults">Prellenar un campo editable</h2>

<p>
  Una mención muestra un valor como texto que el encuestado no puede cambiar. Para poner un valor <em>dentro</em> de un campo y que el
  encuestado pueda confirmarlo o editarlo, usa en su lugar una referencia de campo como valor predeterminado del campo: escribe <kbd>@</kbd>{' '}
  como primer carácter de un campo Text Input, Text Area, Email, Phone Number, Website URL o Number. Ese menú solo lista{' '}
  <strong>Campos ocultos</strong> y <strong>Campos calculados</strong>, porque esos tienen un valor antes de que el encuestado empiece a
  responder. Consulta <a href="/es/building-forms/field-configuration#default-values">Valores predeterminados de otros campos</a>.
</p>

<p>
  Esa es la técnica para un <strong>enlace de compartir</strong>, donde un valor solo puede llegar mediante un parámetro de URL y por eso
  necesita un campo oculto en el que aterrizar. En una <a href="/es/requests/overview">solicitud</a> no necesitas nada de esto: el llamante
  precompleta una pregunta visible directamente al crear la solicitud, usando <code>prefill</code>, y puede marcar una clave como{' '}
  <code>readonly</code> para que el destinatario la vea pero no pueda cambiarla. Crea un campo oculto cuando quieras transportar datos que
  el encuestado nunca debería ver, no solo para precompletar una respuesta. Consulta{' '}
  <a href="/es/building-forms/hidden-fields#requests-prefill-directly">Las solicitudes no necesitan un campo oculto para precompletar</a>.
</p>

<h2 id="field-types">Qué puedes insertar</h2>

<p>En el texto del contenido, el menú @ muestra cinco grupos, en este orden:</p>

<p>
  Un campo al que apunta un chip pero que ya no existe muestra la información sobre herramientas "Referenced field was deleted" y se
  renderiza vacío al rellenar el formulario. Si eliminas un campo oculto o calculado y añades otro con el mismo nombre, los chips existentes
  se reconectan a él por sí solos. Las referencias a preguntas nunca se reconectan así — los títulos cambian y pueden coincidir con otro,
  así que permanecen rotas hasta que las vuelves a insertar.
</p>

<h2 id="metadata-variables">Variables de metadatos</h2>

<p>
  Además de las respuestas a los campos, el grupo <strong>Metadatos</strong> incluye valores en tiempo de ejecución. Algunos están
  disponibles en todas partes; otros solo en las plantillas de correo. El nombre de abajo es lo que muestra el chip.
</p>

<h3 id="metadata-form-and-email">Disponibles tanto en el contenido del formulario como en las plantillas de correo</h3>

<h3 id="metadata-form-only">Solo en el contenido del formulario</h3>

<h3 id="metadata-email-only">Solo en plantillas de correo</h3>

> 💡 **PINs como números de referencia**
> <p>
>     Inserta un <strong>6 Digit PIN</strong> en el correo de confirmación al encuestado como número de referencia. Los encuestados pueden
>     citarlo en conversaciones posteriores, y tú puedes buscarlo en la tabla de respuestas.
>   </p>

<h2 id="examples">Ejemplos</h2>

<ul>
  <li>
    <strong>Pregunta personalizada</strong> — "¡Gracias @First name! ¿Cómo valorarías tu experiencia con @Company?"
  </li>
  <li>
    <strong>Agradecimiento dinámico</strong> — "Tu total es @Price. Enviaremos una confirmación a @Email en un plazo de 24 horas."
  </li>
  <li>
    <strong>Correo condicional</strong> — "Hola @First name, tu puntuación de lead es @Lead score. Nuestro equipo se pondrá en contacto
    contigo."
  </li>
  <li>
    <strong>Redirección con contexto</strong> — en la configuración de redirección, añade un parámetro <code>name</code> asignado a la
    pregunta Name y un parámetro <code>plan</code> asignado a Plan. La vista previa muestra la URL a la que se envían los encuestados:
  </li>
</ul>

```
https://yoursite.com/confirm?name={Name}&plan={Plan}
```

<h2 id="referencing-repeating-groups">Referenciar grupos repetibles</h2>

<p>
  <a href="/es/building-forms/repeating-groups">Los grupos repetibles</a> permiten a los encuestados añadir tantas entradas como necesiten,
  así que una sola referencia puede traer más de un valor. Cómo se resuelve la mención @ depende de a qué apuntes.
</p>

<ul>
  <li>
    <strong>Un solo campo miembro</strong> — Formstep une los valores de ese campo en todas las entradas con <strong> · </strong>. Mencionar
    el campo Name de tres invitados muestra "Jane Appleseed · Marcus Lee · Priya Patel".
  </li>
  <li>
    <strong>El grupo completo</strong> — cada entrada aparece en línea. Los valores de los campos miembro dentro de una entrada se unen con{' '}
    <strong> · </strong>, y las entradas se separan con comas. Un grupo con Name y Age muestra "Jane Appleseed · 34, Marcus Lee · 29".
  </li>
</ul>

<p>
  En una columna de integración, el grupo completo aparece como filas numeradas y etiquetadas en su lugar, para que cada entrada siga siendo
  legible: "1. Full name: Jane Appleseed, Age: 34, 2. Full name: Marcus Lee, Age: 29".
</p>

<h2 id="deleting-piped-fields">Eliminar un campo insertado</h2>

<p>
  Una mención que queda apuntando a un campo eliminado es un <em>error</em> de publicación, no una advertencia: el indicador de incidencias
  en la barra de herramientas marca cada referencia obsoleta — en el contenido del formulario, las plantillas de correo,{' '}
  <a href="/es/building-forms/translating-form-content#field-reference-checks">los correos traducidos</a> y las plantillas de mensajes de
  integración — y la publicación se detiene hasta que se corrija cada una. Abre la ubicación marcada, elimina el chip roto y vuelve a
  insertar el campo correcto.
</p>

<h2 id="next-steps">Próximos pasos</h2>
<div class="not-prose grid gap-3 sm:grid-cols-2">
  - [Página de agradecimiento personalizada](/es/building-forms/custom-thank-you) — Inserta respuestas en la pantalla posterior al envío
  - [Configuración del formulario](/es/building-forms/form-settings) — Configura plantillas de notificación con variables insertadas
  - [Autonotificaciones](/es/submissions-analytics/self-notifications) — Usa la inserción en correos de alerta del equipo
  - [Notificaciones al encuestado](/es/submissions-analytics/respondent-notifications) — Personaliza los correos de confirmación con inserción de respuestas
  - [Grupos repetibles](/es/building-forms/repeating-groups) — Permite a los encuestados añadir varias entradas a un grupo
</div>
