Importar links de um CSV #

Está saindo de outro encurtador de links ou guarda seus links em uma planilha? Você pode levá-los para o Revolink de uma só vez enviando um arquivo. O Revolink lê o arquivo, confere cada linha, mostra todos os links antes de criar qualquer coisa e depois importa os que você deixar selecionados.

Este guia cobre: preparar o arquivo, o assistente de importação passo a passo, regras de redirecionamento e testes A/B no arquivo, domínios e DNS, duplicados e como resolver cada mensagem de erro que você pode encontrar.

Nesta página

• Antes de começar
• Arquivos e serviços aceitos
• Opção 1: use o modelo do Revolink · Campos · Regras e testes A/B · Datas · Tags
• Opção 2: envie uma exportação de outro serviço
• Executar a importação passo a passo
• Um mesmo valor para todos os links
• Domínios e DNS
• Duplicados e links curtos já ocupados
• Limites
• Erros e como resolvê-los
• Usar um assistente de IA para preparar o arquivo

Antes de começar #

• Permissão. Importar exige a permissão Importar links. O proprietário do espaço de trabalho sempre a tem; os outros membros a recebem do proprietário por meio da função.
• Um de cada vez. Só uma importação pode ser executada por vez em um espaço de trabalho.
• Limites do arquivo. Até 5.000 linhas e 20 MB por arquivo. Para uma exportação maior, divida-a em partes e importe uma depois da outra.
• Só uma coisa é obrigatória: uma URL de destino em cada linha. Todo o resto é opcional.

Arquivos e serviços aceitos #

Tipos de arquivo: .csv, .tsv e .json. Arquivos do Excel (.xls, .xlsx) não são aceitos: no Excel, salve antes o arquivo como CSV. Um arquivo .json deve ser uma lista de objetos, um por link.

Serviços que o Revolink reconhece. Para exportações desses serviços as colunas são mapeadas sozinhas, então você pode enviar o arquivo como está:

Qualquer outro arquivo também funciona: você mapeia as colunas por conta própria na etapa Colunas (o Revolink sugere um mapeamento e você pode corrigi-lo).

Opção 1: use o modelo do Revolink #

Se você não está saindo de outro serviço ou está montando a lista à mão, comece pelo modelo.

Baixar o modelo CSV

Você também pode baixá-lo na primeira etapa da importação (Não está saindo de outro serviço? Baixe o modelo CSV do Revolink). O arquivo do modelo contém duas linhas de exemplo preenchidas, uma com regras de redirecionamento e outra com um teste A/B. A linha de cabeçalho dele é:

title,destination_url,short_link,domain,tags,created_at,expiration_date,clicks,rules,ab_test,routing_mode

Uma linha sem regras nem teste A/B fica assim (as três últimas células ficam vazias):

Spring campaign,https://acme.inc/spring-sale?utm_source=email&utm_medium=newsletter&utm_campaign=spring,spring-sale,acme.inc,marketing;email;spring,2026-03-01,2026-12-31,1250,,,

Substitua os exemplos pelos seus próprios links, um link por linha, e mantenha a linha de cabeçalho exatamente como está. Quando os cabeçalhos correspondem ao modelo, o Revolink mapeia as colunas sozinho e você pode passar direto pela etapa Colunas.

Campos #

São os 11 campos que você pode preencher a partir do arquivo. Na etapa Colunas, qualquer coluna do arquivo pode alimentar qualquer campo; no modelo do Revolink as colunas têm os nomes da primeira coluna abaixo.

Regras do link curto.

• Permitido: letras A–Z / a–z, dígitos e hifens. Maiúsculas e minúsculas são diferentes: Promo e promo são dois links distintos.
• Os hifens devem ser simples e ficar entre outros caracteres: spring-sale serve; spring--sale, -spring e spring- não. Sublinhados não são permitidos.
• Espaços no valor são substituídos por hifens.
• Você pode colar um link curto inteiro, como bit.ly/spring ou https://rebrand.ly/promo. O Revolink usa a última parte do caminho como link curto e o host como domínio.

