Skip to content

Otorgamientos masivos

Los otorgamientos masivos te permiten emitir insignias a cientos o miles de destinatarios a la vez subiendo un archivo CSV. El proceso tiene cuatro pasos con seguimiento del progreso integrado, pausa/reanudar y manejo de errores.

Resumen

El proceso de otorgamientos masivos sigue cuatro pasos:

  1. Configurar — selecciona la insignia y las opciones
  2. Subir — prepara y sube tu archivo CSV
  3. Procesar — monitoriza el progreso mientras se crean los otorgamientos
  4. Resultados — revisa los resultados y descarga los informes

Paso 1: Configurar

Otorgamientos masivos — paso 1, configurar

  1. Abre la página Otorgamientos desde la barra lateral.
  2. Haz clic en Otorgamiento masivo.
  3. Selecciona la insignia que quieres otorgar usando el selector de insignias.
  4. Opcionalmente configura:
    • Fecha de emisión — la fecha que se usará para todos los otorgamientos (por defecto, hoy)
    • Caduca — fecha de caducidad opcional para todos los otorgamientos
    • Enviar correo — si se debe enviar automáticamente un correo a cada destinatario tras crearse su otorgamiento
  5. Haz clic en Siguiente.

Paso 2: Subir CSV

Otorgamientos masivos — paso 2, subir

Formato del CSV

El archivo CSV debe tener dos columnas: name y email. La primera fila debe ser la cabecera.

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

Descargar plantilla

Haz clic en Descargar plantilla para obtener un CSV en blanco con las cabeceras correctas. Rellénalo con tus destinatarios y súbelo.

Subida

  1. Haz clic en Subir CSV o arrastra y suelta tu archivo.
  2. El archivo se valida antes de empezar a procesar.

Reglas de validación

Cada fila se valida:

  • Nombre debe tener al menos 5 caracteres
  • Email debe ser una dirección de correo válida
  • Los correos duplicados dentro del archivo se marcan
  • Las filas vacías se omiten

Si se encuentran errores de validación, se muestran con los números de fila. Corrige los problemas en tu CSV y vuelve a subirlo.

  1. Haz clic en Siguiente para iniciar el procesamiento.

Paso 3: Procesamiento

Una vez iniciado el procesamiento, verás una barra de progreso y el estado en tiempo real:

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

Pausar y reanudar

  • Haz clic en Pausar para detener el procesamiento temporalmente. No se crean nuevos otorgamientos mientras está en pausa.
  • Haz clic en Reanudar para continuar donde lo dejaste.

Cancelar

  • Haz clic en Cancelar para detener el procesamiento por completo. Los otorgamientos ya creados se conservan.

Manejo de errores

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

  • El error se registra con detalles
  • El procesamiento continúa automáticamente con la siguiente fila
  • Las filas fallidas se recopilan para el paso de resultados

Recuperación tras recargar la página

Si cierras el navegador accidentalmente o recargas la página durante el procesamiento, la sesión de otorgamientos masivos se recupera al volver. El progreso continúa desde donde se detuvo.

Paso 4: Resultados

Tras completarse (o cancelarse) el procesamiento, la pantalla de resultados muestra:

  • Total procesado — número de filas intentadas
  • Exitosas — número de otorgamientos creados
  • Fallidas — número de filas que fallaron

Descargar informes

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

Reintentar fallos

Si algunas filas fallaron, puedes descargar el CSV de fallos, arreglar los problemas y subirlo de nuevo como nuevo otorgamiento masivo para reintentar con esos destinatarios.

badges.ninja Documentation