Você envia dezenas de mensagens no WhatsApp por dia com URLs longas que parecem spam, quebram no envio e não te dão nenhum dado sobre quem clicou. Encurtar cada link manualmente consome minutos que viram horas no fim do mês.
Uma api encurtador de link resolve esse problema quando integrada ao n8n, uma ferramenta open-source de automação de fluxos de trabalho. Neste guia, você vai aprender a conectar a API do HitURL ao n8n para criar, rastrear e distribuir links curtos de forma totalmente automatizada.
Por que combinar n8n com uma API de encurtador de URL?
O n8n é uma plataforma de automação que conecta diferentes aplicativos através de nodes, que são blocos visuais representando etapas de um fluxo. Cada node executa uma ação: receber dados, transformar informações, enviar para outra ferramenta. A documentação oficial está disponível em docs.n8n.io/integrations e cobre centenas de integrações prontas.
Quando você combina o n8n com uma api encurtar url gratis como a do HitURL, ganha três vantagens concretas:
- Velocidade: um fluxo cria centenas de links curtos em segundos.
- Rastreamento: cada link gerado já vem com pixel de retargeting e UTM (Urchin Tracking Module, parâmetros adicionados à URL para medir a origem do tráfego) configurados.
- Escala: conecte o encurtador a planilhas, CRMs, WhatsApp e redes sociais sem digitar um link manualmente.
Automação de links não é sobre economizar 30 segundos por link. É sobre garantir que cada URL rastreie cliques, dispare pixels e gere dados consistentes em escala.
No Brasil, o WhatsApp tem mais de 147 milhões de usuários ativos, segundo o relatório Digital 2024 Brazil da DataReportal. Cada conversa é uma oportunidade de compartilhar um link rastreado. Fazer isso manualmente não escala.
Como funciona a API do HitURL?
A API do HitURL é uma interface REST, um padrão de comunicação entre sistemas via HTTP, que permite criar, gerenciar e rastrear links curtos programaticamente. Você envia uma requisição POST com a URL original e recebe de volta o link encurtado, pronto para uso imediato.
Para começar, você precisa de uma chave de API. Acesse a página de desenvolvedores do HitURL e gere seu token. O plano gratuito já inclui acesso à API, então você pode testar sem custo nenhum.
Um exemplo básico de requisição:
POST https://hiturl.at/api/v1/links
Headers: Authorization: Bearer SEU_TOKEN
Body: { "url": "https://sualoja.com.br/produto-destaque", "alias": "promoverrj" }
A resposta retorna o link curto, o QR code dinâmico (um QR code cujo destino pode ser alterado após a impressão, sem precisar gerar um novo código) e os dados de rastreamento configurados. Tudo em uma única chamada.
A API do HitURL retorna não apenas o link encurtado, mas também o QR code dinâmico e os parâmetros de rastreamento ativos, em uma única chamada.
Se você já trabalha com webhooks e automações, vale conferir nosso guia sobre como usar Supabase e webhooks para gerar QR codes dinâmicos, que complementa o fluxo de automação que vamos construir aqui.
Método de 3 Estágios para Automação de Links
Desenvolvi um framework para estruturar automações de links de forma organizada. Chamo de Método de 3 Estágios para Automação de Links. Ele separa o fluxo em três partes independentes:
- Entrada de dados: uma fonte dispara o fluxo. Pode ser uma nova linha no Google Sheets, um webhook de e-commerce, um formulário recebido, ou até um novo post no Instagram.
- Processamento: o n8n recebe os dados, monta a URL com UTMs apropriados e envia para a API do HitURL criar o link curto com todas as configurações de rastreamento.
- Distribuição: o link curto gerado é enviado para o canal final: WhatsApp, Instagram, e-mail, CRM, ou qualquer outro destino.
O Método de 3 Estágios separa entrada, processamento e distribuição. Cada estágio é independente, o que facilita testar, debugar e escalar o fluxo sem afetar as outras etapas.
Essa separação importa na prática. Se algo quebra, você sabe exatamente em qual estágio procurar. Se precisa adicionar um novo canal de distribuição, não mexe na entrada nem no processamento. Se quer trocar o encurtador, ajusta só o estágio de processamento.
Passo a passo: configurando o n8n com a API do HitURL
Agora vamos à prática. Você vai criar um workflow que recebe URLs de uma planilha e devolve links curtos rastreados, prontos para uso.
Passo 1: Instalar e configurar o n8n
O n8n pode ser usado em nuvem ou self-hosted (instalado no seu próprio servidor). Para começar rápido, acesse n8n.io e crie uma conta gratuita. A versão em nuvem dispensa configuração de infraestrutura.
O n8n ultrapassou 400 mil instalações ativas em 2024, segundo dados da própria plataforma, e se tornou uma das ferramentas de automação de código aberto que mais cresce no mundo.
Passo 2: Criar o node de entrada
Adicione um node Google Sheets configurado para ler uma coluna com URLs longas. Configure o trigger para rodar a cada hora, ou mediante webhook quando uma nova linha for adicionada.
Exemplo de planilha:
- Produto: Tênis Runner | URL Longa: https://minhaloja.com.br/tenis-runner | UTM Source: instagram
- Produto: Mochila Trek | URL Longa: https://minhaloja.com.br/mochila-trek | UTM Source: whatsapp
- Produto: Garrafa Térmica | URL Longa: https://minhaloja.com.br/garrafa-termica | UTM Source: tiktok
Passo 3: Adicionar o node HTTP Request
Este é o coração da automação. Configure um node HTTP Request com os seguintes parâmetros:
- Method: POST
- URL: https://hiturl.at/api/v1/links
- Headers: Authorization: Bearer SEU_TOKEN, Content-Type: application/json
- Body: { "url": "{{$json['URL Longa']}}", "alias": "{{$json['Produto'].toLowerCase().replace(/\s/g,'')}}", "utm_source": "{{$json['UTM Source']}}" }
O n8n usa expressões entre chaves duplas para injetar dados dinâmicos de nodes anteriores. Cada linha da planilha vira uma requisição separada para a API.
Passo 4: Processar a resposta
Adicione um node Set para capturar e estruturar o link curto retornado pela API:
- link_curto: {{$json['data']['short_url']}}
- qr_code: {{$json['data']['qr_code']}}
- criado_em: {{$json['data']['created_at']}}
Passo 5: Distribuir os links
Adicione um node final de acordo com seu destino preferido:
- Google Sheets: grava o link curto de volta na planilha original, ao lado da URL longa.
- WhatsApp Business API: envia o link para contatos ou grupos específicos.
- HTTP Request: manda para seu CRM ou ferramenta de e-mail marketing.
Pronto. Seu workflow de automatizar links n8n está funcional e pronto para processar URLs em escala.
Veja como o HitURL rastreia cada clique, dispara seus pixels e gera QR codes. Crie sua conta gratuita em hiturl.at.
Casos de uso práticos no mercado brasileiro
Vamos a três cenários reais que você pode implementar hoje mesmo.
Cenário 1: E-commerce no Mercado Livre
Uma loja de eletrônicos no Mercado Livre precisa gerar links de afiliados rastreados para 200 produtos por semana. Manualmente, isso leva cerca de 4 horas de trabalho repetitivo.
Com n8n e a API do HitURL:
- Planilha Google recebe as URLs dos produtos do Mercado Livre.
- n8n processa cada URL e cria um link curto com UTM e pixel do Facebook configurados.
- Links são gravados de volta na planilha, prontos para campanhas de tráfego pago.
Tempo total do fluxo: 2 minutos. Economia semanal: 3 horas e 58 minutos. Em um mês, são mais de 15 horas economizadas.
Cenário 2: Distribuição de conteúdo no WhatsApp
Um criador de conteúdo envia links de vídeos novos para uma lista de 500 contatos no WhatsApp. Sem automação, cada link é encurtado, copiado e colado individualmente, um por um.
Com o workflow automatizado:
- Upload de vídeo no YouTube dispara um webhook.
- n8n cria o link curto com alias personalizado (ex: hiturl.at/video2024).
- Link é enviado para o WhatsApp Business API com mensagem personalizada.
Cada envio fica rastreado. Você sabe quem clicou, quando e de qual dispositivo. Para aprofundar essa estratégia, leia nosso guia sobre como rastrear cliques de links no WhatsApp e descobrir quais contatos engajam mais com seu conteúdo.
Cenário 3: Campanhas sazonais com QR codes dinâmicos
Uma rede de restaurantes imprime QR codes em cardápios físicos para cada filial. Cada QR code precisa apontar para um menu digital diferente, por cidade e por temporada.
Com n8n integrado à API do HitURL:
- Planilha lista cada filial e sua URL de menu correspondente.
- n8n cria os links curtos e gera QR codes dinâmicos via API em lote.
- QR codes são baixados automaticamente para impressão.
O QR code dinâmico permite trocar o destino sem reimprimir o material. Se o menu muda de uma temporada para outra, você atualiza a URL na API e o QR code antigo já aponta para o novo destino.
QR codes dinâmicos eliminam o custo de reimpressão. O mesmo código impresso uma vez pode mudar de destino quantas vezes for necessário, através de uma única chamada de API.
Como rastrear e otimizar seus links automatizados?
A criação automática de links é metade do trabalho. A outra metade é rastrear, analisar e otimizar com base nos dados coletados. Cada link criado pela API do HitURL já vem com rastreamento embutido, mas você precisa configurar os recursos certos no momento da criação.
Você pode configurar três tipos de segmentação e rastreamento diretamente pela API:
- Geo targeting: redirecionar usuários de São Paulo para uma página, usuários do Rio de Janeiro para outra. Útil para promoções regionais.
- Device targeting: mandar tráfego mobile para o app, tráfego desktop para o site. Melhora a experiência e a conversão.
- Retargeting pixels: disparar tags do Facebook, Google, LinkedIn e Twitter no momento do clique, antes do redirecionamento. Isso cria públicos personalizados de quem clicou, mesmo sem visitar seu site final.
Links automatizados sem rastreamento são esforço desperdiçado. Configure geo targeting, device targeting e retargeting pixels na criação do link, não depois.
No n8n, crie um workflow paralelo que consulta o endpoint de analytics da API do HitURL diariamente. Esse workflow pode enviar um relatório resumido para seu Slack, Telegram ou e-mail, com métricas como total de cliques, dispositivos mais usados e origem geográfica dos visitantes.
Para mais detalhes sobre como funciona o encurtador integrado ao n8n, confira nosso artigo sobre automação de encurtador de URL com n8n, que cobre configurações avançadas e exemplos de código.
Erros comuns e como evitar
Três problemas aparecem com frequência quando você começa a automatizar links:
1. Esquecer o cabeçalho de autenticação. A API do HitURL exige o token Bearer no header. Sem ele, a requisição retorna erro 401. No n8n, configure o header no node HTTP Request antes de testar o fluxo.
2. Usar alias duplicado. Cada alias (o final personalizado do link, como hiturl.at/promoverrj) deve ser único. Se você tentar criar um link com alias que já existe, a API retorna erro. No n8n, adicione um sufixo dinâmico como timestamp ou ID da linha para evitar colisões.
3. Não tratar erros da API. Se uma URL original estiver fora do ar ou mal formatada, a API vai rejeitar a criação do link. Adicione um node de Error Trigger no n8n para capturar falhas e notificar você, em vez de deixar o fluxo quebrar silenciosamente.
FAQ
A API do HitURL é gratuita?
Sim, o plano gratuito do HitURL inclui acesso à API. Você pode criar links curtos, gerar QR codes dinâmicos e configurar rastreamento sem pagar. Planos pagos oferecem limites maiores de requisições e recursos avançados como domínios personalizados.
Preciso saber programar para usar o n8n com a API?
Não. O n8n é visual e usa nodes pré-configurados. Para a API do HitURL, você usa o node HTTP Request, que é preenchido com URL, headers e body em formato visual. Conhecimento básico de JSON ajuda, mas não é obrigatório para começar.
Quantos links posso encurtar por dia via API?
Depende do seu plano. O plano gratuito tem um limite diário que cobre a maioria dos casos de uso pessoal e de pequenas empresas. Planos pagos aumentam esse limite conforme a necessidade do seu negócio.
Posso integrar a API do HitURL com outras ferramentas além do n8n?
Sim. A API é REST padrão, então funciona com qualquer ferramenta que faça requisições HTTP: Zapier, Make (Integromat), Power Automate, scripts em Python, Node.js, PHP, ou qualquer linguagem de programação.
Como funciona o retargeting pixel em links curtos?
Quando alguém clica no seu link curto, o HitURL carrega o pixel de retargeting (do Facebook, Google, etc.) antes de redirecionar para o destino final. Isso permite criar públicos personalizados de pessoas que clicaram no link, mesmo sem elas visitarem diretamente seu site.
Próximos passos
Automação de links deixa de ser um luxo quando você envia dezenas de URLs por dia. Com n8n e a API do HitURL, você transforma um processo repetitivo em um workflow que roda sozinho, rastreia cada clique e gera dados que melhoram suas campanhas de marketing.
Comece pelo Método de 3 Estágios: configure a entrada de dados, processe com a API do HitURL e distribua para seus canais. Em uma hora você tem um fluxo funcional. Em uma semana, você não imagina mais como trabalhava sem ele.
Veja como o HitURL rastreia cada clique, dispara seus pixels e gera QR codes. Crie sua conta gratuita em hiturl.at.
