# Linear

Abre un issue de Linear desde cada envío.

## Linear

Convierte envíos en issues de Linear automáticamente. Cada envío crea un issue en el equipo que elijas, con un título, descripción y proyecto personalizados.

<h2 id="what-you-get">Qué obtienes</h2>

<ul>
  <li>Un issue de Linear por envío, atribuido al usuario que realizó la conexión</li>
  <li>
    Título y descripción generados desde un editor de plantillas — escribe <strong>@</strong> para insertar el valor de cualquier campo del
    formulario
  </li>
  <li>La descripción admite markdown (negrita, listas, encabezados, bloques de código, citas y enlaces)</li>
  <li>Proyecto predeterminado opcional aplicado a todos los issues</li>
  <li>Relleno retroactivo de envíos existentes a demanda (~1 issue por segundo)</li>
  <li>
    Botón de prueba que crea un issue real con el prefijo <code>[Test]</code> para que puedas verificar antes de activarlo
  </li>
</ul>

<h2 id="connect">Conectar Linear</h2>

<h2 id="backfill">Relleno retroactivo de envíos existentes</h2>

<p>
  Al conectar por primera vez, puedes exportar los envíos existentes como issues de Linear. El relleno retroactivo se ejecuta en segundo
  plano a ~1 issue por segundo para respetar los límites de velocidad de Linear. El progreso se registra cada 10 envíos.
</p>

<h2 id="abandoned-responses">Eventos de respuesta abandonada</h2>

<p>
  Cuando alguien empieza tu formulario pero no lo termina, Formstep puede crear un issue aparte con los datos parciales. Ajusta{' '}
  <strong>Enviar evento abandonado después de</strong> a 12 horas, 1 día, 3 días o 1 semana, y luego completa el título y la descripción del
  issue de abandono — ninguno puede quedar vacío. Los issues de abandono reciben la etiqueta <code>partial-submission</code>.
</p>

<p>
  Una revisión cada hora busca borradores inactivos, así que el issue aparece en la primera revisión después de que pase la ventana. Solo se
  revisan los borradores de un enlace de compartir, y <strong>Campos requeridos</strong> lo acota más: el issue solo se crea cuando se ha
  rellenado al menos uno de los campos que elijas.
</p>

> ℹ️ **Función Pro**
> <p>
>     La entrega de respuestas abandonadas requiere un plan Pro o Business. La integración principal con Linear está disponible en todos los
>     planes. Consulta <a href="/es/subscription-billing/plans-pricing">planes y precios</a>.
>   </p>

<h2 id="token-refresh">Actualización del token</h2>

<p>
  Los tokens de acceso de Linear se actualizan automáticamente antes de cada envío cuando están próximos a caducar. Si la actualización
  falla (token revocado, app desinstalada), Formstep marca la integración como errónea y recibes un correo de notificación de fallo. Vuelve
  a conectar desde la página de Integraciones del espacio de trabajo para restaurarla.
</p>

<h2 id="removing">Eliminar la integración</h2>

<ul>
  <li>
    <strong>Desde Formstep</strong> — Configuración del formulario → Integraciones → Linear → Eliminar. Los nuevos envíos dejan de crear
    issues de inmediato.
  </li>
  <li>
    <strong>Desde Linear</strong> — Revoca el acceso OAuth desde la configuración de tu usuario. El siguiente envío fallará y la credencial
    quedará marcada como caducada.
  </li>
</ul>

<h2 id="limits">Límites y comportamiento</h2>

<ul>
  <li>Un issue por envío — no hay modo de comentar en issues existentes</li>
  <li>El título es texto plano, truncado con puntos suspensivos a partir de 255 caracteres; la descripción es solo markdown</li>
  <li>
    Si el título queda vacío, se usa <code>New submission to &lt;form name&gt;</code>
  </li>
  <li>
    Las respuestas de carga de archivos se muestran como el nombre del archivo seguido de su enlace de descarga, de manera que el archivo es
    accesible desde el issue
  </li>
  <li>
    Un campo de <a href="/es/building-forms/repeating-groups">grupo repetible</a> insertado con @ muestra todas las entradas unidas por " ·
    "
  </li>
</ul>

<h2 id="faq">Preguntas frecuentes</h2>

  <p>
    Tres permisos OAuth de Linear: <code>read</code> (listar equipos, proyectos y etiquetas),
    <code>write</code> (actualizar metadatos de issues) y <code>issues:create</code> (crear issues). La conexión usa <code>actor=user</code>
    siempre, por lo que los issues se atribuyen a ti, no a un bot.
  </p>

  <p>
    Sí. Abre el panel de detalles de la integración y cambia cualquiera de los dos campos. Cambiar de equipo restablece el proyecto, ya que
    los proyectos son específicos de cada equipo.
  </p>

  <p>Sí. Autoriza diferentes cuentas de Linear para añadir múltiples credenciales. Cada integración de formulario elige cuál usar.</p>

  <p>
    Sí. Las conexiones de Linear tienen alcance de espacio de trabajo. Cualquier miembro del espacio de trabajo puede usar cualquier cuenta
    de Linear conectada al configurar una integración.
  </p>

  <p>
    La integración se pausa automáticamente y se envía un correo a la persona que la configuró. Un token revocado, un permiso perdido o un
    equipo eliminado no esperan a los cinco fallos — detienen la integración de inmediato. En cualquier caso, soluciona la causa y pulsa
    Reanudar.
  </p>

<h2 id="next-steps">Próximos pasos</h2>
<div class="not-prose grid gap-3 sm:grid-cols-2">
  - [GitHub Issues](/es/integrations/github) — Convierte envíos en issues de GitHub
  - [Salud y monitoreo](/es/integrations/health-monitoring) — Rastrea errores de integración y el estado de actualización de tokens
</div>