Skip to content

Concessões em massa

As concessões em massa permitem emitir distintivos para centenas ou milhares de destinatários de uma vez enviando um arquivo CSV. O processo tem quatro etapas, com acompanhamento de progresso integrado, pausa/retomada e tratamento de erros.

Visão geral

O processo de concessões em massa segue quatro etapas:

  1. Configurar — escolha o distintivo e as opções
  2. Enviar — prepare e envie seu arquivo CSV
  3. Processar — acompanhe o progresso enquanto as concessões são criadas
  4. Resultados — revise os resultados e baixe os relatórios

Etapa 1: Configurar

Concessões em massa — etapa 1, configurar

  1. Abra a página Concessões na barra lateral.
  2. Clique em Concessão em massa.
  3. Escolha o distintivo que deseja conceder usando o seletor.
  4. Configure opcionalmente:
    • Data de emissão — data usada para todas as concessões (padrão: hoje)
    • Expira — data de expiração opcional para todas as concessões
    • Enviar e-mail — se um e-mail será enviado automaticamente a cada destinatário ao criar sua concessão
  5. Clique em Avançar.

Etapa 2: Enviar CSV

Concessões em massa — etapa 2, envio

Formato do CSV

O arquivo CSV deve ter duas colunas: name e email. A primeira linha deve ser o cabeçalho.

csv
name,email
Jane Smith,jane@example.com
John Doe,john@example.com
Maria Garcia,maria@example.com

Baixar modelo

Clique em Baixar modelo para obter um CSV em branco com os cabeçalhos corretos. Preencha-o com seus destinatários e envie.

Envio

  1. Clique em Enviar CSV ou arraste e solte seu arquivo.
  2. O arquivo é validado antes do início do processamento.

Regras de validação

Cada linha é validada:

  • Nome deve ter pelo menos 5 caracteres
  • E-mail deve ser um endereço válido
  • E-mails duplicados no arquivo são sinalizados
  • Linhas vazias são ignoradas

Se houver erros de validação, eles serão exibidos com os números das linhas. Corrija os problemas no CSV e envie novamente.

  1. Clique em Avançar para iniciar o processamento.

Etapa 3: Processamento

Assim que o processamento começa, você vê uma barra de progresso e o status ao vivo:

  • Barra de progresso — mostra o percentual de linhas processadas
  • Linha atual — qual linha está sendo processada
  • Contagem de sucessos — quantas concessões foram criadas
  • Contagem de erros — quantas linhas falharam

Pausar e retomar

  • Clique em Pausar para parar o processamento temporariamente. Nenhuma nova concessão é criada durante a pausa.
  • Clique em Retomar para continuar de onde parou.

Cancelar

  • Clique em Cancelar para parar o processamento por completo. As concessões já criadas são mantidas.

Tratamento de erros

Quando uma linha falha (ex.: dados inválidos, cota mensal atingida):

  • O erro é registrado com detalhes
  • O processamento continua automaticamente para a próxima linha
  • As linhas com falha são reunidas para a etapa de resultados

Recuperação após atualizar a página

Se você fechar o navegador por acidente ou atualizar a página durante o processamento, a sessão de concessão em massa é recuperada ao voltar. O progresso é retomado de onde parou.

Etapa 4: Resultados

Após o processamento ser concluído (ou cancelado), a tela de resultados exibe:

  • Total processado — número de linhas tentadas
  • Sucessos — número de concessões criadas
  • Falhas — número de linhas que falharam

Baixar relatórios

  • Baixar CSV de sucessos — CSV de todas as concessões criadas com sucesso, com nomes, e-mails e URLs de verificação dos destinatários
  • Baixar CSV de falhas — CSV de todas as linhas com falha e detalhes do erro

Reprocessar falhas

Se algumas linhas falharem, você pode baixar o CSV de falhas, corrigir os problemas e enviá-lo como uma nova concessão em massa para tentar novamente esses destinatários.

badges.ninja Documentation