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

1. Abre la página Otorgamientos masivos desde la barra lateral (su propia ruta, independiente de la página de Otorgamientos).
2. Selecciona la insignia que quieres otorgar usando el selector de insignias.
3. 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
4. Haz clic en Siguiente.

Paso 2: Subir CSV

Formato del CSV

El archivo CSV debe tener una columna name y una columna email, con una fila de cabecera. Los nombres de las cabeceras no distinguen mayúsculas de minúsculas, y recipient_name / recipient_email se aceptan como alias de name / email.

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 en cuanto se analiza el archivo:

• Nombre debe tener al menos 5 caracteres
• Email debe ser una dirección de correo válida
• Las filas vacías se omiten

La tabla de vista previa muestra cada fila con una marca verde o un motivo en rojo. Las filas inválidas no son un impedimento — simplemente se omiten, y el contador muestra cuántos destinatarios válidos se procesarán (p. ej. "18 destinatarios válidos, 2 inválidos (se omitirán)"). Puedes continuar siempre que al menos una fila sea válida; no hace falta corregir y volver a subir antes.

3. Haz clic en Siguiente para iniciar el procesamiento.

Paso 3: Procesamiento

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

• Barra de progreso — el porcentaje de filas procesadas
• Creadas — cuántos otorgamientos se han creado
• Fallidas — cuántas filas han fallado
• Restantes — cuántas filas siguen en cola

Bajo la barra se van rellenando tablas en tiempo real de Creadas, Fallidas y Pendientes a medida que se ejecuta el lote.

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 por un motivo específico de esa fila (p. ej., un valor inválido que el backend rechaza):

• El error se registra contra esa fila
• El procesamiento continúa automáticamente con la siguiente fila
• Las filas fallidas se recopilan para el paso de resultados, con su texto de error mostrado en la tabla de fallos en pantalla

Las filas limitadas por tasa se reintentan automáticamente con un breve retroceso. Un error de créditos o de cuota es diferente — en lugar de saltar adelante, el lote se pausa para que no agotes el resto del archivo. Aparece un aviso rojo de "Créditos insuficientes"; recarga créditos o mejora tu plan, y luego haz clic en Reanudar para continuar desde donde se detuvo.

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 cuatro tarjetas de resumen:

• Total — número de destinatarios en el lote
• Creadas — número de otorgamientos creados
• Fallidas — número de filas que fallaron
• Omitidas — destinatarios no procesados (p. ej., las filas restantes tras una cancelación)

Debajo de las tarjetas, una tabla Creadas lista cada nuevo otorgamiento con un enlace para verlo, y una tabla Fallidas lista los fallos con su texto de error.

Descargar informes

• Descargar CSV de resultados — cada fila del lote, con las columnas row, name, email, status, award_url (la URL del premio se rellena en las filas creadas).
• Descargar CSV de fallos — solo las filas fallidas, con las columnas name, email, error.

Reintentar fallos

Si algunas filas fallaron, haz clic en Reintentar fallos. Esto inicia una nueva pasada solo sobre los destinatarios fallidos — sin necesidad de volver a subir un CSV. Es útil tras corregir un problema transitorio, como recargar créditos después de un lote en pausa.