Credenciales masivas

Las credenciales masivas te permiten emitir insignias a cientos o miles de destinatarios a la vez subiendo un archivo CSV. El proceso consta de cuatro pasos, con seguimiento del progreso integrado, pausa/reanudación y gestión de errores.

Resumen

El proceso de credenciales masivas sigue cuatro pasos:

1. Configurar — selecciona la insignia y las opciones
2. Cargar — prepara y sube tu archivo CSV
3. Procesar — supervisa 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 (tiene su propia ruta, independiente de la página Credenciales).
2. Selecciona la insignia que quieres emitir con el selector de insignias.
3. Opcionalmente, configura:
   • Issued On — la fecha que se usará para todas las credenciales (por defecto, hoy)
   • Expires — fecha de caducidad opcional para todas las credenciales
   • Send Email — si se envía automáticamente un correo a cada destinatario una vez creada su credencial
4. Pulsa Siguiente.

Paso 2: Cargar CSV

Formato CSV

El archivo CSV debe tener una columna name y una columna email, con una fila de encabezado. Los nombres de los encabezados no distinguen entre mayúsculas y 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

Pulsa Descargar plantilla para obtener un archivo CSV en blanco con los encabezados correctos. Rellénalo con tus destinatarios y súbelo.

Carga

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

Reglas de validación

Cada fila se valida en cuanto se analiza el archivo:

• El nombre debe tener al menos 5 caracteres
• El correo 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 no válidas no son un impedimento: simplemente se omiten, y el contador indica cuántos destinatarios válidos se procesarán (p. ej., «18 destinatarios válidos, 2 no válidos (se omitirán)»). Puedes continuar siempre que al menos una fila sea válida; no hace falta corregir y volver a subir el archivo antes.

3. Pulsa Siguiente para iniciar el procesamiento.

Paso 3: Procesamiento

Cuando comienza el procesamiento, ves una barra de progreso y contadores en directo:

• 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

Las tablas en directo de Creadas, Fallidas y Pendientes se van rellenando bajo la barra mientras se ejecuta el lote.

Pausar y reanudar

• Pulsa Pausar para detener temporalmente el procesamiento. No se crean credenciales nuevas mientras esté en pausa.
• Pulsa Reanudar para continuar desde donde lo dejaste.

Cancelar

• Pulsa Cancelar para detener el procesamiento por completo. Las credenciales ya creadas se conservan.

Gestión de errores

Cuando una fila falla por un motivo específico de esa fila (p. ej., un valor no válido que el backend rechaza):

• El error se registra en 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 visible en la tabla de fallos en pantalla

Las filas limitadas por la tasa de peticiones se reintentan automáticamente con una breve espera. Un error de créditos o de cuota es distinto: en lugar de saltar a la siguiente fila, el lote se pausa para que no consumas el resto del archivo. Aparece un aviso rojo de «Créditos insuficientes»; recarga o mejora tu plan y luego pulsa Reanudar para continuar desde donde se detuvo.

Recuperación tras actualizar la página

Si cierras el navegador o actualizas la página por accidente durante el procesamiento, la sesión de credenciales masivas se recupera al volver. El progreso se reanuda desde donde se detuvo.

Paso 4: Resultados

Cuando el procesamiento termina (o se cancela), la pantalla de resultados muestra cuatro tarjetas de resumen:

• Total — número de destinatarios del lote
• Creadas — número de credenciales creadas
• Fallidas — número de filas que han fallado
• Omitidas — destinatarios no procesados (p. ej., las filas restantes tras una cancelación)

Debajo de las tarjetas, una tabla de Creadas muestra cada nueva credencial con un enlace para verla, y una tabla de Fallidas muestra los fallos con su texto de error.

Descargar informes

• Descargar CSV de resultados — todas las filas 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 han fallado, pulsa Reintentar fallos. Esto inicia una nueva pasada solo sobre los destinatarios fallidos, sin necesidad de volver a subir un CSV. Resulta útil tras resolver un problema transitorio, como recargar créditos después de que un lote se haya pausado.