Saltar al contenido principal

​
Acerca del conector de GitHub

El conector de GitHub permite que tu app de Base44 acceda de forma segura a los datos de GitHub usando OAuth. Úsalo para crear dashboards de pull requests e issues, automatizar la creación de issues, generar notas de versión y sincronizar la actividad del repositorio en tu app. La conexión de GitHub se comparte a nivel de app. Cuando conectas GitHub, autorizas una cuenta de GitHub para esa app. Todos los que pueden editar la app usan la misma conexión de GitHub y ven los mismos datos potenciados por GitHub dentro de la app.
Basegithubconnector
Importante: Los conectores son conexiones compartidas a nivel de app. No uses el conector de GitHub si cada persona que usa tu app necesita conectar su propia cuenta de GitHub. Para inicio de sesión de GitHub por persona, crea un flujo OAuth personalizado con funciones de backend.
Antes de empezar: Necesitas un plan Builder o superior para usar conectores en tu app.

​
Casos de uso y prompts de GitHub

Usa el conector de GitHub para hacer seguimiento del trabajo de ingeniería, mantener informados a los stakeholders y conectar los flujos de código con el resto de tus herramientas.
Crea dashboards que listen pull requests, muestren su estado y revelen lo que necesita revisión. También puedes crear vistas para commits recientes, colaboradores y actividad del repositorio.Prompts de ejemplo:
Conecta GitHub y muestra todos los pull requests abiertos en mis repositorios que esperan revisión.

Crea un dashboard para un repositorio que muestre pull requests abiertos, comprobaciones de estado, revisores y hora de la última actualización.

Crea una página que muestre los últimos commits de este repositorio con autor, mensaje y marca de tiempo.

Añade un widget que destaque los pull requests marcados como "changes requested" y aún abiertos.

Muestra una lista de pull requests fusionados en los últimos 7 días, agrupados por repositorio.
Convierte los issues de GitHub en colas estructuradas dentro de tu app. Sigue prioridades, asignados, etiquetas e issues antiguos, y mantén una vista clara de lo que está bloqueado o atrasado.Prompts de ejemplo:
Muestra los issues abiertos de mi repositorio en una tabla con etiquetas, asignado, prioridad y fecha de creación.

Crea una página que liste los issues etiquetados como "bug" y "p0" y ordénalos del más antiguo primero.

Crea un informe semanal que resuma los nuevos issues creados esta semana y las etiquetas principales.

Añade una vista que muestre los issues que no se han actualizado en 14 días.

Crea un dashboard que cuente los issues abiertos por etiqueta y asignado.
Activa acciones de GitHub desde eventos en tu app, como crear un issue cuando se reporte un bug, o abrir un issue de seguimiento cuando se cree un incidente.Prompts de ejemplo:
Cuando se cree un nuevo reporte de bug en esta app, crea un issue de GitHub en el repo org/repo con el título y los pasos para reproducir.

Crea automáticamente un issue de GitHub cuando se cree un incidente crítico, incluyendo gravedad, propietario y enlace al incidente.

Cuando una solicitud de función se marque como Approved, abre un issue de GitHub con criterios de aceptación y etiqueta de prioridad.

Cuando un ticket de cliente se escale, crea un issue de GitHub y enlázalo al ticket.

Añade un botón que permita a un admin crear un issue de GitHub desde un registro en esta app.
Sincroniza los pull requests fusionados y los commits en un changelog, o genera notas de versión automáticamente desde la actividad de GitHub.Prompts de ejemplo:
Sincroniza los pull requests fusionados de org/repo en una página de changelog con título, autor y enlace.

Genera notas de versión para las últimas 2 semanas basadas en los pull requests fusionados, agrupados por etiqueta.

Crea un resumen semanal que recopile lo que se lanzó, incluyendo enlaces a pull requests e issues cerrados.

Muestra una lista de versiones y sus notas para este repositorio.

Crea una página "What's new" que se actualice cada viernes con los pull requests fusionados de esta semana.
Conecta GitHub a Slack, Gmail, BigQuery, Notion o CRMs para enviar actualizaciones de ingeniería a donde trabajan los equipos.Prompts de ejemplo:
Publica un mensaje en Slack cuando se fusione un pull request, incluyendo título, autor y enlace.

Envía un resumen semanal por Gmail con los pull requests fusionados e issues cerrados, agrupados por repositorio.

Cuando se cree un issue de GitHub etiquetado como "customer", añádelo a una base de datos de Notion y notifica a #support en Slack.

Refleja los issues etiquetados como "docs" en una tabla de backlog de documentación dentro de mi app.

Crea un dashboard que combine la actividad de despliegue de GitHub con métricas de rendimiento de BigQuery.
Al describir flujos de varias herramientas en el chat de IA, sé explícito sobre qué evento de GitHub debe activar la acción y qué detalles incluir (repo, número de issue/PR, título, etiquetas, enlace).

​
Conectar GitHub a tu app

Usa el chat de IA para conectarte a GitHub, o conéctate usando un prompt prediseñado desde el dashboard de tu app.

