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 — selecione 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 (ela tem rota própria, separada da página Credenciais).
2. Selecione o distintivo que deseja emitir usando o seletor de distintivos.
3. Opcionalmente, configure:
   • Emitido em — a data usada para todas as credenciais (o padrão é hoje)
   • Expira em — data de expiração opcional para todas as credenciais
   • Enviar e-mail — se cada destinatário deve receber um e-mail automaticamente depois que sua credencial for criada
4. Clique em Avançar.

Etapa 2: Enviar o CSV

Formato do CSV

O arquivo CSV deve ter uma coluna name e uma coluna email, com uma linha de cabeçalho. Os nomes dos cabeçalhos não diferenciam maiúsculas de 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 arquivo 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:

• O nome deve ter pelo menos 5 caracteres
• O e-mail deve ser um endereço de e-mail 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 bloqueiam o processo — elas são simplesmente ignoradas, e o contador mostra quantos destinatários válidos serão processados (por exemplo, "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

Quando o processamento começa, você vê uma barra de progresso e contadores em tempo real:

• Barra de progresso — a porcentagem de linhas processadas
• Criadas — quantas credenciais foram criadas
• Com falha — quantas linhas falharam
• Restantes — quantas linhas ainda estão na fila

As tabelas em tempo real Criadas, Com falha e Pendentes vão sendo preenchidas abaixo da barra enquanto o lote é executado.

Pausar e retomar

• Clique em Pausar para interromper temporariamente o processamento. Nenhuma credencial nova é criada enquanto estiver pausado.
• Clique em Retomar para continuar de onde parou.

Cancelar

• Clique em Cancelar para interromper o processamento por completo. As credenciais já criadas são mantidas.

Tratamento de erros

Quando uma linha falha por um motivo específico dela (por exemplo, um valor inválido rejeitado pelo backend):

• O erro é registrado na linha correspondente
• 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

As linhas limitadas por taxa são tentadas novamente automaticamente, com um breve intervalo. Um erro de créditos ou de cota é diferente — em vez de pular adiante, o lote é pausado para que você não consuma o restante do arquivo. Aparece um aviso vermelho de "Créditos insuficientes"; recarregue 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 ou atualizar a página por engano durante o processamento, a sessão de credenciais em massa é recuperada quando você voltar. O progresso continua de onde parou.

Etapa 4: Resultados

Depois que o processamento termina (ou é cancelado), a tela de resultados mostra quatro cartões de resumo:

• Total — número de destinatários no lote
• Criadas — número de credenciais criadas
• Com falha — número de linhas que falharam
• Ignoradas — destinatários não processados (por exemplo, as linhas restantes após um cancelamento)

Abaixo dos cartões, uma tabela Criadas lista cada nova credencial com um link para visualizá-la, e uma tabela Com falha 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 — somente as linhas com falha, com as colunas name, email, error.

Tentar novamente as falhas

Se algumas linhas falharam, clique em Tentar novamente as falhas. Isso inicia uma nova passagem apenas pelos destinatários com falha — sem precisar reenviar um CSV. É útil depois de resolver um problema temporário, como recarregar créditos após um lote pausado.