Você tem 200 produtos cadastrados no Mercado Livre, 50 posts agendados no Instagram e uma planilha com 500 URLs que precisam ser encurtadas e rastreadas até sexta-feira. Fazer isso manualmente custa horas de trabalho e ainda deixa a rastreabilidade das campanhas pela metade. A solução é integrar uma api encurtador de url n8n para processar links em lote, disparar pixels de retargeting automaticamente e manter tudo sob controle sem precisar abrir uma planilha.
Neste guia, você vai montar um workflow completo no n8n que consome a API do HitURL, encurta URLs dinamicamente e organiza os resultados para suas campanhas de marketing no Brasil.
O que é uma API de encurtador de URL e por que integrar com n8n?
Uma API de encurtador de URL é uma interface que permite criar links curtos programaticamente, sem precisar acessar um painel web. Com n8n, você conecta essa API a outras fontes de dados como Google Sheets, webhooks de CRM ou disparos de email, criando um pipeline que encurta, rastreia e distribui links sem intervenção manual.
O HTTP Request Node do n8n é o componente que faz a ponte entre seu workflow e qualquer API REST. Ele envia requisições HTTP, trata respostas JSON e repassa os dados para os próximos nodes do fluxo.
Uma api encurtador de url n8n transforma o processo manual de encurtar links em um pipeline automatizado: o n8n recebe os dados, chama a API, cria o link curto e devolve o resultado para qualquer sistema integrado.
Quais são os pré-requisitos para a integração?
Você precisa de três elementos básicos: uma conta no HitURL com acesso à API de desenvolvedor, uma instância do n8n rodando (cloud ou self-hosted) e o seu token de API gerado no painel. Com esses três, qualquer workflow de automação de links fica pronto em minutos.
Lista completa do que você precisa:
- Conta gratuita no HitURL (acesse hiturl.at)
- Token de API gerado nas configurações de desenvolvedor
- Instância do n8n ativa (versão cloud ou Docker self-hosted)
- Lista de URLs longas que você quer encurtar, em planilha, CRM ou webhook
- Familiaridade básica com expressões do n8n (sintaxe
{{ }})
O Método Link-Pipeline: estrutura do workflow no n8n
O Método Link-Pipeline organiza a automação de links em quatro estágios sequenciais. Cada estágio é um node no n8n com responsabilidade única, o que facilita manutenção e identificação de problemas.
- Trigger: origem dos dados. Pode ser Google Sheets, Webhook, Schedule Trigger ou execução manual.
- Transform: tratamento dos dados de entrada. Limpeza de URL, validação de formato, montagem de UTMs e geração de alias.
- Shorten: chamada HTTP para a API do encurtador. Aqui entra o HTTP Request Node.
- Distribute: destino dos dados encurtados. Planilha atualizada, mensagem no WhatsApp, email ou CRM.
Essa estrutura funciona para qualquer volume de URLs e qualquer número de campanhas simultâneas. Se um cenário novo aparece, você só ajusta o Trigger e o Distribute. O core do pipeline não muda.
O Método Link-Pipeline separa cada etapa da automação em um node independente. Se algo falhar, você sabe exatamente em qual dos quatro estágios está o problema: Trigger, Transform, Shorten ou Distribute.
Passo a passo: configurar o HTTP Request Node com a API do HitURL
Aqui está o coração da integração. O cookbook de HTTP Node do n8n documenta várias receitas de uso. Vamos focar na configuração específica para o HitURL.
Para quem busca um n8n http request encurtador, o HTTP Request Node é a peça central. Ele envia a URL longa para a API e recebe o link curto de volta em formato JSON.
Passo 1: adicionar o node HTTP Request
No canvas do n8n, arraste um node do tipo "HTTP Request". Configure os campos assim:
- Method: POST
- URL:
https://hiturl.at/api/v1/links - Authentication: Header Auth
- Header name:
Authorization - Header value:
Bearer SEU_TOKEN_AQUI
Substitua SEU_TOKEN_AQUI pelo token que você gerou no painel do HitURL. Guarde esse token como variável de ambiente do n8n para evitar expô-lo no workflow.
Passo 2: configurar o body da requisição
No campo "Body Content Type", selecione JSON. No campo "Body Parameters", adicione os seguintes campos:
url: a URL longa que será encurtadaalias: o alias personalizado (opcional)domain: o domínio base (ex:hiturl.at)
Usando expressões do n8n para preencher dinamicamente:
url:={{ $json.long_url }}alias:={{ $json.alias }}domain:hiturl.at
A sintaxe com chaves duplas e igual é como o n8n interpola valores vindos do node anterior. Cada item processado pelo node de Trigger vira uma requisição independente.
Passo 3: testar o node
Clique em "Execute Node" e verifique a resposta. Se o token estiver correto, a API retorna um JSON com o link curto criado, o alias escolhido e os dados de tracking. Se retornar erro 401, confira o token. Se retornar 400, verifique o formato do JSON enviado.
O HTTP Request Node do n8n converte cada clique, cada parâmetro de UTM e cada alias em dados estruturados que o restante do workflow pode usar. Não há limite de requisições além do rate limit definido pelo plano da API.
Passo 4: configurar o node de saída
Adicione um node Google Sheets após o HTTP Request. Configure para atualizar a planilha original com o link curto retornado. Mapeie o campo short_url da resposta da API para a coluna "link_curto" na planilha.
Pronto. Seu pipeline está funcional. Execute o workflow completo e veja a planilha ser preenchida com links rastreados automaticamente.
Veja como o HitURL rastreia cada clique, dispara seus pixels e gera QR codes dinâmicos. Crie sua conta gratuita em hiturl.at.
Como automatizar links no n8n com dados dinâmicos?
Dados dinâmicos são o que tornam o workflow útil de verdade. Em vez de encurtar uma URL por vez, você processa centenas em lote com alias único e UTMs customizadas. O segredo está nas expressões do n8n e no formato dos dados de entrada.
O objetivo de automatizar links n8n é eliminar trabalho repetitivo e garantir consistência em cada campanha. Com dados dinâmicos, cada link recebe parâmetros próprios sem esforço manual.
Exemplo: encurtar URLs de produtos do Mercado Livre
Imagine que você tem uma planilha no Google Sheets com 200 produtos. Cada linha tem: produto_id, url_original, categoria e utm_source.
Configure um node Google Sheets como Trigger. O n8n lê todas as linhas e processa cada uma como um item separado. No node Transform, monte a URL final com UTM:
={{ $json.url_original }}?utm_source={{ $json.utm_source }}&utm_medium=mercado_livre&utm_campaign=black_friday_2024
No node HTTP Request, o campo url recebe essa expressão. O alias pode ser gerado dinamicamente:
={{ 'ml-' + $json.produto_id + '-' + $json.categoria }}
O resultado: 200 links curtos com alias único, UTM completo e tracking ativado, processados em segundos. Cada clique nesses links alimenta seus relatórios de campanha sem configuração extra.
Webhook como Trigger alternativo
Se você dispara campanhas em tempo real, use um Webhook Node do n8n como trigger. Quando seu CRM envia um webhook com a URL longa, o n8n encurta e devolve o link curto em menos de 2 segundos.
Isso é ideal para disparos de WhatsApp Business API, onde cada mensagem precisa de um link curto único e rastreado. O webhook recebe a URL, processa e devolve antes do disparo acontecer.
Com webhook como trigger, o tempo entre receber uma URL longa e devolver o link curto rastreado fica abaixo de 2 segundos. Isso permite integração em tempo real com disparos de WhatsApp, email transacional e notificações push.
Segundo dados da Statista, o Brasil tem mais de 147 milhões de usuários de WhatsApp ativos, o segundo maior mercado do mundo. Links curtos rastreados disparados via WhatsApp têm potencial de alcance massivo no país.
Tratamento de erros e boas práticas no workflow
Toda integração de API precisa de tratamento de falhas. O n8n oferece ferramentas nativas para garantir que seu workflow não quebre silenciosamente.
Configurar retry automático
No node HTTP Request, ative a opção "Retry On Fail". Configure 3 tentativas com intervalo de 1 segundo entre cada uma. Isso resolve falhas temporárias de rede ou picos de rate limit sem derrubar todo o fluxo.
Usar o node Error Trigger
Adicione um node Error Trigger no workflow. Se qualquer node falhar após as tentativas de retry, o Error Trigger dispara uma notificação no Slack, Telegram ou email. Assim você sabe que algo quebrou sem precisar monitorar o painel do n8n manualmente.
Validar dados antes de enviar para a API
Antes do node HTTP Request, adicione um node IF. Verifique duas condições: se $json.long_url começa com http e se o alias tem menos de 30 caracteres. Isso evita requisições inválidas que consomem seu rate limit sem gerar resultado.
Rate limit é o número máximo de requisições que uma API aceita em um intervalo de tempo. No HitURL, o limite depende do plano. Use Batch Size no n8n para processar lotes pequenos e respeitar esse limite sem travar o workflow.
Configurar Batch Size para volumes altos
Se você processa mais de 100 URLs por execução, configure o Batch Size do node HTTP Request para 20. O n8n envia 20 requisições, aguarda a resposta, envia as próximas 20, e assim por diante. Isso evita estourar o rate limit e mantém o workflow estável mesmo com milhares de URLs.
Um estudo da Bitly indica que URLs curtas recebem até 39% mais cliques que URLs longas. Em campanhas pagas no Facebook Ads ou Google Ads, isso significa mais tráfego qualificado sem aumentar o orçamento de mídia.
Exemplos práticos de workflow n8n api links
Cenário 1: Encurtar e enviar links de afiliado Shopee via WhatsApp
Você é afiliado da Shopee e tem 100 links de promoção da Black Friday. Cada venda gera comissão de R$ 15 a R$ 50 por produto. O workflow:
- Google Sheets lê a lista de produtos e preços
- Transform monta a URL com UTM de afiliado (
utm_source=afiliado_seu_id) - HTTP Request cria o link curto no HitURL com alias personalizado
- HTTP Request envia o link curto via WhatsApp Business API para seus grupos
- Node Set registra o envio em uma planilha de controle
Resultado: 100 mensagens com links rastreados, prontos para seus grupos e listas de transmissão. Cada clique alimenta dados de conversão que você usa para otimizar próximas campanhas.
Cenário 2: Bio link dinâmico para criadores de conteúdo
Você gerencia 5 clientes no Instagram. Cada um precisa de um link na bio com 3 destinos diferentes por semana, atualizados toda segunda-feira.
- Schedule Trigger dispara toda segunda-feira às 9h (horário de Brasília)
- Google Sheets lê os 3 links de cada cliente
- HTTP Request encurta cada link no HitURL com alias da semana
- HTTP Request atualiza a link-in-bio page de cada cliente via API
- Node Set envia um relatório no Telegram com os links da semana
O guia de automação n8n com a API do HitURL detalha cada um desses cenários com exemplos de configuração prontos para copiar.
Cenário 3: Encurtar URLs para QR codes em material impresso
Você trabalha em uma loja física com 50 produtos em destaque. Quer gerar QR codes para cada produto, imprimir etiquetas e rastrear scans.
- Google Sheets com
produto_ideurl_do_produto - Transform gera alias no formato
loja-produto-{id} - HTTP Request cria o link curto no HitURL com QR code dinâmico
- HTTP Request baixa a imagem do QR code
- Node de arquivo salva as imagens em uma pasta do Google Drive
Um QR code dinâmico é aquele em que o URL de destino pode ser alterado depois de impresso, sem precisar gerar e reimprimir um novo código. Se a página do produto mudar, você atualiza o destino no HitURL e o QR code impresso continua funcionando.
A combinação de n8n com uma api encurtador n8n permite processar centenas de URLs em lote, gerar QR codes dinâmicos e atualizar destinos sem reimprimir material. O tempo de processamento fica em segundos, não em horas.
FAQ
Preciso saber programar para usar a API do HitURL no n8n?
Não. O HTTP Request Node do n8n é visual. Você configura method, URL e headers em campos de formulário. Expressões como ={{ $json.url }} substituem a programação tradicional. Não é preciso escrever código em Python ou JavaScript para criar links curtos.
Qual é o limite de requisições da API do HitURL?
O limite depende do plano. Contas gratuitas têm um rate limit generoso para testes e projetos pequenos. Para volumes altos de processamento, planos pagos aumentam o limite. Configure Batch Size no n8n para respeitar o limite sem travar o workflow.
Posso usar a API para criar QR codes dinâmicos?
Sim. A API do HitURL cria links curtos com QR code dinâmico. Um QR code dinâmico é aquele em que o URL de destino pode ser alterado depois de impresso, sem precisar gerar um novo código. Isso é útil para material impresso, embalagens e displays de loja física.
O n8n roda na nuvem ou preciso de servidor próprio?
Ambos. O n8n oferece versão cloud gerenciada e versão self-hosted via Docker. A integração com a API do HitURL funciona igual nas duas. A versão cloud é mais prática para começar. A versão self-hosted dá controle total de dados.
Como rastrear cliques dos links criados pela API?
O HitURL rastreia cada clique por padrão. O painel mostra origem geográfica, dispositivo, navegador e horário de cada acesso. Para tracking de campanha, adicione parâmetros UTM na URL original antes de encurtar. Os dados aparecem no Google Analytics ou na ferramenta de analytics que você usar.
Conclusão
Integrar uma API de encurtador de URL com o n8n elimina horas de trabalho manual e garante rastreabilidade em cada link das suas campanhas. Com o Método Link-Pipeline, você estrutura o workflow em quatro etapas claras e reutilizáveis. O HTTP Request Node faz a ponte com a API, e as expressões do n8n cuidam dos dados dinâmicos.
Comece com uma planilha pequena, teste o fluxo completo e escale para centenas de URLs quando estiver confiante. O custo é zero para começar e o ganho de produtividade é imediato.
Veja como o HitURL rastreia cada clique, dispara seus pixels e gera QR codes dinâmicos. Crie sua conta gratuita em hiturl.at.