​
Usando el chat de IA

  1. Ve al editor de tu app.
  2. Describe lo que quieres hacer con GitHub en el chat de IA, por ejemplo:
    • Conecta a GitHub y muestra todos los pull requests abiertos para org/repo que esperan revisión.
    • Crea un issue de GitHub cuando se reporte un nuevo bug en esta app.
  3. Revisa Action required y Required permissions en el panel lateral.
  4. Haz clic en Connect to GitHub.
  5. En la ventana de GitHub que se abre:
    1. Inicia sesión en la cuenta de GitHub que quieras conectar.
    2. Revisa los permisos solicitados y haz clic en Authorize.
  6. Vuelve al editor y deja que la IA termine de crear las páginas, tablas y flujos potenciados por GitHub.
Connectinggithub

​
Desde el dashboard de la app

  1. Haz clic en Dashboard en el editor de tu app.
  2. Haz clic en Integrations.
  3. Haz clic en la pestaña Browse.
  4. Encuentra GitHub y haz clic en Use.
  5. Selecciona el prompt prediseñado que quieras añadir al chat de IA.
  6. En el chat de IA, revisa Action required y Required permissions.
  7. Haz clic en Connect to GitHub y completa el flujo de autorización.
  8. Vuelve al editor y deja que la IA termine de crear los flujos potenciados por GitHub.
Githubindashboard
Comienza con un flujo simple de solo lectura (como listar pull requests abiertos) para confirmar que la conexión funciona. Luego añade acciones de escritura como crear issues.
Si haces clic en Reject o cierras la ventana de autorización, el conector no se añade. Puedes ejecutar el flujo de conexión de nuevo desde el chat de IA o desde Integrations → Browse.

​
Gestionar tu conexión de GitHub

Puedes revisar y gestionar el conector de GitHub para cada app desde el dashboard de la app. Para gestionar tu conector de GitHub:
  1. Ve al dashboard de tu app.
  2. Haz clic en Integrations.
  3. Haz clic en la pestaña My integrations.
  4. Encuentra el conector de GitHub.
  5. Elige lo que quieras hacer:
    • View access: Ver qué permisos tiene actualmente GitHub en esta app.
    • More actions: Reconectar, cambiar, desconectar o eliminar la cuenta de GitHub conectada. Las acciones disponibles dependen del estado del conector.
Dashboard de la app que muestra las opciones del conector de GitHub en la pestaña My integrations

​
Reconectar GitHub

Reconecta GitHub si la cuenta conectada se desconecta, se revoca el acceso en GitHub o GitHub te pide que autorices el acceso de nuevo. Para reconectar GitHub:
  1. Ve al dashboard de tu app.
  2. Haz clic en Integrations.
  3. Haz clic en la pestaña My integrations.
  4. Encuentra el conector de GitHub.
  5. Haz clic en el icono More actions en el conector de GitHub y selecciona Reconnect.
  6. Revisa los permisos solicitados y aprueba el acceso.

​
Alcances y permisos de GitHub

Cuando conectas GitHub, el conector solicita permisos a través del flujo de autorización OAuth de GitHub. Los permisos exactos que ves dependen de lo que tu app intenta crear o ejecutar.

Permisos de GitHub

Siempre revisa los permisos que se muestran en la ventana de autorización de GitHub antes de aprobar el acceso.Ejemplos de permisos que puedes ver:
  • repo: Acceso completo a los repositorios a los que puede acceder la cuenta conectada.
  • read:user: Lee información básica del perfil de la cuenta conectada.
  • user:email: Lee direcciones de correo de la cuenta conectada.
Los permisos de GitHub pueden cambiar según los flujos que crees. La ventana de autorización siempre muestra el acceso actual que se solicita.

​
Preguntas frecuentes

No. Cada app usa una cuenta de GitHub compartida. Para usar múltiples cuentas de GitHub, crea apps separadas o crea un flujo OAuth personalizado con funciones de backend.
No. Los conectores son a nivel de app. Cuando conectas GitHub, conectas una sola cuenta de GitHub que todos los flujos de la app usan.Para permitir que cada persona que usa tu app conecte su propia cuenta de GitHub, necesitas crear un flujo OAuth personalizado con funciones de backend y la API de GitHub, incluyendo almacenamiento y actualización de tokens por usuario.
  1. Ve al dashboard de tu app.
  2. Haz clic en Integrations.
  3. Haz clic en la pestaña My integrations.
  4. Haz clic en el icono More actions en el conector de GitHub y selecciona Switch account.
  5. Completa el flujo de autorización de GitHub para la nueva cuenta.
El acceso a repositorios privados depende de lo que aprobaste durante la autorización y a qué repositorios puede acceder tu cuenta de GitHub conectada. Reconecta GitHub y revisa los permisos que se muestran en la ventana de autorización para asegurarte de que el conector esté autorizado para los repositorios que necesitas.Para reconectar, consulta reconectar GitHub.
Sí, si el flujo que creas requiere permisos de escritura y los apruebas durante la autorización. Siempre revisa los permisos que se muestran en el flujo de conexión antes de aprobar el acceso.
Esta página se tradujo con IA. Para información más precisa y actualizada, consulta la versión en inglés.