Importar usuarios por hoja de cálculo (.csv)
Ruta: Usuarios → Importar
Visión general
La importación te permite registrar varios usuarios a la vez a partir de una hoja de cálculo .csv. Así, evitas registrar uno por uno cuando estás implementando ¡Hola! Suite o recibiendo un equipo nuevo.
El asistente Importar usuarios tiene dos etapas: Selección del archivo, en la que el sistema verifica el formato de la hoja de cálculo, y Revisión, en la que ves cada usuario antes de guardar y corriges lo que sea necesario.
Requisitos previos
- Permiso Usuarios habilitado en tu grupo de permisos.
- Licencias disponibles para todos los usuarios de la hoja de cálculo. Cada usuario activo ocupa una licencia.
- IDs de los grupos de permisos y de los departamentos que vas a usar. Para verlos, activa Mostrar IDs en los formularios en Configuraciones → Empresa. El ID pasa a aparecer en el encabezado de cada grupo y departamento, con un botón para copiar.
- Hoja de cálculo guardada en formato .csv.
Paso a paso
- Accede a Usuarios y haz clic en el botón Importar (ícono de archivo, junto a Añadir nuevo).
- En la etapa Selección del archivo, haz clic en Descargar plantilla para descargar la hoja de cálculo con las columnas correctas.
- Completa una línea por usuario, siguiendo las columnas de la tabla de abajo.
- Haz clic en el campo Archivo .csv y envía la hoja de cálculo.
- Haz clic en Continuar. El sistema verifica el archivo y abre la etapa Revisión.
- En la Revisión, revisa el conteo de usuarios listos y de los que necesitan revisión. Para corregir un registro, haz clic en el menú de la línea y en Modificar. Para sacar un registro de la importación, usa Eliminar.
- Cuando no haya más registros con pendencias, haz clic en Importar y guardar.
Columnas de la hoja de cálculo
| Columna en la plantilla | Qué informar | Obligatoria |
|---|---|---|
nome | Nombre del usuario. | Sí |
email | Correo electrónico de inicio de sesión. No puede pertenecer a un usuario ya registrado. | Sí |
senha | Contraseña inicial del usuario (consulta los requisitos abajo). | Sí |
idGrupoPermissao | ID del grupo de permisos. | Sí |
departamentos | IDs de los departamentos del usuario. | Solo si alguna de las columnas siguientes está completa |
departamentoPadrao | ID del departamento predeterminado (uno solo). | No |
departamentosEmQueRealizaAtendimentos | IDs de los departamentos en los que el usuario queda disponible para transferencias directas. | No |
departamentosResponsavel | IDs de los departamentos en los que el usuario es responsable. | No |
recebeNotificacoesDosDepartamentos | IDs de los departamentos de los que el usuario recibe notificaciones de transferencias. | No |
Las columnas de departamento solo aceptan departamentos activos que también estén en la columna departamentos. Para informar más de un departamento en la misma celda, separa los IDs con coma.
Requisitos de la contraseña de la hoja de cálculo: de 8 a 50 caracteres, con al menos una letra mayúscula, un número y un carácter especial.
El sistema solo acepta la hoja de cálculo si la primera línea tiene exactamente las columnas de la plantilla. Si el formato no coincide, aparece un mensaje indicando que el formato de la información del archivo enviado no corresponde al patrón esperado. Descarga la plantilla de nuevo y copia tus datos en ella.
Resultado esperado
El sistema muestra que los usuarios se agregaron exitosamente y los nuevos usuarios aparecen en la lista con el estado Activo, ya vinculados a los departamentos informados.
Por seguridad, la contraseña de la hoja de cálculo funciona como contraseña temporal: en el primer acceso, cada usuario debe crear una nueva contraseña. Consulta Contraseña temporal y cambio de contraseña en el primer acceso.
Problemas comunes
| Síntoma | Qué verificar |
|---|---|
| Mensaje de que el formato de la información del archivo enviado no corresponde al patrón esperado | El archivo no es .csv, el encabezado se cambió o la hoja de cálculo está vacía. Usa la plantilla de Descargar plantilla. |
| Aviso de que se alcanzó el límite de usuarios | La cantidad de usuarios de la hoja de cálculo supera las licencias libres. Quita registros en la Revisión, inactiva usuarios que ya no usan el sistema o contrata más licencias con el botón Contactar. |
| Registro con aviso de usuario ya registrado | Ya existe un usuario con ese correo electrónico. Corrige el correo o elimina el registro de la importación. |
| Registro con error en la contraseña | La contraseña no tiene 8 caracteres, supera los 50 o le falta una letra mayúscula, un número o un carácter especial. |
| El botón Importar y guardar está deshabilitado | Todavía hay registros que necesitan revisión, la lista está vacía o no hay licencias suficientes. |
| El usuario se importó sin departamento | El ID informado no existe, es de un departamento inactivo o, en las columnas complementarias, no está también en la columna departamentos. |
Buenas prácticas
- Empieza siempre por el archivo de Descargar plantilla y no cambies el nombre de las columnas.
- Copia los IDs con el botón de copiar del formulario, para evitar errores de digitación.
- Antes de importar, revisa las licencias libres en Verificación de la versión y licencia.
- Envía la contraseña inicial de cada persona por un canal privado.