Feriados do mês no celular com n8n (BrasilAPI + ntfy) | Trilha Iniciante, Etapa 5

O que a automação resolve

A quinta etapa da trilha de iniciantes do canal Orbitacode ensina a construir um fluxo no n8n capaz de consultar a lista de feriados nacionais brasileiros do ano e notificar, no primeiro dia de cada mês, quais deles ocorrem naquele período. O problema resolvido é comum para quem planeja rotinas, viagens ou equipes de trabalho: a conferência manual de calendários oficiais. Com a automação, o próprio sistema realiza a consulta, filtra os dados relevantes e entrega o resultado diretamente no celular por meio do aplicativo ntfy, sem a necessidade de abrir navegador, site ou planilha.

A lógica central do vídeo é demonstrar, em um exemplo prático e enxuto, como encadear diferentes nós do n8n para transformar dados brutos de uma API pública em informação pessoal útil. A BrasilAPI, serviço gratuito e sem exigência de cadastro ou chave de acesso, fornece o conjunto completo de feriados nacionais de um ano. O n8n processa essa lista, identifica apenas as datas pertencentes ao mês corrente e envia uma mensagem consolidada. O caráter didático da abordagem fica evidente na escolha de um fluxo curto, com cinco nós, que permite ao iniciante visualizar claramente a função de cada etapa antes de avançar para casos mais complexos.

Decompondo o fluxo em cinco nós

O primeiro elemento do workflow é o Manual Trigger, descrito como o botão de partida. Trata-se do nó responsável por iniciar a execução quando o usuário clica em “Execute workflow” no ambiente de edição. Em uma fase de testes, esse recurso permite validar toda a lógica antes da automação ser publicada e agendada. O segundo nó é o HTTP Request configurado com método GET para consultar a BrasilAPI. A URL de chamada inclui uma expressão dinâmica, {{ $now.year }}, que substitui automaticamente o valor do ano vigente, evitando que o usuário precise editar o fluxo manualmente a cada janeiro.

O terceiro nó, denominado Filter, atua como uma peneira. Ele recebe os dados retornados pela API e aplica a condição de que o campo de data deve iniciar com o formato ano-mês atual, obtido por meio da expressão {{ $today.format('yyyy-MM') }}. O detalhe do M maiúsculo é destacado no vídeo como um ponto de atenção relevante: a diferença entre MM e mm, sendo este último interpretado como minutos, é causa frequente de erros. A saída filtrada contém apenas os feriados do mês, e o nó é configurado com Always Output Data para que, mesmo em meses sem feriado, o fluxo continue e uma mensagem informativa seja enviada.

O quarto nó, também um HTTP Request, desta vez com método POST, envia a notificação ao serviço ntfy. A lógica de páginação ou repetição é controlada pelo Execute Once, que garante o envio de uma única mensagem consolidada em vez de uma notificação para cada feriado. O quinto e último nó, o Schedule Trigger, define a recorrência mensal no primeiro dia às oito da manhã. Nos testes, é possível executar manualmente a partir do agendamento sem esperar o gatilho natural, usando a seta do nó.

BrasilAPI e ntfy como ferramentas acessíveis

O vídeo opta por duas tecnologias gratuitas que reduzem a barreira de entrada para o aprendizado. A BrasilAPI dispensa cadastro, chave de autenticação ou configuração de CORS, tornando o endpoint de feriados imediatamente utilizável. O serviço é mantido pela comunidade e oferece dados padronizados para diversos contextos brasileiros. No fluxo apresentado, o retorno da API inclui campos como date, name e type, sendo a data o campo usado na condição do filtro.

O ntfy, por sua vez, é um serviço de notificações push baseado em tópicos. O usuário instala o aplicativo no celular, assina um tópico próprio e o n8n envia mensagens para a URL correspondente. O vídeo demonstra como configurar o corpo da mensagem com título, tag de calendário e conteúdo em texto simples. A escolha de um tópico único e pessoal garante que a notificação chegue de forma privada e imediata. Essa combinação de simplicidade e controle torna o ntfy uma alternativa interessante a aplicativos de mensageria que exigem tokens ou permissões extras.

O papel das expressões no n8n

Um dos ensinamentos centrais da etapa é o uso de expressões JavaScript dentro dos campos de configuração. O {{ $now.year }} e {{ $today.format('yyyy-MM') }} exemplificam como dados dinâmicos podem ser inseridos em URLs e condições sem a necessidade de código externo. O vídeo destaca que a expressão de ano deve usar .year para extrair o valor numérico completo; a ausência desse atributo gera erro de cálculo. Da mesma forma, a formatação de mês exige o formato correto de maiúsculas e minúsculas, reforçando a importância de compreender o que cada parte da expressão faz.

