O carregador lê duas colunas do arquivo: o endereço e o apelido que você quiser. Todo o resto — grupo, etiquetas, parâmetros UTM — é definido uma única vez para o lote inteiro no formulário, e não linha por linha.

Essa é a informação que vale saber antes de montar o arquivo. Dela saem o formato, os limites e metade dos motivos pelos quais algumas linhas depois caem.

A seguir: como montar um arquivo que passa por inteiro, o que fazer quando cada link precisa de parâmetros diferentes, quantas linhas vão de uma vez e como ler o relatório quando parte dos links não é criada.

Que arquivo o carregador aceita

Serve um CSV ou um arquivo de texto comum. A leitura é tolerante, e alguns detalhes poupam trabalho.

O separador é detectado sozinho. O carregador olha a primeira linha e escolhe, entre vírgula, ponto e vírgula e tabulação, o que aparece mais vezes. Isso importa porque o Excel em português salva CSV com ponto e vírgula, e esse arquivo não precisa ser refeito. Uma exportação do Google Planilhas com vírgulas funciona igual, e também uma coluna copiada direto da planilha, que chega separada por tabulações.

A linha de cabeçalho é opcional. Se a primeira linha começa com url, alias ou link, ela é tratada como cabeçalho e fica fora do lote. Sem cabeçalho, a primeira coluna é o endereço e a segunda o apelido.

Uma única coluna está bem. Uma lista de endereços, um por linha, sem separador algum, é aceita como está.

url;alias
https://example.com/catalogo/promocao/sapatos-2026;sapatos
https://example.com/catalogo/promocao/bolsas-2026;bolsas
https://example.com/catalogo/promocao/casacos-2026

Um endereço com vírgula dentro precisa ficar entre aspas. É o comportamento normal do CSV, mas é justamente onde as exportações com parâmetros tropeçam:

"https://example.com/busca?tags=promocao,novo";promocao-novo

Sem as aspas a linha se quebra nessa vírgula e um trecho do endereço vai para o apelido. Uma aspa duplicada dentro de um valor ("") significa uma aspa literal — de novo, CSV padrão.

Linhas vazias são ignoradas, então não é preciso limpar as quebras de linha do fim do arquivo.

Os apelidos podem ficar vazios de forma seletiva: o terceiro link do exemplo não tem nenhum, e um código será gerado para ele. Misturar linhas com e sem apelido é permitido.

Grupo, etiquetas e parâmetros UTM se aplicam ao lote inteiro de uma vez. Confortável quando você sobe um catálogo ou um envio; vira limitação no momento em que a lista abrange várias campanhas.

Dois contornos que funcionam.

Escrever os parâmetros dentro dos próprios endereços. As etiquetas UTM são parâmetros de consulta comuns, portanto podem variar por linha se você as acrescentar nos endereços:

url
https://example.com/a?utm_source=newsletter&utm_campaign=junho
https://example.com/b?utm_source=telegram&utm_campaign=junho

Montar essa coluna na planilha é uma fórmula de concatenação. Se você não tem certeza de quais parâmetros usar e em que formato, há uma análise separada sobre parâmetros UTM.

Dividir em vários lotes. Um lote por campanha: cada um com suas etiquetas e seu grupo, e depois você lê as estatísticas por grupo em vez de destrinchar uma lista longa. Esse caminho costuma ficar mais limpo quando as campanhas são poucas.

São três limites, e de naturezas diferentes.

Quantos
Linhas em um carregamento 1000
Carregamentos simultâneos 3
Links em uma requisição à API 100

Se o arquivo tem mais de mil linhas, divida-o: as linhas acima do limite simplesmente não entram no carregamento. Três carregamentos simultâneos é um teto para trabalhos inacabados, não uma cota diária — assim que um termina, você pode iniciar o próximo.

O volume mensal é outro assunto e depende do plano. No plano gratuito o encurtamento em massa não existe. O Pro permite 100 links por mês, o suficiente para testar numa lista real e descobrir se o volume é necessário. O Premium não tem teto mensal, mas vale um limite diário de 30 000 links.