Regras e testes A/B #

Um link importado sem essas colunas recebe uma regra padrão que envia todos os visitantes para destination_url. Para trazer regras de redirecionamento ou um teste A/B, preencha a célula Regras de redirecionamento (rules) ou Teste A/B (ab_test) desse link. As duas são opcionais; deixe a célula vazia nos links que não precisam delas.

Cada uma das duas células contém um texto JSON.

• Ao montar o arquivo à mão, coloque a célula inteira entre aspas duplas e escreva cada " interna duas vezes (""). Os programas de planilha fazem isso por você ao salvar como CSV, mas o JSON digitado em uma célula é mais fácil de conferir em um editor de texto.
• Se escrever JSON não é com você, um assistente de IA pode gerar as células a partir dos dados do seu serviço antigo.
• Se suas colunas não se chamam rules, ab_test e routing_mode, mapeie-as à mão na etapa Colunas.

rules: regras de redirecionamento #

Uma lista JSON de regras, cada uma enviando os visitantes que atendem às suas condições para a própria página.

• Não adicione a regra principal. A regra principal (o destino padrão) é criada a partir de destination_url e é usada para todos que não correspondem a nenhuma regra. Uma regra sem nenhuma condição não pode ser importada.
• As regras são verificadas de cima para baixo, e vence a primeira cujas condições são todas atendidas. Coloque as regras mais específicas primeiro.
• As chaves id e isDefault são ignoradas.
• Dentro de uma regra, todas as condições devem ser atendidas; dentro de uma condição, qualquer um dos valores listados serve. "country":["UA","DE"],"device":["mobile"] significa visitantes de celular da Ucrânia ou da Alemanha.

Os valores de device, os e browser diferenciam maiúsculas de minúsculas: iOS, não ios; mobile, não Mobile.

Um exemplo por condição (JSON como você o veria em um editor de texto, sem as aspas do CSV):

[
  { "name": "Ukraine", "targetUrl": "https://acme.inc/ua", "country": ["UA"] },
  { "name": "DACH", "targetUrl": "https://acme.inc/dach", "country": ["DE", "AT", "CH"] },
  { "name": "California", "targetUrl": "https://acme.inc/us-ca", "country": ["US"], "region": ["California"] },
  { "name": "Kyiv", "targetUrl": "https://acme.inc/kyiv", "country": ["UA"], "city": ["Kyiv"] }
]

[
  { "name": "Phones", "targetUrl": "https://acme.inc/m", "device": ["mobile"] },
  { "name": "Tablets and consoles", "targetUrl": "https://acme.inc/big", "device": ["tablet", "console"] },
  { "name": "Apple mobile", "targetUrl": "https://acme.inc/ios", "os": ["iOS"] },
  { "name": "Desktop Windows or Linux", "targetUrl": "https://acme.inc/pc", "os": ["Windows", "Linux"] },
  { "name": "Safari and Edge", "targetUrl": "https://acme.inc/browsers", "browser": ["Safari", "Edge"] }
]

[
  { "name": "Evenings", "targetUrl": "https://acme.inc/evening", "timeStart": "18:00", "timeEnd": "23:00" },
  { "name": "Weekend", "targetUrl": "https://acme.inc/weekend", "daysOfWeek": [6, 0] },
  { "name": "Friday evenings", "targetUrl": "https://acme.inc/fri", "timeStart": "17:00", "timeEnd": "23:59", "daysOfWeek": [5] }
]

[
  {
    "name": "Germany evenings on Chrome or Safari",
    "targetUrl": "https://acme.inc/de",
    "country": ["DE"],
    "browser": ["Chrome", "Safari"],
    "timeStart": "18:00",
    "timeEnd": "23:00",
    "daysOfWeek": [5, 6, 0]
  },
  { "name": "Ukrainian speakers", "targetUrl": "https://acme.inc/uk", "locale": ["uk"] }
]

As mesmas duas regras do primeiro exemplo, como são escritas na célula do CSV:

