Criar links curtos um por um deixa de funcionar quando a planilha de uma campanha ou um catálogo de produtos tem centenas de linhas. A importação em massa do Posty5 recebe um arquivo CSV, verifica cada linha antes de criar qualquer coisa, cria os links em segundo plano e entrega um arquivo de resultados com cada endereço curto ao lado da linha de origem.
- Abra o Bulk import — Abra o URL Shortener no painel do Posty5 e escolha Bulk import.
- Preencha o modelo — Baixe o modelo CSV e preencha uma linha por URL de destino; só a coluna url é obrigatória.
- Envie e verifique — Envie o arquivo, escolha os valores padrão para as colunas vazias e verifique. O Posty5 lista cada linha com falha antes de criar qualquer coisa.
- Execute a importação — Inicie a importação e acompanhe o progresso, ou saia da página e espere a notificação.
- Baixe os resultados — Baixe o arquivo de resultados com cada endereço curto e o arquivo de erros, se alguma linha falhou.
Antes de começar
Você precisa estar conectado a uma conta Posty5. Abra o URL Shortener no painel e escolha Bulk import. A criação em massa depende do seu plano: se o seu plano não a inclui, a página a mostra como bloqueada.
Comece pelo modelo CSV que a página oferece. Ele já tem a linha de cabeçalho correta e uma linha de exemplo, então basta substituir o exemplo pelos seus dados.
Prepare o arquivo CSV
Só a coluna url é obrigatória. Os nomes das colunas não diferenciam maiúsculas de minúsculas, e uma coluna que o Posty5 não reconhece é ignorada e informada na etapa de verificação.
url | O endereço de destino. Obrigatório. baseUrl também é aceito como nome alternativo. |
name | Um nome para a sua própria lista. Se ficar vazio, o Posty5 o preenche em segundo plano a partir da página de destino. |
customId | Seu próprio final para o link curto, quando o seu plano permite finais personalizados. Ele não pode estar em uso, nem mesmo por uma linha anterior do mesmo arquivo. |
tag | Uma tag para agrupar e filtrar os links depois. |
refId | Sua própria referência, por exemplo um código de produto do seu sistema. |
templateId | O modelo de QR code desta linha. Ele substitui o padrão escolhido na etapa de envio. |
Salve o arquivo como CSV UTF-8, separado por vírgulas e com linha de cabeçalho. Valores que contêm vírgulas vão entre aspas duplas, o que os aplicativos de planilha já fazem sozinhos ao exportar CSV.
Iniciar uma importação em massaEnvie e verifique o arquivo
Depois do envio, escolha os valores padrão para as linhas que deixam uma coluna vazia (modelo, tag e ref ID) e verifique o arquivo. O Posty5 lê cada linha sem criar nada e lista cada linha com falha pelo número, contando a partir da primeira linha abaixo do cabeçalho. Uma linha falha quando:
- a URL está ausente, não é um endereço web válido ou tem mais de 2.048 caracteres
- a URL é bloqueada como insegura, exatamente como aconteceria com um link avulso
- um nome, tag ou referência tem mais de 255 caracteres
- o final personalizado não é permitido no seu plano, é inválido ou já está em uso
- o modelo não existe ou não é seu
Execute a importação
Inicie a importação quando a verificação estiver certa. Ela roda em segundo plano: a página mostra quantas linhas foram processadas, criadas e com falha, e você pode sair dela — uma notificação avisa quando a importação terminar.
Você pode cancelar uma importação em andamento. Os links criados antes do cancelamento continuam na sua conta.
Os títulos das páginas e os deep links de apps são buscados depois que cada link é criado, então um link novo pode exibir o nome do host como nome por alguns instantes.
- Um arquivo comporta até 5.000 linhas e 2 MB.
- É possível criar em massa até 20.000 linhas por conta por dia (UTC), somando todas as importações e chamadas de API.
- Uma importação roda por vez, e até três outras podem aguardar na fila.
- Se a sua conta ficar sem créditos durante uma importação, essa linha e todas as seguintes falham, e os links já criados permanecem.
Baixe os resultados
Quando a importação terminar, baixe o arquivo de resultados. Ele tem uma linha para cada linha do seu arquivo: o número da linha, o status (criada, com falha, ignorada ou não processada quando a importação parou antes de chegar a ela), o ID e o endereço curto do novo link e o motivo quando uma linha falhou.
Um segundo arquivo traz só as linhas com falha, com os seus valores originais, para você corrigi-las e enviar esse arquivo de novo.
As importações anteriores ficam listadas com status e contagens, para você abrir uma delas depois e baixar os arquivos novamente. Os arquivos enviados e de resultados ficam guardados por 7 dias e o registro de uma importação por 30 dias — baixe o que precisar antes disso. Os links em si nunca são removidos.
Exporte seus links depois
- Na lista de links curtos, escolha Export CSV ou Export JSON para baixar seus links com os contadores de visitas.
- A exportação segue os filtros aplicados à lista, então filtre por tag antes para exportar uma única campanha.
- Uma exportação comporta até 50.000 linhas, das mais recentes para as mais antigas; uma lista maior é cortada nesse ponto e o arquivo avisa isso.
- Uma célula CSV que começa com =, +, - ou @ recebe um apóstrofo no início, para que o aplicativo de planilha a mostre como texto em vez de executá-la como fórmula.
Fazendo isso por código
Desenvolvedores podem fazer o mesmo pela API do Posty5 com uma chave de API: POST /api/short-link/bulk cria até 100 linhas em uma requisição e retorna um resultado por linha, e POST /api/link-bulk-jobs envia um arquivo inteiro como um job que você pode consultar. Os dois usam as mesmas verificações e limites do painel. As rotas estão documentadas na referência da API.
Perguntas frequentes
Quantas URLs posso importar de uma vez?
Um arquivo comporta até 5.000 linhas e 2 MB, e é possível criar em massa até 20.000 linhas por conta por dia.
O que acontece com uma linha que tem uma URL ruim?
A etapa de verificação a lista com o número da linha e o motivo antes de qualquer criação. Durante a importação, uma linha com falha nunca interrompe as demais.
Posso escolher meus próprios finais curtos?
Sim, na coluna customId, quando o seu plano permite finais personalizados. Cada final não pode estar em uso, nem mesmo por uma linha anterior do mesmo arquivo.
Por quanto tempo posso baixar os resultados?
Os arquivos enviados e de resultados ficam guardados por 7 dias. Os links em si continuam na sua conta.
Posso exportar meus links curtos?
Sim. A lista de links curtos exporta CSV ou JSON com os contadores de visitas de cada link, seguindo os filtros da lista, até 50.000 linhas por arquivo.
