Skip to content

Rilasci massivi

I rilasci massivi permettono di consegnare credenziali a centinaia o migliaia di destinatari in una volta sola caricando un file CSV. Il processo è articolato in quattro passi con monitoraggio dell'avanzamento integrato, pausa/ripresa e gestione degli errori.

Panoramica

Il processo massivo segue quattro passi:

  1. Configurare — scegli la credenziale e le opzioni
  2. Caricare — prepara e carica il file CSV
  3. Elaborare — monitora l'avanzamento durante la creazione dei rilasci
  4. Risultati — rivedi l'esito e scarica i report

Passo 1: Configurare

Rilasci massivi — passo 1, configura

  1. Apri la pagina Rilasci dalla barra laterale.
  2. Premi Rilascio massivo.
  3. Scegli la credenziale da rilasciare mediante il selettore.
  4. Configura facoltativamente:
    • Rilasciato il — data da applicare a tutti i rilasci (default: oggi)
    • Scade — data di scadenza facoltativa per tutti i rilasci
    • Invia e-mail — se inviare automaticamente un'e-mail a ciascun destinatario dopo la creazione del rilascio
  5. Premi Avanti.

Passo 2: Caricare il CSV

Rilasci massivi — passo 2, carica

Formato CSV

Il file CSV deve presentare due colonne: name ed email. La prima riga dovrà essere un'intestazione.

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

Scaricare il modello

Premi Scarica modello per ottenere un CSV vuoto con le intestazioni corrette. Compilalo con i destinatari e caricalo.

Caricamento

  1. Premi Carica CSV oppure trascina il file.
  2. Il file viene validato prima dell'avvio dell'elaborazione.

Regole di validazione

Ogni riga viene validata:

  • name deve contenere almeno 5 caratteri
  • email deve essere un indirizzo valido
  • Le e-mail duplicate all'interno del file vengono segnalate
  • Le righe vuote vengono ignorate

Se vengono individuati errori di validazione, vengono mostrati con i numeri di riga. Correggi le anomalie nel CSV e ricaricalo.

  1. Premi Avanti per avviare l'elaborazione.

Passo 3: Elaborazione

Una volta avviata l'elaborazione vedrai una barra di avanzamento e lo stato in tempo reale:

  • Barra di avanzamento — indica la percentuale di righe elaborate
  • Riga corrente — quale riga viene elaborata in questo momento
  • Conteggio successi — quanti rilasci sono stati creati
  • Conteggio errori — quante righe hanno fallito

Sospendere e riprendere

  • Premi Sospendi per fermare temporaneamente l'elaborazione. Mentre è sospesa non vengono creati nuovi rilasci.
  • Premi Riprendi per proseguire dal punto d'arresto.

Annullare

  • Premi Annulla per interrompere del tutto l'elaborazione. I rilasci già creati vengono conservati.

Gestione degli errori

Quando una riga fallisce (es. dati non validi, quota mensile raggiunta):

  • L'errore viene registrato con dettagli
  • L'elaborazione prosegue automaticamente sulla riga successiva
  • Le righe fallite vengono raccolte per il passo dei risultati

Recupero dopo l'aggiornamento della pagina

Se chiudi per errore il browser oppure aggiorni la pagina durante l'elaborazione, la sessione di rilascio massivo viene ripristinata al rientro. L'avanzamento riprende dal punto in cui si era fermato.

Passo 4: Risultati

Al termine dell'elaborazione (o dopo un annullamento), la schermata dei risultati mostra:

  • Totale elaborate — righe tentate
  • Riuscite — rilasci creati
  • Fallite — righe che hanno fallito

Scaricare i report

  • Scarica CSV dei successi — un CSV di tutti i rilasci creati con nomi, e-mail e URL di verifica
  • Scarica CSV dei fallimenti — un CSV di tutte le righe fallite con i dettagli dell'errore

Riprovare i fallimenti

Se alcune righe hanno fallito, puoi scaricare il CSV dei fallimenti, correggere le anomalie e ricaricarlo come nuovo rilascio massivo per riprovare con quei destinatari.

badges.ninja Documentation