Automatize a conversão de imagens com n8n (passo a passo)

n8n é uma ferramenta de automação de workflows. Você conecta blocos e eles executam tarefas por você. Sem precisar escrever código.

Uma das coisas mais úteis para automatizar com n8n é a conversão de imagens. Em vez de converter arquivos na mão, você configura um workflow uma vez. Ele cuida de cada imagem depois disso. Coloque uma foto numa pasta e a versão convertida aparece segundos depois.

Este guia mostra toda a configuração. No final, você vai ter um workflow n8n funcionando que converte imagens para qualquer formato no piloto automático. Se você é novo em automação de imagens, comece pelo nosso guia completo de automação para ter a visão geral.

O que é n8n e por que usar para conversão de imagens?

n8n é uma plataforma de automação open-source. Pense nela como blocos de montar para tarefas. Você escolhe um gatilho (algo que inicia o workflow), adiciona passos de ação e conecta tudo. Cada passo passa os dados para o próximo.

Para conversão de imagens, n8n é perfeito porque:

• Sem código. Você arrasta blocos para um canvas e conecta. Se sabe usar uma planilha, consegue montar um workflow no n8n.
• Conecta tudo. n8n tem nodes para Google Drive, Dropbox, S3, Slack, email e centenas de outros serviços. Suas imagens podem vir de qualquer lugar e ir para qualquer lugar.
• Roda no piloto automático. Uma vez ativo, o workflow monitora novos arquivos e processa sem nenhuma interação sua.
• Você pode hospedar. Rode n8n no seu próprio servidor para controle total dos dados. Ou use o serviço cloud deles se preferir não gerenciar servidores.

O node ConvertIMG para n8n conecta direto à API do ConvertIMG. Ele cuida de todas as chamadas de API nos bastidores. Você só escolhe as configurações e deixa rodar.

Como configurar o n8n com ConvertIMG?

Começar leva cerca de 15 minutos. Aqui está o que você precisa.

Pré-requisitos:

• Uma conta n8n (cloud ou self-hosted)
• Uma chave de API do ConvertIMG (pegue uma em convertimg.app)

Passo 1: Instale o node ConvertIMG.

Na sua instância n8n, vá em Settings > Community Nodes. Procure por "ConvertIMG" e instale. O node vai aparecer na paleta de nodes em "Image."

Passo 2: Adicione suas credenciais de API.

Vá em Settings > Credentials > Add Credential. Selecione "ConvertIMG API" e cole sua chave de API. Dê um nome claro como "ConvertIMG Produção." Clique em salvar.

Passo 3: Teste a conexão.

Crie um novo workflow. Arraste o node ConvertIMG para o canvas. Selecione sua credencial. O node deve mostrar um check verde se a conexão funcionar.

Essa é a base. Agora vamos montar um workflow de verdade.

Como montar seu primeiro workflow de conversão?

Vamos construir um workflow que monitora uma pasta no Google Drive, converte novas imagens para WebP e salva os resultados.

Bloco 1: Google Drive Trigger

Adicione um node "Google Drive Trigger". Configure para monitorar uma pasta específica. Escolha "File Created" como evento. Ele dispara sempre que um novo arquivo chega naquela pasta.

Bloco 2: Baixar o arquivo

Adicione um node "Google Drive" (não o trigger). Configure a operação como "Download." Conecte ao trigger. Ele pega os dados do arquivo para o próximo passo processar.

Bloco 3: Converter com ConvertIMG

Adicione o node ConvertIMG. Conecte ao passo de download. Configure assim:

• Input: Dados binários do passo anterior
• Formato de saída: webp
• Qualidade: 85
• Remover metadados: Sim

O node envia a imagem para a API do ConvertIMG e retorna o arquivo convertido.

Bloco 4: Upload do resultado

Adicione outro node Google Drive. Configure a operação como "Upload." Escolha sua pasta de saída. Conecte ao node ConvertIMG. O arquivo WebP convertido é salvo na sua pasta de saída.

Bloco 5 (opcional): Enviar notificação

Adicione um node Slack ou Email. Mande uma mensagem com o nome do arquivo e os detalhes da conversão. Isso ajuda quando você está testando, pra saber que o workflow está rodando.

Ative o workflow. Coloque um JPG na pasta de entrada. Alguns segundos depois, a versão WebP deve aparecer na pasta de saída.

É possível fazer conversões em lote no n8n?

Sim. O n8n processa itens em sequência por padrão. Se 100 imagens chegarem na pasta monitorada, o workflow pega e converte uma por uma.

Para trabalhos em lote, algumas coisas para ter em mente.