"[{""name"":""Ukraine mobile"",""targetUrl"":""https://acme.inc/ua-mobile"",""country"":[""UA""],""device"":[""mobile""]},{""name"":""Germany"",""targetUrl"":""https://acme.inc/de"",""country"":[""DE""]}]"

ab_test: teste dividido #

Uma lista JSON com pelo menos duas variantes. Cada uma tem uma url (um endereço web válido) e um weight (um número positivo). Os pesos devem somar exatamente 100.

[
  { "url": "https://acme.inc/spring-sale-a", "weight": 50 },
  { "url": "https://acme.inc/spring-sale-b", "weight": 50 }
]

Três variantes e partes desiguais:

[
  { "url": "https://acme.inc/a", "weight": 34 },
  { "url": "https://acme.inc/b", "weight": 33 },
  { "url": "https://acme.inc/c", "weight": 33 }
]

Como célula de CSV:

"[{""url"":""https://acme.inc/spring-sale-a"",""weight"":50},{""url"":""https://acme.inc/spring-sale-b"",""weight"":50}]"

O teste é ativado automaticamente quando é o único das duas células preenchido. Mantenha também destination_url preenchido; use o endereço da sua variante principal.

Um arquivo completo com regras, teste A/B e modo de roteamento #

O primeiro link usa as regras, o segundo um teste A/B, o terceiro tem as duas células preenchidas e deixa routing_mode vazio (o assistente vai perguntar), e o quarto não tem nenhuma:

title,destination_url,short_link,domain,tags,created_at,expiration_date,clicks,rules,ab_test,routing_mode
Spring campaign,https://acme.inc/spring,spring,acme.inc,marketing,2026-03-01,2027-12-31,1250,"[{""name"":""Ukraine"",""targetUrl"":""https://acme.inc/ua"",""country"":[""UA""]}]","[{""url"":""https://acme.inc/spring-a"",""weight"":50},{""url"":""https://acme.inc/spring-b"",""weight"":50}]",rules
Summer webinar,https://acme.inc/webinar,webinar,acme.inc,events,2026-05-15,,480,,"[{""url"":""https://acme.inc/webinar-a"",""weight"":70},{""url"":""https://acme.inc/webinar-b"",""weight"":30}]",
Autumn sale,https://acme.inc/autumn,autumn,acme.inc,marketing,,,0,"[{""name"":""Mobile"",""targetUrl"":""https://acme.inc/m"",""device"":[""mobile""]}]","[{""url"":""https://acme.inc/autumn-a"",""weight"":60},{""url"":""https://acme.inc/autumn-b"",""weight"":40}]",
Winter promo,https://acme.inc/winter,winter,acme.inc,,,,,,,

Regras ou teste A/B para um link #

Se um link tem as duas células preenchidas, só uma pode ficar ativa. Diga ao Revolink qual na coluna Modo de roteamento (routing_mode): rules ou ab_test. Maiúsculas, espaços e hifens não importam (AB-Test funciona).

Deixe-a vazia e o Revolink pergunta. Na etapa Links a linha aparece marcada como Escolha um e desmarcada (isso não é um erro). Clique em Usar o teste A/B ou Usar as regras de redirecionamento nessa linha, ou use os botões acima da lista para decidir todas essas linhas de uma vez. Você também pode mudar uma escolha vinda do arquivo (Usar o teste A/B em vez disso / Usar as regras de redirecionamento em vez disso); a sua escolha no assistente prevalece sobre routing_mode. Nada é adivinhado: uma linha que ninguém decidiu não é importada e aparece no arquivo de erros como «Tanto as regras quanto um teste A/B estão preenchidos, e nenhum foi escolhido.»

Nada é descartado: a opção que você não escolheu é salva no link, mas fica inativa. Se você escolheu as regras, as variantes A/B são salvas com o teste desativado, e você pode ativá-lo no editor do link se o seu plano permitir testes A/B. Se você escolheu o teste A/B, as regras são salvas, mas não funcionam enquanto o teste estiver ativado.

