formbasedocs
Ir a la appApp

Integraciones

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.


Qué obtienes

  • Un issue de Linear por envío, atribuido al usuario que realizó la conexión
  • Título y descripción generados desde un editor de plantillas — escribe @ para insertar el valor de cualquier campo del formulario

  • La descripción admite markdown (negrita, listas, encabezados, bloques de código, citas y enlaces)
  • Proyecto predeterminado opcional aplicado a todos los issues
  • Relleno retroactivo de envíos existentes a demanda (~1 issue por segundo)
  • Botón de prueba que crea un issue real con el prefijo [Test] para que puedas verificar antes de activarlo

Conectar Linear

  1. 1

    Abre Configuración del formulario → Integraciones → Linear

    Pulsa Conectar cuenta de Linear, o elige una cuenta que el espacio de trabajo ya haya conectado. Una ventana emergente te guía por el consentimiento OAuth. Permisos solicitados: read, write, issues:create.

  2. 2

    Elige un equipo

    Los issues irán al backlog de este equipo. Cada integración apunta a un equipo — añade otra integración para enrutar a un segundo equipo.

  3. 3

    Establece los valores predeterminados (opcional)

    Elige un proyecto. Se aplica a todos los issues y se reinicia cuando cambias de equipo.

  4. 4

    Redacta el título y la descripción

    Usa los editores de plantillas. Escribe @ para insertar valores de campos del formulario. El título se muestra como texto plano (máx. 255 caracteres); la descripción se renderiza como markdown.

  5. 5

    Envíos abandonados (opcional)

    Elige una ventana de inactividad y redacta un título y descripción aparte para los borradores que nadie terminó. Déjalo en Desactivado para omitirlo. Requiere Pro o Business.

  6. 6

    Finaliza

    Enviar prueba crea un issue real con el prefijo [Test] en el equipo elegido — archívalo o elimínalo después. Luego pulsa Crear integración y cada envío crea un issue de Linear.

Relleno retroactivo de envíos existentes

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.

Eventos de respuesta abandonada

Cuando alguien empieza tu formulario pero no lo termina, formbase puede crear un issue aparte con los datos parciales. Ajusta Enviar evento abandonado después de 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 partial-submission.

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 Campos requeridos lo acota más: el issue solo se crea cuando se ha rellenado al menos uno de los campos que elijas.

Función Pro

La entrega de respuestas abandonadas requiere un plan Pro o Business. La integración principal con Linear está disponible en todos los planes. Consulta planes y precios.

Actualización del token

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), formbase 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.

Eliminar la integración

  • Desde formbase — Configuración del formulario → Integraciones → Linear → Eliminar. Los nuevos envíos dejan de crear issues de inmediato.

  • Desde Linear — Revoca el acceso OAuth desde la configuración de tu usuario. El siguiente envío fallará y la credencial quedará marcada como caducada.

Límites y comportamiento

  • Un issue por envío — no hay modo de comentar en issues existentes
  • El título es texto plano, truncado con puntos suspensivos a partir de 255 caracteres; la descripción es solo markdown
  • Si el título queda vacío, se usa New submission to <form name>

  • 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

  • Un campo de grupo repetible insertado con @ muestra todas las entradas unidas por “ · “

Preguntas frecuentes

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

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.

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

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.

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.

Próximos pasos