Importar links em massa de um CSV

Se você tem uma planilha de URLs de destino que quer encurtar de uma vez — migrando de outra ferramenta, lançando uma campanha, ou preenchendo um novo workspace — o importador em massa é o caminho certo. Ele pré-visualiza erros antes que qualquer coisa seja confirmada, para que você possa corrigir problemas sem importações parciais.

Formato CSV#

O importador espera um arquivo separado por vírgulas com uma linha de cabeçalho. A única coluna obrigatória é destination. Todo o resto é opcional.

destination,slug,title,tags
https://acme.com/spring-sale,spring-2026,Spring Sale 2026,campaign:spring
https://acme.com/about,,About Us,
https://acme.com/contact,contact-us,,support:contact

Regras das colunas:

• destination (obrigatória) — a URL completa incluindo https://. URLs sem esquema são rejeitadas.
• slug (opcional) — um slug curto personalizado. Apenas letras, números e hífens. Se em branco, geramos um código aleatório de 6 caracteres.
• title (opcional) — um rótulo legível exibido na lista de links.
• tags (opcional) — uma ou mais tags separadas por dois pontos ou ponto e vírgula. As tags são criadas automaticamente se não existirem.

A ordem das colunas não importa desde que os nomes do cabeçalho correspondam. Colunas extras são ignoradas.

Iniciar uma importação#

1. Vá para Tools → Bulk import (ou clique no botão de importação em Links).
2. Faça upload do seu arquivo CSV. O importador o analisa e mostra uma tabela de pré-visualização.
3. Revise a pré-visualização. Qualquer linha com erro está destacada — passe o cursor sobre o ícone de erro para ver o que está errado.
4. Clique em Import para gravar as linhas válidas. Linhas com erro são ignoradas.

A importação é executada em segundo plano. Para arquivos grandes, um indicador de progresso mostra quantas linhas foram processadas. Você receberá um email de resumo quando terminar.

O limite de 50.000 links#

Cada execução de importação é limitada a 50.000 linhas. Se o seu arquivo for maior, divida-o em vários arquivos e execute-os sequencialmente. Não há limite diário de execuções de importação.

Deduplicação#

O importador verifica slugs em relação a links existentes. Se o slug de uma linha já existe no workspace:

• A linha é ignorada com um erro ("slug already taken").
• O link existente não é modificado.

Se a coluna de slug estiver em branco, sempre geramos um novo código único, então linhas com slug em branco nunca geram conflitos.

Se você estiver reimportando um arquivo que processou parcialmente antes, o importador é idempotente para linhas com slug em branco (cada execução cria novos links com novos códigos). Para slugs explícitos, apenas linhas com slugs que ainda não existem no workspace terão sucesso.

Erros comuns de importação e correções#

"Invalid URL" — o destino não inclui um esquema (https://) ou contém caracteres inválidos em uma URL. Corrija a célula na sua planilha e faça upload novamente.

"Slug already taken" — existe um link com esse slug. Remova o slug para obter um gerado automaticamente, ou altere para algo único.

"Slug contains invalid characters" — slugs só podem conter letras (a-z, A-Z), números (0-9) e hífens (-). Espaços, underscores e pontos não são permitidos.

"File too large" — o arquivo excede o limite de 50.000 linhas. Divida-o e importe em lotes.

"Destination blocked" — nosso scanner de URL marcou o destino como malicioso ou em uma categoria bloqueada. Se acredita que isso é um falso positivo, contate o suporte com a URL.

Solução de problemas#

Minha importação terminou mas algumas linhas estão faltando. Baixe o relatório de importação — um link aparece no resumo de importação. O relatório mostra quais linhas foram ignoradas e por quê. A maioria dos pulos são slugs duplicados ou URLs inválidas.

O importador diz que o arquivo está malformado. Certifique-se de que o arquivo é realmente CSV (não TSV ou Excel .xlsx). Abra-o em um editor de texto e confirme que vírgulas são o delimitador e que a linha de cabeçalho está presente.

A importação está presa em "processing". Importações grandes (dezenas de milhares de linhas) podem levar alguns minutos. Atualize a página para verificar o status atual. Se ainda estiver presa após 10 minutos, contate o suporte com o ID de importação mostrado na URL.