routing_mode deve ser rules ou ab_test (veja o erro use "rules" ou "ab_test"). Se apenas uma das duas células estiver preenchida, deixe routing_mode vazio.

Você também pode definir um único modo de roteamento para a importação inteira; veja Um mesmo valor para todos os links.

Limites do plano #

Valem os mesmos limites do plano de quando você cria um link à mão. A regra padrão conta para o limite de regras por link, então no plano Free (2 regras por link) você pode importar 1 regra de roteamento por link, no Starter (10) até 9 e no Pro (50) até 49; Agency e Business não têm limite. Testes A/B exigem o plano Pro ou superior.

Se você importa muitos links, a etapa Plano mostra o que o arquivo precisa: ela conta o maior número de regras em um link (regra padrão incluída) e o maior número de variantes A/B em um link, não o total do arquivo.

Datas #

Os mesmos formatos servem para created_at e expiration_date:

YYYY-MM-DD é o mais seguro. Para valores como 03/04/2026, que podem ser lidos de duas formas, o Revolink decide entre «dia primeiro» e «mês primeiro» olhando o arquivo inteiro e informa qual usou; se estiver errado, use Ajustar colunas ou reescreva as datas como YYYY-MM-DD.

• Uma data de criação que não pode ser lida é ignorada: o link é importado mesmo assim, só que sem ela.
• Uma data de expiração que não é uma data válida torna a linha Inválida («A data de expiração não é uma data válida, então o link não pode ser criado.»).
• Uma data de expiração no passado também torna a linha Inválida: não é possível criar um link com data de expiração que já passou. Essas linhas não são importadas como links expirados. Corrija a data ou apague-a e importe de novo.

Tags #

• Coloque todas as tags de um link em uma célula. Separadores: vírgula, ponto e vírgula, | ou uma quebra de linha.
• Um # inicial é removido, espaços extras são reduzidos e tags repetidas (em qualquer capitalização) são contadas uma vez.
• Uma tag é limitada a 50 caracteres; uma mais longa é cortada.
• Tags que não existem no espaço de trabalho são criadas. O seu plano tem um limite de tags: as que passarem dele não são criadas, os links são importados sem elas e a tela de resultado informa quantas.

Opção 2: envie uma exportação de outro serviço #

Envie a exportação do seu encurtador de links anterior como está, sem precisar reformatá-la. O Revolink reconhece o layout das exportações do Bitly, Short.io, Rebrandly, Dub, TinyURL e t.ly e mapeia as colunas automaticamente.

Para qualquer outro arquivo, o Revolink escolhe o mapeamento nesta ordem:

1. Um layout conhecido. Os nomes dos cabeçalhos correspondem a um serviço acima ou ao modelo do Revolink.
2. Um mapeamento lembrado. Se você já importou um arquivo com os mesmos cabeçalhos, o mapeamento usado é reaproveitado.
3. Uma sugestão de IA para arquivos que ele não conhece.

Seja qual for o escolhido, você pode conferi-lo e alterá-lo na etapa Colunas. Os domínios do serviço antigo (bit.ly etc.) não podem se mudar com os seus links; veja Domínios e DNS.

Executar a importação passo a passo #

Abra Configurações do espaço de trabalho → Importações e clique em Nova importação. O assistente tem estas etapas: Arquivo → Colunas → Domínios → Tags → Links → Plano → DNS → Concluído. Colunas, Links e Concluído sempre aparecem. Domínios, Tags, Plano e DNS só aparecem quando o seu arquivo precisa deles. O botão Voltar em qualquer etapa posterior leva de volta a Colunas.