O nó Filter, ao comparar strings, exige que a condição identifique se o valor da data começa com o prefixo ano-mês. Essa abordagem de prefixo, em vez de buscar o mês completo isolado, garante que não haja confusão entre meses de anos diferentes. Para o iniciante, o vídeo mostra que a programação no n8n não éxige decorar sintaxes complexas, mas sim compreender a lógica de transformação de dados entre os nós. Cada nó entrega um conjunto de dados que pode ser inspecionado visualmente no editor, facilitando o diagnóstico quando algo não funciona como esperado.

Erros comuns e a curva de aprendizado

A seção de erros comuns cumpre um papel didático relevante ao antecipar situações que inevitavelmente surgem para quem começa. A mensagem “The service was not able to process your request” está associada à ausência do .year na URL, enquanto “Ano fora do intervalo suportado entre 1900 e 2199” indica que o ano foi interpretado com dois dígitos. Outro caso recorrente é a chegada constante da mensagem “Nenhum feriado nacional este mês” mesmo em meses com datas comemorativas, causada pelo uso de mm minúsculo no lugar de MM, que representa minutos em JavaScript.

A ausência de notificações em meses sem feriado é atribuída à falta da opção Always Output Data no nó Filter. Quando o filtro bloqueia todos os itens, o nó seguinte pode não ser executado; essa configuração força a passagem de um item vazio para manter o fluxo ativo. Já o recebimento de múltiplas mensagens em meses com vários feriados indica que o Execute Once não foi ativado no nó de envio. O triângulo amarelo exibido após alterações no workflow é explicado como um aviso de que o fluxo precisa ser executado novamente para refletir as mudanças, não sendo necessariamente um erro crítico. Esses esclarecimentos reduzem a frustração e aceleram a compreensão da ferramenta.

Diferença entre ambiente local e produção

O vídeo dedica uma parte importante para explicar a diferença entre executar o n8n no computador do usuário, via Docker, e rodá-lo em um servidor remoto. No ambiente local, o serviço depende de o computador estar ligado e do Docker em execução; se a máquina for desligada, a automação não dispara no horário agendado. Esse modelo é recomendado para aprendizado e testes, pois não éxige investimento e mantém o controle total sobre a instalação.

Em produção, o n8n fica em uma máquina ligada permanentemente, acessível pela internet, capaz de executar agendamentos mesmo quando o usuário está desconectado. A série sinaliza que esse é o caminho natural de evolução para quem pretende usar as automações em contextos reais de trabalho. A distinção entre os dois cenários ajuda o iniciante a entender que a etapa atual é preparatória: o foco está em dominar a lógica dos nós, expressões e configurações antes de subir o sistema para um ambiente de produção.

Integração com a trilha de iniciantes

O vídeo se posiciona como a quinta etapa de uma trilha progressiva, na qual cada etapa anterior introduziu um conceito fundamental. A primeira etapa cuidou da instalação do n8n via Docker, a segunda apresentou o nó HTTP Request com a primeira automação, a terceira trabalhou com formulários e expressões usando o CEP, e a quarta introduziu o Schedule Trigger com o envio de lembretes via ntfy. A etapa atual consolida esses aprendizados ao combinar consulta externa, filtro condicional, agendamento e envio de notificação em um único fluxo.

A próxima etapa, já anunciada no vídeo, avança para o uso de outra API, a Frankfurter, para construir um conversor de moedas com formulário. Esse encadeamento permite que o aluno acumule repertório sem a sobrecarga de conceitos isolados. Cada novo nó ou configuração surge dentro de um contexto de necessidade real, o que facilita a retenção. A trilha reflete uma abordagem paciente e incremental, alinhada à proposta do canal de ensinar n8n “um nó de cada vez”, sem pressupor conhecimento prévio de programação avançada ou integração de sistemas.

Relevância para o público brasileiro

O uso da BrasilAPI confere um sabor local ao tutorial, pois lida com a realidade dos feriados nacionais brasileiros. Em vez de exemplos genéricos com APIs internacionais, o aluno constrói algo que pode ser imediatamente aplicado no seu cotidiano. A recorrência mensal no primeiro dia às oito da manhã se encaixa em um hábito matinal de revisar compromissos, tornando a automação útil de fato. A combinação de serviço brasileiro com ferramentas globais como n8n e ntfy mostra como ecossistemas locais podem ser integrados a fluxos de trabalho modernos.

A possibilidade de importar o JSON do workflow a partir do artigo vinculado reduz ainda mais a barreira para quem prefere estudar a implementação depois de vê-la funcionando. O material escrito complementa o vídeo com as expressões completas e a configuração exata de cada nó, servindo de referência para consultas futuras. Essa estratégia de documentação paralela fortalece o aprendizado e posiciona o conteúdo como um recurso permanente, não apenas um vídeo descartável.