Use o node Loop para lotes grandes. Se você está alimentando uma lista de arquivos no workflow (digamos, de uma listagem de bucket S3), o node Loop processa cada item pelos seus passos de conversão.

Defina tamanhos de lote razoáveis. Se está processando milhares de imagens, divida em lotes. O node Wait pode adicionar um pequeno delay entre lotes para não sobrecarregar a API.

Monitore o progresso. Adicione um node "Set" que rastreia um contador. Registre numa planilha ou banco de dados para ver quantas imagens foram processadas.

Lide com formatos diferentes. Use um node IF para verificar a extensão do arquivo. Direcione JPGs para um conjunto de configurações e PNGs para outro. Isso é útil quando sua pasta de entrada tem formatos misturados.

Um exemplo prático: um time de e-commerce coloca 200 fotos novas de produtos no Google Drive toda semana. O workflow n8n converte cada uma para WebP e AVIF, faz upload das duas versões para o CDN e posta um resumo no Slack. O processo todo leva cerca de 10 minutos com zero esforço humano.

Como lidar com erros no seu workflow?

Coisas podem dar errado. Um arquivo pode estar corrompido. A API pode dar timeout. Seu armazenamento pode estar cheio. Bons workflows planejam para isso.

Use o node Error Trigger. O n8n tem um node dedicado para tratamento de erros. Adicione ao seu workflow e conecte a um passo de notificação. Quando qualquer passo falhar, você recebe um alerta com os detalhes do erro.

Adicione lógica de retry. Para problemas temporários como timeouts de rede, use a opção Retry on Fail disponível na maioria dos nodes. Configure para tentar 2-3 vezes com um delay curto. Isso resolve a maioria dos erros transitórios.

Valide os arquivos de entrada. Antes de enviar um arquivo para o node ConvertIMG, verifique se é realmente uma imagem. Use um node IF para verificar a extensão do arquivo ou tipo MIME. Pule arquivos que não são imagens em vez de deixar falhar.

Registre tudo. Envie os resultados de conversão para uma planilha ou banco de dados. Inclua o nome do arquivo, formato de entrada, formato de saída, tamanho do arquivo e status (sucesso ou erro). Isso te dá um registro completo do que aconteceu.

Configure uma fila de erros. Arquivos que falham mesmo depois dos retries devem ser movidos para uma pasta "falhas" separada. Você pode revisar depois e reprocessar manualmente se necessário.

Aqui vai um checklist para um workflow robusto:

• Node Error Trigger conectado a alertas no Slack/email
• Retry on Fail habilitado no node ConvertIMG (3 tentativas, delay de 10 segundos)
• Node IF para filtrar arquivos que não são imagens
• Caminho de saída de erros que move arquivos com falha para uma pasta de revisão
• Um registro de log para cada arquivo processado

Quais são alguns exemplos reais de workflows?

Aqui estão três workflows que times usam em produção.

Pipeline de produtos e-commerce. Gatilho: nova foto no Google Drive. Passos: converter para WebP (qualidade 85) e AVIF (qualidade 80). Upload das duas para S3 com caminhos de pasta estruturados. Atualizar uma planilha com as URLs do CDN. Notificar o time de conteúdo no Slack.

Workflow de conteúdo do blog. Gatilho: webhook de um CMS. Passos: baixar a imagem destacada. Converter para WebP. Redimensionar para três tamanhos (completo, médio, miniatura). Upload dos três para o CDN. Retornar as URLs para o CMS via resposta do webhook.

Processamento de uploads de usuários. Gatilho: webhook HTTP do seu app. Passos: receber a imagem enviada. Remover metadados por privacidade. Converter para WebP. Upload para S3. Retornar a URL de download para o app. Isso é essencialmente o que a API do ConvertIMG faz, mas dentro de um workflow n8n que pode adicionar passos extras.

Para detalhes técnicos completos sobre o que o node ConvertIMG pode fazer, confira nosso guia do node n8n. Ele cobre cada parâmetro e opção de configuração.

Você também pode estender esses workflows além da conversão. Adicione um passo que envia imagens para o CompressIMG (o node CompressIMG para n8n facilita isso) para compressão extra depois de converter. Ou use o UpscaleIMG (também existe um node UpscaleIMG para n8n) para melhorar a resolução de imagens de baixa qualidade antes de convertê-las para um formato otimizado para web. O n8n conecta as três ferramentas em um único pipeline.

n8n transforma a conversão de imagens de uma tarefa diária chata em algo que simplesmente acontece. Configure uma vez e suas imagens cuidam de si mesmas.