Credenciales masivas

Las credenciales masivas 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 credenciales masivas 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 las credenciales
4. Resultados — revisa los resultados y descarga los informes

Paso 1: Configurar

1. Abre la página Credenciales masivas desde la barra lateral (su propia ruta, independiente de la página de Credenciales).
2. Selecciona la insignia que quieres emitir usando el selector de insignias.
3. Opcionalmente configura:
   • Fecha de emisión — la fecha que se usará para todas las credenciales (por defecto, hoy)
   • Caduca — fecha de caducidad opcional para todas las credenciales
   • Enviar correo — si se debe enviar automáticamente un correo a cada destinatario tras crearse su credencial
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ántas credenciales 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 nuevas credenciales mientras está en pausa.
• Haz clic en Reanudar para continuar donde lo dejaste.

Cancelar

• Haz clic en Cancelar para detener el procesamiento por completo. Las credenciales ya creadas 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 credenciales masivas 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 credenciales creadas
• 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 nueva credencial con un enlace para verla, 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 de la credencial 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.