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 lleva a Notion el trabajo de GitHub que elijas: solicitudes de extracción (PR), incidencias o ambos. Notion importa tus registros 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) y en las incidencias 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.
Si utilizaste la sincronización heredada para importar incidencias, también puedes sincronizar incidencias con esta versión.
Elige qué llevar a Notion desde los repositorios disponibles a través de una instalación de la app de GitHub: solicitudes de extracción, incidencias o ambos. Los repositorios que selecciones integran el feed 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.
Puedes sincronizar incidencias de GitHub por sí solas o junto con las solicitudes de extracción. Esta sincronización no incluye comentarios de solicitudes de extracción ni detalles de reseña.
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.
Pon nombre a tu sincronización y elige qué llevar a Notion: solicitudes de extracción, incidencias o ambos.
Elige todo el historial disponible o una ventana de historial.
Selecciona Crear sincronización.
Notion crea la base de datos sincronizada en tu sección de barra lateral Privado y comienza a importar los registros 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 y las incidencias que elegiste 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 registros nuevos o actualizados. Los cambios, como una nueva etiqueta, una solicitud de extracción cerrada o una incidencia reabierta, actualizarán 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 o una incidencia 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 o eliminar incidencias o solicitudes de extracción: cambia lo que importa la sincronización y selecciona Guardar cambios. Al añadir un tipo, se importan sus registros correspondientes. Al eliminar un tipo, se eliminan esas páginas. Los registros que ya hayas importado para los tipos que conserves permanecerán en su lugar.
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: Deselecciona y guarda. Sus páginas de solicitudes de extracción (PR) sincronizadas se eliminarán 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, creador 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 y las incidencias 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 el registro 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.
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.
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.
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.
Confirma que su tipo está incluido en la sincronización, 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.
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 →
