Skip to content

Otorgamientos masivos

Los otorgamientos masivos te permiten entregar credenciales a centenares o miles de destinatarios de una vez cargando un archivo CSV. El proceso consta de cuatro pasos con seguimiento de avance integrado, pausa/reanudación y manejo de errores.

Resumen

El proceso masivo sigue cuatro pasos:

  1. Configurar — elige la credencial y las opciones
  2. Cargar — prepara y sube tu archivo CSV
  3. Procesar — controla el avance mientras se crean los otorgamientos
  4. Resultados — revisa el desenlace y descarga los reportes

Paso 1: Configurar

Otorgamientos masivos — paso 1, configurar

  1. Abre la página Otorgamientos desde la barra lateral.
  2. Pulsa Otorgamiento masivo.
  3. Elige la credencial a entregar mediante el selector.
  4. Configura opcionalmente:
    • Otorgado el — fecha que se aplicará a todos los otorgamientos (por defecto, hoy)
    • Caduca — fecha de caducidad opcional para todos los otorgamientos
    • Enviar correo — si se envía o no automáticamente un correo a cada destinatario tras crear su otorgamiento
  5. Pulsa Siguiente.

Paso 2: Cargar CSV

Otorgamientos masivos — paso 2, carga

Formato CSV

El archivo CSV debe contar con dos columnas: name y email. La primera fila debe ser un encabezado.

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

Descargar plantilla

Pulsa Descargar plantilla para obtener un CSV vacío con los encabezados correctos. Rellénalo con tus destinatarios y cárgalo.

Carga

  1. Pulsa Cargar CSV o arrastra y suelta el archivo.
  2. El archivo se valida antes de iniciar el procesamiento.

Reglas de validación

Cada fila se valida:

  • name debe tener al menos 5 caracteres
  • email debe ser una dirección válida
  • Los correos duplicados dentro del archivo quedan señalados
  • Las filas vacías se omiten

Si se detectan errores de validación, se muestran indicando los números de fila. Corrige las incidencias en tu CSV y vuelve a cargarlo.

  1. Pulsa Siguiente para iniciar el procesamiento.

Paso 3: Procesamiento

Una vez iniciado el procesamiento, verás una barra de avance y el estado en vivo:

  • Barra de avance — indica el porcentaje de filas procesadas
  • Fila actual — qué fila se está procesando ahora
  • Conteo de éxitos — cuántos otorgamientos se han creado
  • Conteo de errores — cuántas filas han fallado

Pausar y reanudar

  • Pulsa Pausar para detener temporalmente el procesamiento. Mientras esté en pausa, no se crean nuevos otorgamientos.
  • Pulsa Reanudar para continuar desde el punto en que quedó.

Cancelar

  • Pulsa Cancelar para detener por completo el procesamiento. Los otorgamientos ya creados se conservan.

Manejo de errores

Cuando una fila falla (p. ej. datos inválidos, cuota mensual alcanzada):

  • El error queda registrado con detalle
  • El procesamiento continúa con la fila siguiente automáticamente
  • Las filas fallidas se reúnen para el paso de resultados

Recuperación tras refresco

Si cierras por accidente el navegador o refrescas la página durante el procesamiento, la sesión masiva se recupera al regresar. El avance continúa desde el punto en que se detuvo.

Paso 4: Resultados

Una vez completado (o cancelado) el procesamiento, la pantalla de resultados muestra:

  • Total procesado — número de filas intentadas
  • Exitosos — número de otorgamientos creados
  • Fallidos — número de filas que fracasaron

Descargar reportes

  • Descargar CSV de éxitos — un CSV con todos los otorgamientos creados, sus destinatarios, correos y URLs de verificación
  • Descargar CSV de fallos — un CSV con todas las filas fallidas y los detalles del error

Reintento de fallos

Si algunas filas fallaron, puedes descargar el CSV de fallos, corregir las incidencias y volver a cargarlo como nuevo otorgamiento masivo para reintentarlo con esos destinatarios.

badges.ninja Documentation