Importar usuarios mediante CSV

Importación de usuarios mediante CSV

Para añadir muchos usuarios al mismo tiempo, puede importar un archivo CSV.

Preparar el archivo CSV

Formato del archivo CSV

Su archivo CSV debe contener las siguientes columnas:

email,first_name,last_name,groups
[email protected],Max,Mustermann,Ventas
[email protected],Anna,Schmidt,"Ventas,Marketing"
[email protected],Peter,Weber,IT

Campos obligatorios y opcionales

Campo	Obligatorio	Descripción
email	Sí	Dirección de correo electrónico del usuario
first_name	Opcional	Nombre
last_name	Opcional	Apellido
groups	Opcional	Grupos (separados por comas si son varios)

Indicaciones importantes sobre el formato

• Separador: Coma (,) o punto y coma (;)
• Codificación: UTF-8 para caracteres especiales
• Varios grupos: Entre comillas y separados por comas

Realizar la importación

Paso a paso

1. Vaya a Admin > Usuarios
2. Haga clic en “Importar” o “Importación CSV”
3. Haga clic en “Seleccionar archivo”
4. Seleccione su archivo CSV
5. Haga clic en “Subir”

Comprobar vista previa

Después de subir el archivo verá una vista previa:

• Número de usuarios que se importarán
• Columnas detectadas
• Posibles errores o advertencias

Confirmar importación

1. Revise la vista previa cuidadosamente
2. Corrija posibles errores en el CSV
3. Haga clic en “Iniciar importación”

Después de la importación

¿Qué ocurre?

• Todos los usuarios reciben un correo de invitación
• Los usuarios se asignan a los grupos indicados
• El estado inicial de todos los usuarios es “Pendiente”

Informe de importación

Al finalizar verá:

• Importados correctamente: Número de usuarios nuevos
• Omitidos: Direcciones de correo ya existentes
• Errores: Filas no válidas con descripción del error

Tratamiento de errores

Errores frecuentes

Error	Causa	Solución
”Correo no válido”	Formato de correo incorrecto	Corregir la dirección de correo
”Grupo no encontrado”	El nombre del grupo no existe	Crear primero el grupo o comprobar el nombre
”Usuario existente”	El correo ya está registrado	Eliminar la fila o ignorarla
”Error de codificación”	Codificación de archivo incorrecta	Guardar como UTF-8

Corregir el archivo CSV

1. Abra el CSV en un editor de texto o en Excel
2. Corrija las filas con errores
3. Guarde como CSV (UTF-8)
4. Ejecute la importación de nuevo

Crear CSV con Excel

Exportar desde Excel

1. Cree los datos en Excel
2. Vaya a Archivo > Guardar como
3. Seleccione “CSV UTF-8 (delimitado por comas)”
4. Guarde el archivo

Encabezados de columna

Use los nombres exactos de columna:

• email (no “E-mail” ni “Email”)
• first_name (no “Nombre”)
• last_name (no “Apellido”)
• groups (no “Grupos”)

Descargar plantilla

Descargue nuestra plantilla para usar el formato correcto:

1. Vaya al diálogo de importación
2. Haga clic en “Descargar plantilla”
3. Abra la plantilla en Excel
4. Introduzca sus datos

Buenas prácticas

Antes de importar

• Crear grupos: Todos los grupos referenciados deben existir
• Comprobar datos: Revisar direcciones de correo por errores tipográficos
• Pruebas pequeñas: Probar primero con pocas filas

Durante la importación

• Paciencia: Las importaciones grandes pueden tardar unos minutos
• No interrumpir: Mantener abierta la pestaña del navegador

Después de importar

• Revisar el informe: ¿Se importaron todos los usuarios correctamente?
• Comprobaciones aleatorias: Revisar algunos usuarios manualmente
• Invitaciones: Confirmar la recepción con algunos usuarios