Atribuições em massa

As atribuições 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/retomar e gestão de erros integrados.

Vista geral

O processo segue quatro etapas:

1. Configurar — escolha o distintivo e as opções
2. Carregar — prepare e envie o ficheiro CSV
3. Processar — acompanhe o progresso à medida que as atribuições são criadas
4. Resultados — reveja os resultados e transfira relatórios

Passo 1: configurar

1. Abra a página Atribuições em massa na barra lateral (a sua própria rota, separada da página Atribuições).
2. Escolha o distintivo a atribuir através do selector de distintivos.
3. Opcionalmente, configure:
   • Emitido em — a data a usar em todas as atribuições (por defeito, a data de hoje)
   • Expira — data de expiração opcional para todas as atribuições
   • Enviar e-mail — se cada destinatário deve receber automaticamente um e-mail quando a atribuição é criada
4. Clique em Seguinte.

Passo 2: carregar CSV

Formato do CSV

O ficheiro CSV deve ter uma coluna name e uma coluna email, com uma linha de cabeçalho. Os nomes dos cabeçalhos não são sensíveis a maiúsculas/minúsculas, e recipient_name / recipient_email são aceites como aliases 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 correctos. Preencha-o com os destinatários e carregue-o.

Carregar

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

Regras de validação

Cada linha é validada assim que o ficheiro é analisado:

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

A tabela de pré-visualização lista todas as linhas com um visto verde ou um motivo a vermelho. As linhas inválidas não são um impedimento — 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)"). Pode prosseguir desde que haja pelo menos uma linha válida; não é necessário corrigir e voltar a carregar primeiro.

3. Clique em Seguinte para iniciar o processamento.

Passo 3: processamento

Após arrancar o processamento, surge uma barra de progresso e contadores em directo:

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

Tabelas em directo de Criadas, Falhadas e Pendentes vão sendo preenchidas por baixo da barra à medida que o lote decorre.

Pausar e retomar

• Clique em Pausar para suspender temporariamente o processamento. Não são criadas novas atribuições enquanto estiver pausado.
• Clique em Retomar para continuar a partir do ponto onde ficou.

Cancelar

• Clique em Cancelar para parar totalmente o processamento. As atribuições 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 que o backend rejeita):

• O erro é registado contra essa linha
• O processamento avança automaticamente para a linha seguinte
• As linhas com falha são recolhidas para o passo dos resultados, com o respectivo texto de erro apresentado na tabela de falhas no ecrã

As linhas limitadas por taxa (rate-limited) são repetidas automaticamente com um breve intervalo de recuo. Um erro de créditos ou de quota é diferente — em vez de avançar, o lote é pausado para que não gaste o resto do ficheiro. Aparece um aviso vermelho de "Créditos insuficientes"; carregue mais créditos ou faça upgrade e, em seguida, clique em Retomar para continuar a partir do ponto onde parou.

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

Se fechar o navegador por engano ou recarregar a página durante o processamento, a sessão de atribuição em massa é recuperada quando regressar. O progresso retoma a partir de onde parou.

Passo 4: resultados

Depois de concluído (ou cancelado) o processamento, o ecrã de resultados mostra quatro cartões de resumo:

• Total — número de destinatários no lote
• Criadas — número de atribuições criadas
• Falhadas — número de linhas com falha
• Ignoradas — destinatários não processados (por exemplo, linhas restantes após um cancelamento)

Por baixo dos cartões, uma tabela Criadas lista cada nova atribuição com uma ligação para a ver, e uma tabela Falhadas lista as falhas com o respectivo 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 atribuição é preenchido nas linhas criadas).
• Transferir CSV de falhas — apenas as linhas com falha, com as colunas name, email, error.

Tentar novamente os que falharam

Se algumas linhas falharem, clique em Tentar novamente os que falharam. Isto inicia uma nova passagem apenas sobre os destinatários que falharam — sem necessidade de voltar a carregar um CSV. É útil depois de corrigir um problema transitório, como carregar mais créditos após um lote pausado.