Importe links em massa de um arquivo CSV

Você pode importar seus links existentes para o CodeQR pela importação de CSV. É útil quando você tem uma lista grande de links para importar ou quer migrar links de outro provedor.

Passo 1: prepare seu arquivo CSV

Antes de enviar, confirme que seu arquivo CSV está formatado corretamente. Ele deve ter as seguintes colunas:

LINK — Obrigatória: Sim · Descrição: A URL de destino do link que você quer importar. · Exemplo: https://example.com
KEY — Obrigatória: Não · Descrição: Chave ou slug do link curto. Deixe vazio para gerar automaticamente. · Exemplo: meu-slug
TITLE — Obrigatória: Não · Descrição: Título da visualização de link personalizado. · Exemplo: Título da minha página
DESCRIPTION — Obrigatória: Não · Descrição: Descrição da visualização de link personalizado. · Exemplo: Uma breve descrição
PASSWORD — Obrigatória: Não · Descrição: Senha para proteger o link. · Exemplo: secret123
EXPIRES_AT — Obrigatória: Não · Descrição: Data de expiração do link, no formato YYYY-MM-DD ou DD/MM/YYYY. · Exemplo: 2026-12-31
TRACK_CONVERSION — Obrigatória: Não · Descrição: Ativa o rastreamento de conversões. · Exemplo: true
TAG_IDS — Obrigatória: Não · Descrição: IDs de tags separados por vírgula para atribuir ao link. · Exemplo: cml8w8bsy00003b6tb9f87f5e

Observações sobre o formato do CSV

Os nomes das colunas podem ser personalizados — você faz o mapeamento durante a importação
Use ponto e vírgula (;) ou vírgula (,) como delimitador — os dois são aceitos e detectados automaticamente
Coloque os valores entre aspas se eles contiverem caracteres especiais
Deixe as colunas opcionais vazias quando não precisar delas
Os valores booleanos aceitam: true, false, yes, no, sim, não, 1, 0

Arquivo CSV de exemplo

Veja um exemplo de arquivo CSV formatado corretamente:

LINK,KEY,TITLE,DESCRIPTION,PASSWORD,EXPIRES_AT,TRACK_CONVERSION,TAG_IDS
https://example.com/page1,meu-link,Minha Página,Uma boa landing page,,,true,
https://example.com/page2,,Segunda Página,Outra descrição,secret123,2026-12-31,false,
https://example.com/page3,promo,,,,,no,

Você também pode baixar um CSV de exemplo direto na janela de importação.

Passo 2: abra a janela de importação

Na sua lista de Links, clique na seta ao lado do botão Adicionar Link e escolha Importar do CSV.

Menu ao lado do botão Adicionar Link com a opção Importar do CSV

Passo 3: envie seu arquivo CSV

A janela Importar arquivo CSV abre com uma área de envio de arquivo. Você pode:

Clicar na área de envio e escolher seu arquivo CSV, ou
Arrastar e soltar seu arquivo CSV na área de envio

Atenção: o tamanho máximo do arquivo é 2 MB. Somente arquivos .csv são aceitos.

Área de envio de arquivo da janela de importação de CSV

Você também pode clicar em Baixar CSV de exemplo para obter um arquivo modelo no formato correto.

Passo 4: mapeie suas colunas

Depois do envio, o CodeQR detecta as colunas do seu arquivo CSV e tenta mapeá-las para os campos correspondentes. Cada linha do mapeamento tem uma lista com as colunas do seu arquivo à esquerda e o campo de destino à direita; os campos obrigatórios aparecem marcados com um asterisco. Revise e ajuste o que for preciso.

Mapeamento das colunas do CSV para os campos do link

Mapeamento obrigatório

Destination URL (obrigatório): escolha a coluna que contém as suas URLs de destino

Recursos opcionais

Você pode ativar recursos adicionais nas chaves das seções:

Custom Link Preview: mapeie as colunas de título e descrição da visualização de link personalizado
Password Protection: mapeie uma coluna de senha para proteger os links
Link Expiration: mapeie uma coluna com a data de expiração
Conversion Tracking: mapeie uma coluna para ligar ou desligar o rastreamento de conversões por link
Tags: mapeie uma coluna com os IDs das tags

Os nomes dos campos de destino e das seções opcionais aparecem em inglês na janela de importação, mesmo com o app em português.

Selecionar domínio

Escolha o domínio dos links importados na lista Selecionar domínio. Todos os links serão criados nesse domínio.

Depois de revisar os mapeamentos, clique em Confirm import.

Passo 5: revise o resumo da importação

Na sequência, a janela mostra um resumo com o domínio escolhido e quantos links estão prontos para importar. Ali você pode:

Clicar em Iniciar importação para começar a importação
Clicar em Excluir para cancelar e começar de novo

Resumo da importação com os links prontos, o botão Excluir e o botão Iniciar importação

Passo 6: veja seus links importados

Ao iniciar a importação, você volta para a sua lista de Links. Os itens entram em uma fila de importação e são processados em segundo plano — você pode sair da página com segurança, e o CodeQR envia um e-mail quando os links terminarem de ser importados.

Lista de Links com os links recém-importados

Resolução de problemas

Erros de validação comuns

Se o seu CSV tiver dados inválidos, você verá os erros de validação antes de a importação seguir, com a linha e o campo de cada problema. Os mais comuns são:

URL inválida: confirme que todas as URLs de destino são válidas e começam com http:// ou https://
Valor booleano inválido: use true, false, yes, no, sim, não, 1 ou 0 nos campos booleanos
Formato de data inválido: use o formato YYYY-MM-DD ou DD/MM/YYYY nas datas

Dicas para importar sem erro

Teste primeiro com um arquivo pequeno: comece com alguns links para conferir se o seu formato está correto
Confira os caracteres especiais: coloque entre aspas duplas os valores que contêm vírgulas ou aspas
Verifique as URLs: garanta que todas as URLs de destino estão completas e válidas
Use uma formatação consistente: mantenha o mesmo padrão de datas e de valores booleanos em todo o arquivo