Conecta GitHub a Notion
Mantén las solicitudes de extracción (PR) junto a los planes de proyecto de tu equipo en Notion.
Una sincronización gestionada de GitHub crea una base de datos de Solicitudes de extracción de GitHub a partir de los repositorios que elijas. Notion importa las solicitudes de extracción (PR) existentes y comprueba si hay actualizaciones en GitHub en segundo plano.
Esta guía cubre la Sincronización de base de datos en los ajustes de tu conexión de GitHub. Las propiedades sincronizadas son de solo lectura. Realiza cambios en las solicitudes de extracción (PR) en GitHub.
Nota: Esta integración de GitHub sustituye a nuestra versión heredada. Para mantener actualizados tus datos externos, configura tus nuevas sincronizaciones antes del 30 de octubre de 2026. Tus bases de datos sincronizadas existentes permanecerán en Notion, pero dejarán de actualizarse después de esa fecha.
Puedes sincronizar solicitudes de extracción (PR) de varios repositorios disponibles a través de una instalación de la aplicación de GitHub. Los repositorios seleccionados se integran en una base de datos de Notion.
Información | Propiedades |
|---|---|
Solicitud de extracción (PR) | Título, número de PR, URL de GitHub, repositorio |
Región | Estado: abierto, borrador, fusionado o cerrado |
Autor | Autor (GitHub) y Autor cuando se pueda encontrar un miembro de Notion coincidente |
Organización | Etiquetas, rama base, rama principal |
Fechas | Creado el, actualizado el, cerrado el, fusionado el |
La propiedad Autor (GitHub) contiene el nombre de usuario de GitHub. Autor es una propiedad de persona de Notion cuando el correo electrónico público disponible del autor coincide con el de un miembro del espacio de trabajo.
La propiedad Descripción sincroniza la descripción de la solicitud de extracción (PR) como texto sin formato, copiado exactamente como está escrito en GitHub. No se renderiza como markdown.
Esta sincronización no incluye incidencias, comentarios, responsables ni detalles de revisión de GitHub.
Necesitarás:
Ser miembro del espacio de trabajo de Notion.
Una cuenta de GitHub con acceso a los repositorios que quieres sincronizar.
Una instalación de la app de GitHub con acceso a esos repositorios.
Un plan Business (Mobile Business también es válido). La sincronización con GitHub no está disponible en otros planes.
Tanto tu cuenta de GitHub como la instalación de la app necesitan acceso. Es posible que la organización de GitHub requiera que un propietario apruebe o instale la app.
En Notion, ve a Configuración → Conexiones → GitHub.
Abre Sincronización de base de datos y conecta tu cuenta de GitHub si aún no lo has hecho.
Completa los pasos de autorización e instalación de GitHub.
Elige la organización o cuenta cuyos repositorios quieras sincronizar. Usa Añadir organización… si necesitas añadir otra instalación.
Selecciona los repositorios que quieres incluir.
Elige todo el historial disponible o una ventana de historial.
Selecciona Crear sincronización.
Notion crea Solicitudes de extracción (PR) de GitHub en tu sección de barra lateral Privado y comienza a importar las solicitudes de extracción (PR) coincidentes.
Consejo: ¿Falta un repositorio? Utiliza Manage access on GitHub para comprobar a qué repositorios puede acceder la app. Si la instalación requiere aprobación, pide a un propietario de la organización de GitHub que la apruebe.
Durante la primera importación, Notion lee las solicitudes de extracción (PR) de cada repositorio seleccionado, empezando por los registros actualizados más recientemente y continuando con el historial seleccionado.
Tras la importación, Notion comprueba periódicamente cada repositorio en busca de solicitudes de extracción (PR) nuevas o actualizadas. Los cambios, como una nueva etiqueta, una solicitud de extracción (PR) cerrada o una fusión, actualizan las propiedades correspondientes en Notion.
La sincronización se ejecuta incluso cuando cierras Notion. Los repositorios grandes, los límites de solicitudes de GitHub y los problemas temporales del servicio pueden retrasar las actualizaciones. Comprueba el estado de la sincronización para ver el progreso o los errores.
Elige Todo el historial, Últimos 30 días, Últimos 90 días o Últimos 365 días. Cuando la sincronización de todo el historial se ofrezca como un interruptor, deja activado Sincronizar todo el historial disponible para incluir todas las solicitudes de extracción (PR) disponibles.
La ventana utiliza la hora de Actualizado en de la solicitud de extracción (PR). No depende de cuándo se creó la solicitud de extracción (PR) ni de si está abierta, cerrada o fusionada.
Por ejemplo, una solicitud de extracción (PR) abierta que no haya cambiado en más de 90 días puede quedar fuera de una ventana de 90 días.
Consejo: Las páginas antiguas pueden eliminarse. Cuando una solicitud de extracción queda fuera del periodo seleccionado, su página se elimina de la base de datos sincronizada, incluidos los valores de tus propias propiedades de Notion. Utiliza todo el historial disponible si necesitas conservar las solicitudes de extracción que no hayan cambiado.
Abre la sincronización en Configuración → Conexiones → GitHub → Sincronización de base de datos.
Añadir repositorios: Edita la selección y selecciona Guardar cambios. Notion importa las solicitudes de extracción (PR) coincidentes de los repositorios añadidos.
Eliminar repositorios: Desmárcalos y guarda. Sus páginas de solicitudes de extracción (PR) sincronizadas son eliminadas de Notion.
Historial de cambios: Una ventana más larga importa registros adicionales. Una ventana más corta elimina los registros fuera de la nueva ventana.
Pausar actualizaciones: Selecciona Pausar sincronización. Los datos y la configuración existentes permanecen.
Reanudar actualizaciones: Selecciona Reanudar sincronización para continuar con la sincronización.
Antes de eliminar repositorios o acortar el historial, conserva cualquier información exclusiva de Notion que necesites de las páginas afectadas.
Crea vistas por repositorio, estado, autor o etiqueta. Añade tus propias propiedades para realizar un seguimiento de la preparación para el lanzamiento o conecta las solicitudes de extracción (PR) con el proceso de planificación de tu equipo. Los valores de tus propias propiedades permanecen en Notion.
Para cambiar una propiedad de GitHub, abre la solicitud de extracción (PR) usando URL de GitHub y realiza el cambio en GitHub.
La base de datos comienza como privada. Si la compartes, la configuración de uso compartido de Notion determina quién puede ver los datos importados. Los espectadores no necesitan acceso individual al repositorio de origen, así que revisa los permisos de la base de datos antes de compartir información de un repositorio privado.
No encuentro una organización o repositorio
Comprueba que has seleccionado la cuenta de GitHub y la instalación de la app correctas. Confirma que tanto tu cuenta como la app tienen acceso al repositorio. Si una organización restringe las instalaciones de apps, pide a un propietario que apruebe el acceso.
Un repositorio ha sido renombrado o movido
Abre la configuración del repositorio de la sincronización, revisa la selección del repositorio y guárdala de nuevo. Si se ha movido a una organización diferente, confirma que la conexión tiene acceso en la nueva ubicación.
La propiedad Autor está vacía
Un nombre de usuario de GitHub no siempre tiene un correo electrónico público disponible que coincida con un miembro del espacio de trabajo de Notion. Usa Autor (GitHub) para identificar al autor cuando la propiedad de persona esté vacía. Es posible que los cambios en el correo electrónico o en la pertenencia al espacio de trabajo de un autor no actualicen automáticamente las solicitudes de extracción (PR) sincronizadas anteriormente.
Falta una solicitud de extracción (PR)
Confirma que su repositorio está seleccionado, que su última actualización está dentro de la ventana de historial y que la vista de Notion no la esté filtrando. Es posible que la primera importación aún se esté ejecutando.
La base de datos ha dejado de actualizarse
Abre los detalles del estado de la sincronización. Vuelve a conectar tu cuenta de GitHub o restaura el acceso al repositorio si se te solicita. Los límites de solicitudes de GitHub y las interrupciones temporales pueden retrasar las actualizaciones mientras Notion vuelve a intentarlo.
Para comparar Workers y obtener orientación compartida para solucionar problemas, consulta Sincronizar datos de otras herramientas con Notion →
