GitHub Issues

Qué obtienes

• Un GitHub issue por envío, atribuido al usuario que realizó la conexión

• Título y cuerpo construidos desde un editor de plantillas — escribe @ para insertar el valor de cualquier campo del formulario

• El cuerpo admite markdown estilo GitHub (negrita, listas, encabezados, bloques de código, enlaces)
• Hito predeterminado opcional aplicado a cada issue

• Botón de prueba que crea un issue real con prefijo [Test] para que puedas verificar antes de publicar

Conectar GitHub

1. 1

   Abre Configuración del formulario → Integraciones → GitHub Issues

   Pulsa Conectar cuenta de GitHub, o elige una cuenta que el espacio de trabajo ya haya conectado. Una ventana emergente te guía por el consentimiento OAuth. Permisos solicitados: repo, read:user, read:org.

2. 2

   Selecciona un repositorio

   El selector muestra los repositorios donde tienes acceso de escritura. formbase excluye los repositorios archivados y desactivados.

3. 3

   Establece los valores predeterminados (opcional)

   Elige un hito predeterminado. Se aplica a cada issue y se restablece cuando cambias de repositorio.

4. 4

   Redacta el título y el cuerpo

   Usa los editores de plantillas. Escribe @ para insertar valores de campos del formulario. El título se renderiza como texto plano (máx. 256 caracteres); el cuerpo se renderiza como markdown estilo GitHub.

5. 5

   Envíos abandonados (opcional)

   Elige una ventana de inactividad y redacta un título y cuerpo 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 repositorio elegido — ciérralo o elimínalo después. Luego pulsa Crear integración y cada envío crea un issue de GitHub.

Eventos de respuestas abandonadas

Cuando un respondente 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 el cuerpo del issue de abandono — ninguno puede quedar vacío. Los issues de abandono reciben la etiqueta partial-submission, creada la primera vez que se usa.

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.

Tokens

Los tokens de OAuth App de GitHub no caducan — no hay rotación de tokens de actualización. Si revocas el acceso desde la página de OAuth Apps autorizadas de tu cuenta de GitHub, el siguiente envío falla, formbase marca la credencial como expirada y recibes un correo de notificación de error. Vuelve a conectar desde la página de Integraciones del espacio de trabajo para restaurarlo.

Eliminar la integración

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

• Desde GitHub — Revoca el acceso OAuth desde la página de OAuth Apps autorizadas de tu cuenta. formbase no revoca automáticamente el token por su parte.

Límites y comportamiento

• Un issue por envío — no hay modo de comentar en un issue existente
• Sin retroactividad — solo los nuevos envíos crean issues
• El título es texto plano, truncado con puntos suspensivos a partir de 256 caracteres; el cuerpo 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

• Las respuestas se insertan en el cuerpo del issue tal cual — si una respuesta contiene @usuario, GitHub notifica a ese usuario, y #123 crea una referencia a un issue

Preguntas frecuentes

Siguientes pasos