Credenciais em massa

As credenciais 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 credenciais 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 credenciais são criadas
4. Resultados — revise os resultados e baixe os relatórios

Etapa 1: Configurar

1. Abra a página Credenciais em massa na barra lateral (sua própria rota, separada da página de Credenciais).
2. Escolha o distintivo que deseja emitir usando o seletor.
3. Configure opcionalmente:
   • Data de emissão — data usada para todas as credenciais (padrão: hoje)
   • Expira — data de expiração opcional para todas as credenciais
   • Enviar e-mail — se um e-mail será enviado automaticamente a cada destinatário ao criar sua credencial
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 credenciais 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 credencial é criada durante a pausa.
• Clique em Retomar para continuar de onde parou.

Cancelar

• Clique em Cancelar para parar o processamento por completo. As credenciais 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 credencial 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 credenciais 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 credencial 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 credencial é 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.