1. Arquivo. Solte o seu arquivo (ou o modelo) na área de envio. O Revolink verifica o tipo, o tamanho e o número de linhas e mostra o que encontrou. Problemas com o próprio arquivo estão listados em Erros.
2. Colunas. Confira qual coluna do seu arquivo alimenta cada um dos 11 campos (veja Campos). Cada seleção tem uma busca sobre os nomes das suas colunas. Só a URL de destino é obrigatória; um campo definido como Não importar é ignorado. Para Modo de roteamento, Tags, Domínio e Data de expiração você também pode digitar um valor para todos os links; veja Um mesmo valor para todos os links. Ao clicar em Continuar, o Revolink confere por completo cada célula não vazia das colunas Regras de redirecionamento, Teste A/B e Modo de roteamento e mostra todos os problemas de uma vez, uma notificação por problema. Corrija-os no arquivo (ou mude o mapeamento) e envie de novo, ou continue com as linhas que estão corretas. Veja Erros de mapeamento.
3. Domínios. Aparece quando o arquivo usa domínios que não estão configurados no seu espaço de trabalho. Veja Domínios e DNS.
4. Tags. Aparece apenas quando a importação criaria pelo menos uma tag que o seu espaço de trabalho ainda não tem (Como devem ser as suas novas tags?). Escolha uma cor e um ícone para cada tag nova; a lista mostra cada tag nova e quantos dos links selecionados a têm. As tags que você já tem mantêm a aparência e não são listadas. Você pode mudar a aparência depois em Tags. Veja Tags para os limites.
5. Links. Revise a lista. Cada linha está marcada como Pronto, Link curto em uso, Já importado, Escolha um ou Inválido (em vermelho, com o motivo), e você pode pesquisar e filtrar. Desmarque qualquer link que não queira trazer. Use Digite um link para corrigir um destino que não pôde ser lido. Os motivos estão explicados em Erros de linha.
6. Plano. Aparece apenas quando os links selecionados precisam de mais do que o seu plano atual permite (A sua importação precisa do plano …). Um cartão por limite (Links, Domínios personalizados, Tags, Regras por link, Opções de teste A/B) compara o que os links precisam com o seu plano e fica marcado como Cabe ou Não cabe. Escolha Obter … para fazer upgrade ou reduza a necessidade com Voltar à seleção de links, Ajustar a minha seleção ou Alterar domínios. Se escolher Agora não, apenas parte dos links é importada de imediato; o resto espera algumas horas e é importado automaticamente se você fizer o upgrade nesse prazo, depois do qual são descartados.
7. DNS. Aparece quando você mantém domínios personalizados que ainda não foram verificados. Adicione os registros DNS exibidos ali. Veja Domínios e DNS.
8. Concluído. Clique em Importar N links (N é o número que você deixou selecionado) e o Revolink cria os links. Você pode fechar a aba: a importação continua em execução e os links aparecem na sua lista de links. A tela de resultado lista as linhas que não foram importadas; veja Erros.

Você pode salvar uma importação não terminada como rascunho e retomá-la depois em Configurações do espaço de trabalho → Importações. Os valores que você digitou para todos os links também ficam salvos no rascunho.

Um mesmo valor para todos os links #

Às vezes todos os links do arquivo precisam do mesmo valor e não há coluna para ele. Para Modo de roteamento, Tags, Domínio e Data de expiração, você pode digitar esse valor direto na seleção da etapa Colunas:

1. Clique na seleção e digite o valor, por exemplo go.acme.inc.
2. Escolha o item Usar "go.acme.inc" para todos os links.
3. Sob a seleção aparece uma nota amarela: Este valor será aplicado a todos os N links desta importação.

O valor é aparado e depois lido da mesma forma que uma coluna:

Se o valor estiver errado, Continuar mostra O valor "xyz" que você informou para "(nome do campo)" não é válido: (motivo) e nada avança. Motivos: deve ser um nome de domínio, por ex. go.example.com, deve ser uma data, por ex. 2027-01-01, deve ser uma data futura, use "rules" ou "ab_test".

Campos que têm um valor diferente para cada link (URL de destino, Link curto, Título, Cliques anteriores, Data de criação, Regras de redirecionamento e Teste A/B) não podem ser preenchidos dessa forma.

Domínios e DNS #

A coluna domain (ou o valor que você digitou para todos os links) informa ao Revolink em qual domínio cada link curto deve viver.

