Conectar GitHub a Notion
Mantén las solicitudes de incorporación de cambios 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 incorporación de cambios de GitHub a partir de los repositorios que elijas. Notion importa las solicitudes de incorporación de cambios existentes y busca actualizaciones en GitHub en segundo plano.
Esta guía cubre la Sincronización de base de datos en la configuración de tu conexión de GitHub. Las propiedades sincronizadas son de solo lectura. Realiza cambios en las solicitudes de incorporación de cambios en GitHub.
Nota: Esta integración de GitHub reemplaza nuestra versión anterior. Para mantener tus datos externos actualizados, 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 incorporación de cambios desde varios repositorios disponibles a través de una instalación de la app de GitHub. Los repositorios seleccionados se integran en una base de datos de Notion.
Información | Propiedades |
|---|---|
Solicitud de incorporación de cambios | Título, Número de PR, URL de GitHub, Repositorio |
Estado | Estado: Abierto, Borrador, Fusionado o Cerrado |
Creador | Autor (GitHub) y Autor cuando se encuentre 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 un miembro del espacio de trabajo.
La propiedad Descripción sincroniza la descripción de la solicitud de incorporación de cambios como texto sin formato, copiado exactamente como está escrito en GitHub. No se renderiza como Markdown.
Esta sincronización no incluye problemas, comentarios, responsables ni detalles de reseña de GitHub.
Vas a necesitar:
Membresía en el espacio de trabajo de Notion.
Una cuenta de GitHub con acceso a los repositorios que desea sincronizar.
Una instalación de la app de GitHub con acceso a esos repositorios.
Un Plan Business (Mobile Business también califica). La sincronización de 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 Settings → Conexiones → GitHub.
Abre Database sync 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 deseas sincronizar. Usa Agregar organización… si necesitas agregar otra instalación.
Selecciona los repositorios que deseas incluir.
Elige todo el historial disponible o una ventana de historial.
Selecciona Crear sincronización.
Notion crea GitHub Pull Requests en tu sección de barra lateral Privado y comienza a importar las solicitudes de incorporación de cambios (PR) que coincidan.
Consejo: ¿Falta un repositorio? Usa Administrar acceso en GitHub para verificar a qué repositorios puede acceder la app. Si la instalación requiere aprobación, pídele a un propietario de la organización de GitHub que la apruebe.
Durante la primera importación, Notion lee las solicitudes de incorporación de cambios (PR) de cada repositorio seleccionado, comenzando por los registros actualizados más recientemente y avanzando a través del historial seleccionado.
Después de la importación, Notion verifica periódicamente cada repositorio en busca de solicitudes de incorporación de cambios (PR) nuevas y actualizadas. Los cambios, como una nueva etiqueta, una solicitud de incorporación de cambios (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. Verifica el estado de la sincronización para ver el progreso o los errores.
Elige All history, Last 30 days, Last 90 days o Last 365 days. Cuando la sincronización de todo el historial se ofrece como un interruptor, deja Sync all available history activado para incluir todas las solicitudes de incorporación de cambios (PR) disponibles.
La ventana utiliza la hora de Updated At de la solicitud de incorporación de cambios (PR). No depende de cuándo se creó la solicitud de incorporación de cambios (PR) ni de si está abierta, cerrada o fusionada.
Por ejemplo, una solicitud de incorporación de cambios (PR) abierta que no ha cambiado en más de 90 días puede quedar fuera de una ventana de 90 días.
Consejo: Las páginas más antiguas se pueden eliminar. Cuando una solicitud de incorporación de cambios (PR) queda fuera del período seleccionado, su página se elimina de la base de datos sincronizada, incluidos los valores en tus propias propiedades de Notion. Usa todo el historial disponible si necesitas conservar las solicitudes de incorporación de cambios (PR) sin cambios.
Abre la sincronización en Settings → Conexiones → GitHub → Database sync.
Agregar repositorios: Edita la selección y selecciona Guardar cambios. Notion importa las solicitudes de incorporación de cambios (PR) que coincidan de los repositorios agregados.
Eliminar repositorios: Desmárcalos y guarda. Sus páginas de solicitudes de incorporación de cambios (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 sincronizando.
Antes de eliminar repositorios o acortar el historial, guarda cualquier información exclusiva de Notion que necesites de las páginas afectadas.
Crea vistas por repositorio, estado, autor o etiqueta. Agrega tus propias propiedades para hacer seguimiento de la preparación para el lanzamiento o conecta las solicitudes de incorporación de cambios (PR) con el proceso de planificación de tu equipo. Los valores de tus propiedades se mantienen en Notion.
Para cambiar una propiedad de GitHub, abre la solicitud de incorporación de cambios (PR) usando URL de GitHub y haz el cambio en GitHub.
La base de datos comienza como privada. Si la compartes, la configuración para compartir en Notion determina quién puede ver los datos importados. Los espectadores no necesitan tener 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 puedo encontrar una organización o repositorio
Verifica que hayas seleccionado la cuenta de GitHub y la instalación de la app correctas. Confirma que tanto tu cuenta como la app tengan acceso al repositorio. Si una organización restringe las instalaciones de app, pídele a un Propietario que apruebe el acceso.
Un repositorio fue 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 movió a una organización diferente, confirma que la conexión tenga 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. Los cambios en el correo electrónico o en la membresía del espacio de trabajo de un autor podrían no actualizar automáticamente las solicitudes de incorporación de cambios (PR) sincronizadas anteriormente.
Falta una solicitud de incorporación de cambios (PR)
Confirma que el repositorio esté seleccionado, que su última actualización esté dentro de la ventana de historial y que tu vista de Notion no lo 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 obtener una comparación con Workers y orientación compartida para solucionar problemas, consulta Sincronizar datos de otras herramientas a Notion →
