Importar usuarios
Con la importación, registras o actualizas muchos usuarios del portal a la vez, a partir de un archivo CSV. El archivo se procesa en segundo plano, línea por línea, y al final ves cuántas líneas salieron bien y cuáles fallaron.
Cómo importar
- En Portal › Users (
/dashboard/users), haz clic en Import. - Selecciona el archivo CSV o arrástralo a la ventana.
- Haz clic en Confirm.
- Sigue el avance. Al final, la ventana muestra el resumen y, si los hay, el error de cada línea.
Cuando la importación termina, la lista de usuarios se actualiza sola.
El archivo
- Formato CSV, en UTF-8, con coma como separador. No se aceptan otros formatos (como XLSX).
- Hasta 10 MB.
- La primera línea es el encabezado, con los nombres de las columnas de abajo. El orden no importa.
- Los valores con coma van entre comillas.
| Columna | Obligatoria | Qué hace |
|---|---|---|
email | Sí | El correo del usuario. Una línea sin correo da error |
tenant_id | No | El tenant ID. Sin la columna, el tenant ID no cambia; con la celda vacía, se borra |
status | No | active, pending_verification, pending_invitation, suspended o locked. Vacío o ausente pasa a pending_verification |
sso_only | No | true, 1, yes o sim marca al usuario como solo SSO (sin contraseña). Cualquier otro valor, o la columna ausente, lo desmarca |
public_id | No | El ID público del usuario. Sirve para encontrar a un usuario existente |
metadata | No | Un objeto JSON con datos extra |
El nombre del usuario no se importa.
Ejemplo:
email,tenant_id,status
larissa.pereira@clientes-aurora.com.br,36790981705,active
caio.nascimento@clientes-aurora.com.br,51205326000196,active
Crear o actualizar
Cada línea busca un usuario del workspace por public_id y, si no lo encuentra, por email:
- Lo encontró — el usuario se actualiza con los valores de la línea.
- No lo encontró — se crea un usuario nuevo.
La importación no envía correos. Un usuario creado como pending_verification entra por el portal (con enlace mágico, por ejemplo) y el primer login lo activa. Si quieres enviar una invitación, usa Invitar usuario — mira Usuarios del portal.
:::warning Actualizar un usuario existente
Al actualizar, status, sso_only y metadata siempre se vuelven a escribir. Si tu planilla no tiene esas columnas, un usuario Active vuelve a Pending, pierde la marca de solo SSO y se queda sin metadatos. Incluye las columnas con los valores actuales cuando solo vayas a ajustar el tenant ID — la exportación trae todos ellos.
:::
:::tip Reaprovechar una exportación
El archivo de la exportación usa encabezados en portugués (E-mail, ID do Titular...). Para importarlo de vuelta, cambia el encabezado por los nombres de las columnas de arriba (email, tenant_id...).
:::
Estado de la importación
| Estado | Qué significa |
|---|---|
pending | En la cola. La ventana muestra Processing import... |
processing | Leyendo las líneas. La ventana muestra cuántas van (12 de 40) |
Import completed (completed) | Todas las líneas salieron bien |
Import completed with errors (completed_with_errors) | Algunas líneas fallaron; la ventana lista cada una con el motivo (Línea 5: ...) |
Import failed (failed) | No se pudo leer el archivo — por ejemplo, sin ninguna línea de datos |
Las líneas que salieron bien quedan guardadas aunque otras fallen. Corrige solo las líneas con error e importa de nuevo.
Cada importación queda registrada en la Auditoría.
La importación depende de la opción Permitir registrar usuarios en el panel, en Configuración › Registros. Con ella desactivada, la importación es rechazada.