Notificador Diário por Email de Lançamentos do GitHub - Fluxo de trabalho n8n

• Engenheiros DevOps: Que necessitam de alertas imediatos quando bibliotecas ou software dependentes (como o n8n) são atualizados.


• Programadores de Software: Que querem acompanhar os lançamentos de projetos de código aberto nos quais contribuem ou dos quais dependem.


• Gestores Técnicos: Que necessitam de relatórios automatizados e fiáveis sobre dependências de projetos.


• Utilizadores à procura de modelos n8n: Qualquer pessoa que procure um exemplo prático de um gatilho n8n baseado em tempo combinado com lógica condicional.

Acompanhar os lançamentos diários em múltiplos repositórios GitHub pode ser cansativo. Este robusto fluxo de trabalho n8n elimina a verificação manual ao estabelecer um sistema de monitorização programado. Utiliza um gatilho n8n recorrente diário para consultar a API do GitHub em busca das informações de lançamento mais recentes. O passo crucial é o nó de lógica condicional do n8n, que garante que um email só é enviado se um novo lançamento tiver ocorrido nas últimas 24 horas, evitando a desordem na caixa de entrada. Este modelo n8n é extremamente valioso para manter a segurança do projeto e garantir atualizações atempadas, demonstrando o poder e a flexibilidade de construir automação com o n8n.

O fluxo de trabalho n8n opera de forma linear e condicional:

1. Ativação Diária: O gatilho n8n, configurado como Schedule Trigger (Gatilho de Agendamento), inicia todo o fluxo uma vez por dia.


2. Obter Dados Mais Recentes: Um nó n8n de HTTP Request (Pedido HTTP) chama o endpoint da API do GitHub para o repositório especificado (por defeito, o último lançamento do n8n). Isto obtém metadados, incluindo a data de publicação.


3. Verificação Condicional: O nó n8n If (Se) avalia se a data de lançamento (published_at) está dentro das últimas 24 horas. Se esta condição for verdadeira (existe um novo lançamento), o fluxo de trabalho avança pelo ramo 'True' (Verdadeiro).


4. Isolar Conteúdo: O nó n8n Split Out Content (Dividir Conteúdo) extrai o conteúdo das notas de lançamento em formato markdown (body) da resposta da API.


5. Formatar para Email: O nó n8n Convert Markdown to HTML (Converter Markdown para HTML) transforma o markdown bruto em HTML limpo, necessário para um corpo de email bem formatado.


6. Enviar Notificação: Finalmente, o nó n8n Send Email (Enviar Email) entrega as notas de lançamento formatadas em HTML ao endereço de email do destinatário configurado. Isto completa o fluxo de trabalho n8n totalmente automatizado.

Para implementar este modelo n8n, siga estes passos:

1. Importar o Fluxo de Trabalho: Copie os dados JSON fornecidos e importe-os diretamente para a sua instância n8n através da opção 'Workflows' > 'New' > 'Import from JSON'.


2. Definir Credenciais SMTP: O nó n8n Send Email requer credenciais SMTP. Clique no nó, selecione 'Create New Credential' (Criar Nova Credencial) em 'SMTP' e introduza os detalhes do seu servidor de correio (host, porta, utilizador, palavra-passe).


3. Personalizar Repositório: Clique no nó n8n Fetch Github Repo Releases (Obter Lançamentos do Repositório Github). Atualize o parâmetro URL para apontar para o repositório GitHub específico que deseja monitorizar (exemplo: https://api.github.com/repos/{owner}/{repo}/releases/latest). O post-it (nota adesiva) no fluxo de trabalho n8n orienta esta alteração.


4. Personalizar Destinatário: No nó n8n Send Email, atualize os campos To Email (Para Email) e From Email (De Email) para o endereço de notificação desejado. (Isto também é indicado por uma nota adesiva).


5. Ativar: Guarde e ative o fluxo de trabalho n8n para iniciar a monitorização diária através do gatilho n8n agendado.

Este fluxo de trabalho n8n utiliza vários tipos de nós n8n fundamentais para alcançar a sua funcionalidade:

• Gatilho Diário (Schedule Trigger): O gatilho inicial do n8n. Garante que o fluxo de trabalho n8n é executado automaticamente uma vez por dia, definido pela regra de agendamento.


• Obter Lançamentos do Repositório Github (HTTP Request): Este nó n8n crucial executa a chamada à API para https://api.github.com/repos/n8n-io/n8n/releases/latest. A configuração é puramente baseada no URL.


• Se novo lançamento no último dia (If): Um nó n8n de lógica central. Compara a data published_at com a hora atual menos um dia (DateTime.utc().minus(1, 'days')). O fluxo de trabalho prossegue apenas se a data for mais recente.


• Dividir Conteúdo (Split Out): Usado para isolar e processar o campo extenso body (as notas de lançamento em markdown) antes da conversão.


• Converter Markdown para HTML (Markdown): Este nó n8n especializado recebe o conteúdo markdown derivado do passo anterior e converte-o em HTML visualizável, configurado usando a expressão ={{ $json.body }}.


• Enviar Email (EmailSend): O nó de ação final do n8n. Envia a notificação formatada. As configurações chave incluem definir o subject (assunto) como 'Novo lançamento do n8n' e definir o corpo HTML usando ={{ $json.html }}.