Por que parte das linhas não é criada

Uma linha ruim não cancela o lote. O carregamento vai até o fim e cada linha carrega o próprio resultado. São três estados, e distingui-los é útil porque se resolvem de maneiras diferentes.

Rejeitada na validação. A linha não passou nas verificações, e isso aparece logo depois da leitura do arquivo, antes de qualquer encurtamento. Em geral um endereço malformado, um apelido longo demais ou lixo onde deveria haver uma URL.

Não criada. A linha estava correta, mas o link não saiu — por exemplo, o apelido pedido já estava ocupado.

Criada. Pronto; o link curto está ao lado da linha.

Causas típicas e o que fazer com elas:

O que se vê Qual é o problema O que fazer
Linha rejeitada, endereço parece normal falta o esquema — example.com em vez de https://example.com acrescentar https:// com uma fórmula na coluna toda
Uma linha a cada duas é rejeitada endereços com vírgulas não foram colocados entre aspas pôr aspas nos valores ou salvar o arquivo com ponto e vírgula
No apelido apareceu um trecho do link mesma causa: a linha se quebrou no separador o mesmo
Apelido cortado apelido maior que o permitido encurtar para 10 caracteres
Não criada, apelido ocupado esse código já existe trocar o apelido ou deixar o campo vazio
Carregaram menos linhas do que o arquivo tem o arquivo passa de 1000 linhas dividir o arquivo

Um hábito que compensa: passe primeiro as dez primeiras linhas do arquivo. Um problema sistemático da exportação — esquema errado, separador errado, uma coluna sobrando — se manifesta em dez linhas igual a mil, e se desenrola muito mais rápido.

Se a lista é produzida por um programa

Quando os links são preparados pelo seu código, e não por uma pessoa com uma planilha, existe um método em lote na API: até 100 links em uma requisição, com resposta item por item e a mesma divisão entre criados, não criados e rejeitados.

Há aqui um detalhe pouco evidente em que é fácil se enroscar. Um lote gasta limite de requisições por link, e não como uma requisição só. Um lote de 100 links desconta 100 unidades. Caso contrário, o método em lote viraria uma forma de driblar o limite de frequência, e um cliente poderia criar milhares de links por minuto. Se o limite restante não cobre o lote inteiro, a requisição é rejeitada por completo e nada é criado — então o resto se confere antes de enviar, não depois.

Os parâmetros comuns funcionam como no formulário: o bloco defaults é mesclado em cada linha, e os campos da própria linha o sobrescrevem. Um valor vazio na linha significa "não informado", logo o valor vem de defaults, exatamente como uma célula vazia numa exportação. O endpoint e o esquema da resposta estão descritos na documentação da API.

O que fazer com a lista pronta

Os links curtos de um lote não se diferenciam dos criados um a um: cada um tem sua estatística de cliques, sua geografia e suas fontes. Se você atribuiu um grupo comum ao lote, ler a estatística por esse grupo fica cômodo — mostra como o catálogo inteiro ou o envio inteiro se comportou como um conjunto.

Dois passos que se pagam justamente em listas grandes:

  • seu próprio domínio. Num lote de mil links o nome do domínio cruza com o leitor mil vezes, e isso é uma parte visível de como um envio se apresenta. Como conectar e o que muda está no artigo sobre domínios personalizados;
  • marcar antes de subir, não depois. Mudar os parâmetros UTM de mil links já criados custa mais do que montar antes uma coluna marcada na planilha.

Em resumo

Monte um arquivo de uma ou duas colunas, com os endereços levando o esquema https:// e os valores com vírgulas entre aspas. Defina os parâmetros comuns no lote; os que variam, escreva nos próprios endereços ou espalhe por vários carregamentos. Teste em dez linhas, depois suba o resto e leia o relatório linha por linha.

A seção em si e a ordem passo a passo estão na página do encurtador de links em massa; o carregamento em massa está disponível nos planos pagos, então o primeiro lote exige uma conta Pro ou superior.