Sincronización de la gestión de incidencias de GitHub con Notion - Flujo de trabajo de n8n

Equipos de Desarrollo de Software: Necesitan centralizar el seguimiento de errores (bug tracking) y las solicitudes de nuevas funcionalidades gestionadas en GitHub en una herramienta de gestión de proyectos como Notion.
Jefes de Proyecto (Project Managers): Aquellos que prefieren usar Notion como única fuente de verdad para todas las actualizaciones de estado del proyecto derivadas de la actividad de los desarrolladores en GitHub.

• Usuarios de n8n: Personas que buscan plantillas avanzadas de n8n que demuestren lógica de ramificación compleja y sincronización de bases de datos utilizando las integraciones de nodos de n8n para GitHub y Notion.

Gestionar tareas de desarrollo entre diferentes plataformas puede generar silos de información. Este flujo de trabajo de n8n, altamente funcional, soluciona ese problema al establecer un espejo robusto y bidireccional entre las incidencias de GitHub y una base de datos de Notion. Cada vez que se realiza una acción en una incidencia de GitHub —ya sea abrirla, editarla, cerrarla o incluso eliminarla— esta automatización de n8n garantiza que el registro correspondiente en Notion se actualice instantáneamente. Este robusto flujo de trabajo de n8n utiliza lógica condicional y scripting personalizado para localizar y modificar de forma fiable las páginas existentes de Notion, proporcionando una potente solución sin código para la sincronización de datos multiplataforma. Aprovechando el poder de un disparador de n8n, esta plantilla es esencial para una supervisión eficiente de DevOps y del proyecto.

El proceso comienza inmediatamente tras producirse un evento especificado en GitHub, gracias al nodo disparador dedicado de n8n para GitHub.

1. Disparador y comprobación inicial: El disparador de n8n supervisa un repositorio específico de GitHub en busca de eventos de incidencias. La carga útil de datos llega entonces al nodo IF inicial de n8n, que inspecciona la acción realizada en la incidencia de GitHub (ej. 'opened', 'edited', 'closed').


2. Creación de nueva incidencia: Si la acción es 'opened' (abierta), el flujo pasa al nodo de n8n de Notion Create database page (Crear página de base de datos), registrando el título, el ID y la URL de la nueva incidencia directamente en la base de datos de Notion configurada.


3. Gestión de modificaciones: Si la acción es cualquier cosa distinta de 'opened', el flujo de trabajo de n8n pasa al nodo de función Create custom Notion filters (Crear filtros personalizados de Notion) de n8n. Este nodo genera dinámicamente una carga útil de filtro JSON para localizar la página existente de Notion utilizando el ID de la Incidencia de GitHub.


4. Búsqueda del registro: El nodo Find database page (Buscar página de base de datos) de n8n utiliza este filtro personalizado para recuperar el ID interno de la entrada correspondiente en la base de datos de Notion.


5. Enrutamiento de acciones (Switch): El nodo central Switch (Conmutador) de n8n evalúa entonces la acción específica realizada ('edited', 'deleted', 'closed', 'reopened').


6. Ejecución de actualizaciones: El flujo se ramifica hacia el nodo de n8n de Notion correspondiente: Edit issue (editar incidencia) (actualiza el título), Delete issue (eliminar incidencia) (archiva la página), Close issue (cerrar incidencia) (establece la casilla 'Closed' como verdadera) o Reopen issue (reabrir incidencia) (desmarca la casilla 'Closed'). Esto garantiza que el registro de Notion refleje el estado exacto de la incidencia de GitHub, completando el ciclo de sincronización para este completo flujo de trabajo de n8n.

Para implementar esta plantilla de n8n, sigue estos pasos:

1. Importar el flujo de trabajo de n8n: Copia los datos JSON proporcionados e impórtalos en tu instancia de n8n a través de la pantalla 'Workflows' (Flujos de trabajo) usando el botón 'New' (Nuevo) e 'Import from JSON' (Importar desde JSON).


2. Configurar credenciales: Actualiza las credenciales de marcador de posición para las conexiones de los nodos de n8n de GitHub y Notion utilizando tus claves API personales.

1. Especificar ID de base de datos: En todos los nodos de n8n de Notion (Create database page, Find database page, etc.), reemplaza el ID de base de datos de marcador de posición (5026700b-6693-473a-8100-8cc6ddef62a6) con el ID de tu base de datos real de Notion.


2. Configurar disparador de GitHub: En el disparador de n8n Trigger on issues, actualiza los campos Owner (Propietario) y Repository (Repositorio) para que coincidan con tu configuración de GitHub.


3. Activar: Una vez configurado, activa el flujo de trabajo de n8n para iniciar la sincronización en tiempo real.

Trigger on issues (Disparador de n8n de GitHub):
Función: Sirve como punto de partida, escuchando los eventos de issues (incidencias) en un repositorio específico de GitHub.
Configuración clave: Configurado para vigilar eventos en John-n8n/DemoRepo y apunta específicamente al tipo de evento issues.
IF (Nodo n8n):
Función: Dirige el flujo basándose en la acción de la incidencia de GitHub. Divide el camino entre 'opened' (nueva incidencia) y todas las demás acciones (modificaciones).
Configuración clave: Comprueba si body.action es igual a opened.
Create custom Notion filters (Nodo de función n8n):
Función: Nodo de n8n fundamental para las rutas de modificación. Utiliza JavaScript personalizado para construir una carga útil de filtro JSON de la API de Notion que busca una página donde la propiedad 'Issue ID' coincida con el ID de Incidencia de GitHub entrante.
Find database page (Nodo n8n de Notion):
Función: Ejecuta el filtro generado por el nodo n8n anterior para recuperar el pageId único de la entrada correspondiente en la base de datos de Notion.
Configuración clave: Utiliza la entrada de filtro JSON del nodo de función de n8n para realizar la búsqueda.
Switch (Nodo n8n):
Función: Determina la acción subsiguiente requerida en Notion basándose en la acción de GitHub (edited, deleted, closed, reopened). Este es un componente central de este flujo de trabajo avanzado de n8n.
Configuración clave: Compara la cadena de acción de GitHub con cuatro resultados posibles, enrutando el flujo al nodo n8n de actualización correcto.
Nodos de Notion (Crear/Editar/Eliminar/Cerrar/Reabrir incidencia):
Función: Un conjunto de nodos de n8n de Notion responsables de aplicar el cambio de estado correspondiente a la página de la base de datos de Notion encontrada previamente (ej. archivar la página si la incidencia fue eliminada, o actualizar el estado de la casilla de verificación para incidencias cerradas/reabiertas).