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

1. Abra a página Concessões em massa na barra lateral (sua própria rota, separada da página de Concessões).
2. Escolha o distintivo que deseja conceder usando o seletor.
3. 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
4. Clique em Avançar.

Etapa 2: Enviar CSV

Formato do CSV

O arquivo CSV deve ter uma coluna name e uma coluna email, com uma linha de cabeçalho. Os nomes de cabeçalho não diferenciam maiúsculas/minúsculas, e recipient_name / recipient_email são aceitos como aliases de name / email.

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 assim que o arquivo é lido:

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

A tabela de pré-visualização lista cada linha com uma marca verde ou um motivo em vermelho. Linhas inválidas não são um impedimento — elas são simplesmente ignoradas, e o contador mostra quantos destinatários válidos serão processados (ex.: "18 destinatários válidos, 2 inválidos (serão ignorados)"). Você pode prosseguir desde que pelo menos uma linha seja válida; não é preciso corrigir e reenviar antes.

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

Etapa 3: Processamento

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

• Barra de progresso — o percentual de linhas processadas
• Criadas — quantas concessões foram criadas
• Falhas — quantas linhas falharam
• Restantes — quantas linhas ainda estão na fila

Tabelas ao vivo de Criadas, Falhas e Pendentes são preenchidas abaixo da barra à medida que o lote é executado.

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 por um motivo específico da linha (ex.: um valor inválido que o backend rejeita):

• O erro é registrado naquela linha
• O processamento continua automaticamente para a próxima linha
• As linhas com falha são reunidas para a etapa de resultados, com o texto do erro exibido na tabela de falhas na tela

Linhas limitadas por taxa (rate-limited) são repetidas automaticamente com uma pequena espera. Um erro de créditos ou cota é diferente — em vez de avançar, o lote pausa para que você não consuma o restante do arquivo. Um aviso vermelho de "Créditos insuficientes" aparece; adicione créditos ou faça upgrade e clique em Retomar para continuar de onde parou.

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 quatro cartões de resumo:

• Total — número de destinatários no lote
• Criadas — número de concessões criadas
• Falhas — número de linhas que falharam
• Ignoradas — destinatários não processados (ex.: linhas restantes após um cancelamento)

Abaixo dos cartões, uma tabela Criadas lista cada nova concessão com um link para vê-la, e uma tabela Falhas lista as falhas com o texto do erro.

Baixar relatórios

• Baixar CSV de resultados — todas as linhas do lote, com as colunas row, name, email, status, award_url (a URL da concessão é preenchida nas linhas criadas).
• Baixar CSV de falhas — apenas as linhas com falha, com as colunas name, email, error.

Reprocessar falhas

Se algumas linhas falharem, clique em Reprocessar falhas. Isso inicia uma nova passagem apenas pelos destinatários com falha — sem necessidade de reenviar um CSV. É útil após corrigir um problema transitório, como adicionar créditos depois de um lote pausado.