• Domínio vazio: o link é criado em rvlnk.link.
• Um domínio que você já tem no espaço de trabalho e verificado: o link é criado nesse domínio.
• Um domínio que ainda não está configurado: por padrão, os links vão para rvlnk.link. Na etapa Domínios você pode, em vez disso, manter o domínio ou trocá-lo por outro que você possua. Se mantiver, a etapa DNS mostra o registro a ser adicionado no seu provedor de DNS para que o Revolink possa verificar o domínio. Links em um domínio que ainda está sendo verificado são importados automaticamente assim que a verificação termina.
• O domínio próprio do serviço anterior (por exemplo bit.ly, rebrand.ly, tinyurl.com) não pode se mudar com você, então esses links vão para rvlnk.link ou para um domínio que você possua.

A tela de resultado mostra quantos links foram colocados em rvlnk.link porque o domínio original não estava configurado. Domínios personalizados contam para o limite de domínios do seu plano; a etapa Plano mostra isso.

Duplicados e links curtos já ocupados #

• Já importado. O Revolink lembra quais links vieram de uma importação. Uma linha cujo identificador (domínio + link curto, ou a URL de destino quando não há link curto) já está no espaço de trabalho vindo do mesmo serviço atualiza o link existente em vez de criar uma segunda cópia. Apenas o título e o destino da regra principal são sobrescritos; regras e testes A/B ficam como estão. Desmarque essas linhas se quiser deixar os links como estão.
• Link curto em uso. Se o link curto que você pediu já é usado por outro link nesse domínio, a linha é marcada como Link curto em uso e fica desmarcada. Deixe-a desmarcada para ignorá-la ou selecione de propósito: o link é então criado com um link curto gerado, e o original é mantido nos detalhes de importação do link.
• Duas linhas com o mesmo link curto em um arquivo são tratadas como o mesmo link. Se você quer vários links para a mesma página, dê a cada um um link curto diferente.

Limites #

Erros e como resolvê-los #

Os problemas são detectados em três lugares: ao soltar o arquivo, ao clicar em Continuar na etapa Colunas e na etapa Links, onde uma linha ruim fica em vermelho com o motivo. O que ainda não foi importado no fim é listado na tela de resultado em Linhas que não foram importadas. Clique em Baixar erros (CSV) para salvar a lista. O arquivo tem duas colunas:

Corrija essas linhas no seu arquivo e importe de novo. Links que já existem são atualizados, não duplicados, então é seguro reenviar o arquivo inteiro. As mensagens são exibidas no idioma da sua interface; as tabelas abaixo usam o texto em português como o aplicativo o mostra.

Erros de arquivo #

Erros de mapeamento #

Exibidos na etapa Colunas depois de Continuar, uma notificação por problema, todas de uma vez. A forma delas é:

A coluna "X" não pode ser usada para "Regras de redirecionamento / Teste A/B / Modo de roteamento" (linha N): motivo

As notificações de Regras de redirecionamento e Teste A/B terminam com um link Veja o guia de importação que leva a Regras e testes A/B. O número da linha é a linha do seu arquivo, com a primeira linha de dados como 1.

Motivos para qualquer uma das duas colunas (Regras de redirecionamento, Teste A/B):

Modo de roteamento:

Teste A/B:

Regras de redirecionamento (regra N é a posição na lista, começando em 1):

Outras notificações da etapa Colunas:

Erros de linha #

Na etapa Links, uma linha ruim fica em vermelho (Inválido) com um destes motivos, e o mesmo texto vai para o arquivo de erros.

Outros motivos pelos quais um link pode não ser criado: o limite de links do plano foi atingido (os links restantes esperam por um tempo limitado; faça o upgrade nessa janela e eles são importados automaticamente), ou uma regra ou teste A/B ultrapassa o que o seu plano permite.

Usar um assistente de IA para preparar o arquivo #

Se você tem uma exportação em um formato incomum, um assistente de IA pode convertê-la para o modelo por você. Dê a ele as instruções de import-csv-agent-instructions.md (em inglês) junto com a sua exportação e depois envie o arquivo que ele gerar.