Credenciais em massa

As credenciais em massa permitem-lhe emitir distintivos para centenas ou milhares de destinatários de uma só vez, através do carregamento de um ficheiro CSV. O processo tem quatro passos, com acompanhamento de progresso, pausa/retoma e gestão de erros integrados.

Vista geral

O processo de credenciais em massa segue quatro passos:

1. Configurar — selecione o distintivo e as opções
2. Carregar — prepare e carregue o seu ficheiro CSV
3. Processar — acompanhe o progresso enquanto as credenciais são criadas
4. Resultados — reveja os resultados e transfira os relatórios

Passo 1: Configurar

1. Abra a página Credenciais em massa na barra lateral (tem uma rota própria, separada da página Credenciais).
2. Selecione o distintivo que pretende emitir através do seletor de distintivos.
3. Opcionalmente, configure:
   • Emitido em — a data usada para todas as credenciais (por predefinição, hoje)
   • Expira em — data de expiração opcional para todas as credenciais
   • Enviar e-mail — se cada destinatário deve receber automaticamente um e-mail depois de a sua credencial ser criada
4. Clique em Seguinte.

Passo 2: Carregar o CSV

Formato do CSV

O ficheiro CSV tem de ter uma coluna name e uma coluna email, com uma linha de cabeçalho. Os nomes dos cabeçalhos não distinguem maiúsculas de minúsculas, e recipient_name / recipient_email são aceites como alias de name / email.

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

Transferir modelo

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

Carregamento

1. Clique em Carregar CSV ou arraste e largue o seu ficheiro.
2. O ficheiro é validado antes de o processamento começar.

Regras de validação

Cada linha é validada assim que o ficheiro é analisado:

• O nome tem de ter pelo menos 5 caracteres
• O e-mail tem de ser um endereço de e-mail válido
• As linhas vazias são ignoradas

A tabela de pré-visualização lista todas as linhas com uma marca verde ou um motivo a vermelho. As linhas inválidas não bloqueiam o processo — são simplesmente ignoradas, e o contador indica quantos destinatários válidos serão processados (por exemplo, "18 destinatários válidos, 2 inválidos (serão ignorados)"). Pode avançar desde que pelo menos uma linha seja válida; não é necessário corrigir e voltar a carregar primeiro.

3. Clique em Seguinte para iniciar o processamento.

Passo 3: Processamento

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

• Barra de progresso — a percentagem de linhas processadas
• Criadas — quantas credenciais foram criadas
• Falhadas — quantas linhas falharam
• Restantes — quantas linhas ainda estão em fila

As tabelas em direto Criadas, Falhadas e Pendentes vão sendo preenchidas por baixo da barra enquanto o lote é executado.

Pausa e retoma

• Clique em Pausar para parar temporariamente o processamento. Não são criadas novas credenciais enquanto estiver em pausa.
• Clique em Retomar para continuar a partir do ponto onde parou.

Cancelar

• Clique em Cancelar para parar totalmente o processamento. As credenciais já criadas são mantidas.

Gestão de erros

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

• O erro é registado nessa linha
• O processamento continua automaticamente para a linha seguinte
• As linhas falhadas são reunidas para o passo de resultados, com o texto do erro apresentado na tabela de falhas no ecrã

As linhas limitadas por taxa são repetidas automaticamente, com um breve intervalo. Um erro de créditos ou de quota é diferente — em vez de avançar, o lote é colocado em pausa para que não gaste o resto do ficheiro. Surge um aviso vermelho de "Créditos insuficientes"; carregue o saldo ou atualize o plano e clique em Retomar para continuar a partir do ponto onde parou.

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

Se fechar acidentalmente o navegador ou atualizar a página durante o processamento, a sessão de credenciais em massa é recuperada quando regressar. O progresso retoma a partir do ponto onde parou.

Passo 4: Resultados

Depois de o processamento terminar (ou ser cancelado), o ecrã de resultados mostra quatro cartões de resumo:

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

Por baixo dos cartões, uma tabela Criadas lista cada nova credencial com uma ligação para a ver, e uma tabela Falhadas lista as falhas com o respetivo texto de erro.

Transferir relatórios

• Transferir CSV de resultados — todas as linhas do lote, com as colunas row, name, email, status, award_url (o URL da credencial é preenchido nas linhas criadas).
• Transferir CSV de falhas — apenas as linhas falhadas, com as colunas name, email, error.

Repetir falhas

Se algumas linhas falharam, clique em Repetir falhas. Isto inicia uma nova passagem apenas pelos destinatários falhados — sem necessidade de voltar a carregar um CSV. É útil depois de resolver um problema transitório, como carregar saldo de créditos após um lote em pausa.