Crachás, cartões de mesa, etiquetas de prateleira e etiquetas de produto precisam cada um do seu QR code, e fazer centenas à mão não é opção. A importação em massa do Posty5 transforma um arquivo CSV em QR codes, verifica cada linha antes de criar qualquer coisa e monta um ZIP com uma imagem PNG por linha, nomeada do jeito que a sua gráfica precisa.
- Abra o Bulk import — Abra o QR Code Generator no painel do Posty5 e escolha Bulk import.
- Preencha o modelo — Baixe o modelo CSV e preencha uma linha por QR code, com fileName definido como o nome que cada imagem precisa ter.
- Envie e verifique — Envie o arquivo, escolha o modelo padrão e o tamanho da imagem e verifique. O Posty5 lista cada linha com falha antes de criar qualquer coisa.
- Gere os códigos — Inicie a importação e acompanhe o progresso, ou saia da página e espere a notificação.
- Baixe o ZIP — Baixe o ZIP de imagens PNG e o arquivo de resultados.
Antes de começar
Você precisa estar conectado a uma conta Posty5. Abra o QR Code Generator no painel e escolha Bulk import. A geraçã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 tem a linha de cabeçalho e uma linha de exemplo.
Monte o arquivo CSV
Toda linha pode ter estas colunas. Os nomes das colunas não diferenciam maiúsculas de minúsculas.
type | O que o código contém. Se ficar vazio, é url. |
name | Um nome para a sua própria lista. |
customId | Seu próprio final para o link do código, quando o seu plano permite finais personalizados. Ele não pode estar em uso, nem mesmo por uma linha anterior. |
tag | Uma tag para agrupar e filtrar os códigos depois. |
refId | Sua própria referência, por exemplo um código de produto ou de participante. |
templateId | O modelo de design desta linha. Ele substitui o padrão que você escolher. |
fileName | O nome da imagem dentro do ZIP. Se ficar vazio, é usado o nome do código. |
Depois, adicione as colunas do tipo da linha:
url | url |
freeText | text |
email | email, subject, body |
wifi | ssid, security, password |
call | phoneNumber |
sms | phoneNumber, message |
geolocation | latitude, longitude, mapUrl |
Salve o arquivo como CSV UTF-8, separado por vírgulas e com linha de cabeçalho. Um QR code do tipo arquivo não pode ser criado em massa, porque cada arquivo precisa do seu próprio envio.
Iniciar uma importação de QR em massaEnvie, escolha o tamanho da imagem e verifique
Depois do envio, escolha o modelo, a tag e o ref ID padrão, além do tamanho da imagem: 512, 1.024 ou 2.000 pixels. As imagens são PNG. Em seguida verifique o arquivo: o Posty5 lê cada linha sem criar nada e lista cada linha com falha pelo número e pelo motivo — um valor ausente ou inválido para o tipo da linha, um valor longo demais, um final personalizado já usado ou não permitido no seu plano, ou um modelo que não é seu.
Gere os códigos
Inicie a importação. Ela roda em segundo plano e mostra quantas linhas foram processadas, criadas e com falha; você pode sair da página, e uma notificação avisa quando terminar.
Você pode cancelar uma importação em andamento. Os códigos criados antes do cancelamento continuam na sua conta.
- 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, essa linha e todas as seguintes falham, e os códigos já criados permanecem.
Baixe o ZIP e os resultados
Quando a importação terminar, baixe o ZIP de imagens, o arquivo de resultados (uma linha por linha, com o status e os dados do novo código) e, se alguma linha falhou, o arquivo de erros com essas linhas como você as escreveu.
Os nomes das imagens são ajustados para funcionar em qualquer sistema e encurtados para 100 caracteres. Duas linhas com o mesmo nome recebem -2, -3 e assim por diante, e um nome sem letras utilizáveis vira qr- seguido do número da linha.
Um link de download vale por 15 minutos; abra a importação de novo nas suas importações anteriores para obter outro. Os arquivos enviados e de resultados ficam guardados por 7 dias e o registro de uma importação por 30 dias.
Seus códigos depois da importação
Cada linha vira um QR code normal na sua lista de QR codes. Você pode abri-lo, editá-lo e baixá-lo de novo como um código criado à mão.
Na lista de QR codes, Export CSV e Export JSON baixam seus códigos, seguindo os filtros da lista, até 50.000 linhas por arquivo. Senhas de Wi-Fi nunca entram em uma exportação.
Um QR code estático guarda o conteúdo diretamente, então a leitura dele nunca passa pelo Posty5 e nenhuma leitura é contada. Só os códigos que apontam para um endereço do Posty5 podem contar leituras.
Fazendo isso por código
Desenvolvedores podem enviar as mesmas linhas em CSV ou JSON como um job pela API do Posty5 (POST /api/link-bulk-jobs) com uma chave de API e consultá-lo até o ZIP ficar pronto. Valem as mesmas verificações e limites. As rotas estão documentadas na referência da API.
Perguntas frequentes
Quantos QR codes posso gerar 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.
Quais tipos de QR funcionam em massa?
URL, texto livre, e-mail, Wi-Fi, chamada telefônica, SMS e geolocalização. Códigos de arquivo não podem ser criados em massa.
Posso editar um QR code criado em massa?
Sim. Cada linha vira um QR code normal na sua lista, que você pode abrir, editar e baixar de novo.
Vou ver as leituras desses códigos?
Só nos códigos que apontam para um endereço do Posty5. Um código estático guarda o conteúdo diretamente, então as leituras dele nunca chegam ao Posty5.
Por quanto tempo o ZIP fica disponível?
Cada link de download vale por 15 minutos, e os arquivos ficam guardados por 7 dias; abra a importação de novo para obter um link novo.
