Gestionar usuarios

Este artículo abarca los siguientes temas:

En Consola de Administración de Luma se pueden agregar, editar, activar y desactivar usuarios. Esto permite a los usuarios crear, editar y probar los bots y las habilidades. Un administrador puede gestionar roles como administrador, desarrollador, agente de Soporte y usuario final. Cada rol tiene permisos específicos para utilizar la consola. Para reducir el esfuerzo que se ha invertido en la gestión del permiso de habilidades, un administrador puede asignar usuarios a grupos y después asignar las habilidades a los grupos.

Para obtener más información, consulte Definir roles, permisos y grupos.

Ver la lista de usuarios

En el panel de navegación izquierdo, expanda Tenant (Tenant) y seleccione User Management (Gestión de usuarios). Aparecerá la lista usuarios como se muestra a continuación.

La lista usuarios incluye todos los usuarios que se encuentran actualmente en el sistema. Incluye los siguientes detalles del usuario:

• User Name (Nombre de usuario)
• Correo electrónico
• Nombre
• Apellido
• Rol
• Fuente
• Tipo de fuente
• Última actualización de la fuente
• Last Modified On (Date) (Fecha de la última modificación)
• Status (Active/Inactive) (Estado: activo/inactivo)

Se pueden ordenar todas las columnas en orden alfabético si se hace clic en el nombre de la columna en el encabezado.

Buscar usuarios

Se pueden buscar los usuarios existentes en la lista de usuarios. Para buscar un usuario:

1. Especifique el nombre de usuario, el correo electrónico, el nombre o el apellido en el cuadro de texto Search (Buscar).
2. Haga clic en la tecla Enter.
   La Bot Builder (Consola de Administración de Luma) recupera todos los registros de usuarios que coinciden con los detalles especificados.
3. Para regresar a la lista anterior, elimine los criterios de búsqueda y vuelva a pulsar la tecla Enter.

Crear usuarios

El administrador puede agregar nuevos usuarios y asignarles un rol. Para agregar usuarios, haga lo siguiente:

1. En la página User Management (Gestión de usuarios), haga clic en Create User (Crear usuario).
   Aparece la página Create User (Crear usuarios) como se muestra a continuación.
   
   
2. Especifique el Nombre de usuario. Se utiliza para iniciar sesión en Bot Builder (Consola de Administración de Luma). Suele ser la dirección de correo electrónico del usuario.
3. Especifique una dirección de correo electrónico válida del usuario para las comunicaciones por correo electrónico incluido el restablecimiento de contraseñas. Por ejemplo, joe.user@acmecorp.com
4. Ingrese el nombre, en First Name, y el apellido, en Last Name, del usuario.
5. Seleccione el idioma preferido del usuario en Language (Idioma). Esto afecta a las etiquetas que se muestran en la interfaz de Bot Builder. Las opciones disponibles son inglés y chino.
6. Seleccione el Rol para el usuario. Existen tres opciones:
   • End-User (Usuario final)
   • Agente de soporte
   • Desarrollador
   • Administrador
7. Haga clic en Create (Crear) para crear el usuario. De lo contrario, haga clic en Cancelar para descartar el proceso.

Editar usuarios

El administrador puede modificar los detalles del usuario si es necesario. Todos los usuarios forman parte del grupo público y no se pueden eliminar de él. El grupo público simplifica las habilidades de publicación para todos los usuarios.

Se puede editar la siguiente información del usuario:

• Información en la sección Details (Detalles)
• Rol
• Grupos 
• Habilidades

Para editar los usuarios existentes, siga los siguientes pasos:

1. En la lista Users (Usuarios), haga clic en la fila para el usuario que desea editar.
2. El usuario se mostrará en modo de solo lectura.
3. Haga clic en el botón Edit (Editar) para cambiar la información del usuario. Los campos se muestran en el modo editable, como aparece a continuación.
   
   
4. Para modificar el rol del usuario existente, seleccione el rol necesario en la lista desplegable de la sección Rol. Para obtener más información sobre cada rol, consulte Definir roles, permisos y grupos.
5. Realice los cambios necesarios y haga clic en Save (Guardar) para guardar los cambios. En caso contrario, haga clic en Cancelar para descartar los datos modificados.

Restablecer contraseña

Los administradores pueden restablecer la contraseña de un usuario en la página de Detalles mientras visualizan el Perfil de usuario. La pestaña Reset Password (Restablecer contraseña) solo aparece para el rol de administrador.

Para restablecer la contraseña, haga lo siguiente:

1. En la página Details (Detalles), haga clic en Reset Password (Restablecer contraseña). Se envía un correo electrónico a la dirección de correo electrónico del usuario registrada con un vínculo para restablecer la contraseña como se muestra a continuación.
   
    
   
2. Haga clic en el vínculo y aparecerá la pantalla  Restablecer contraseña tal y como se muestra a continuación.
   
3. Ingrese la contraseña nueva en el campo Contraseña nueva.
4. Vuelva a escribir la misma contraseña en el campo Reset Password (Confirmar contraseña). Asegúrese de que se mencione la misma contraseña nueva en los campos New Password (Contraseña nueva) y Confirm Password (Confirmar contraseña). De lo contrario, no podrá restablecer la contraseña.
5. Haga clic en Submit (Enviar). La nueva contraseña debe cumplir los siguientes criterios, como se muestra a continuación:
   • Al menos 8 caracteres
   • Al menos 1 letra mayúscula (A-Z)
   • Al menos 1 letra minúscula (a-z)
   • Al menos 1 número (0-9)
   • Al menos 1 carácter especial
6. Haga clic en Volver a inicio de sesión para volver a la página de Inicio de sesión.

Cambiar contraseña

El administrador también puede cambiar la contraseña del usuario en la página Detalles mientras se edita el Perfil de usuario. La pestaña Change Password (Cambiar contraseña) solo aparece para el rol de administrador.

Para cambiar la contraseña, haga lo siguiente:

1. En la página Details (Detalles), haga clic en Change Password (Cambiar contraseña). Aparece la ventana Change Password (Cambiar contraseña) como se muestra a continuación.
   
   
2. Ingrese la nueva contraseña.
3. Ingrese la misma contraseña en el campo Confirmar contraseña para asegurarse de que las contraseñas coinciden. La nueva contraseña debe cumplir los siguientes criterios, como se muestra a continuación:
   • Al menos 8 caracteres
   • Al menos 1 letra mayúscula (A-Z)
   • Al menos 1 letra minúscula (a-z)
   • Al menos 1 número (0-9)
   • Al menos 1 carácter especial
4. Haga clic en Cambiar contraseña para aplicar los cambios. De lo contrario, haga clic en Cancelar para descartar el proceso.

Configure el Estado del usuario como activo/inactivo

Los administradores pueden activar los usuarios o establecerlos como inactivos en la página Detalles mientras se edita el perfil de usuario. Los usuarios que se establecen como inactivos no pueden iniciar sesión en la interfaz de Bot Builder (Consola de Administración de Luma) ni chatear con bots a través de los canales configurados.

Para establecer los usuarios como activos o inactivos:

1. Haga clic en el ícono Edit (Editar) en la página Details (Detalles) para editar los detalles del usuario.
2. Para establecer el estado en Activo o Inactivo, seleccione el botón de alternancia.
3. Haga clic en Save (Guardar) para guardar los cambios.

Asociar usuarios a grupos 

La opción Add Group (Agregar grupo) ayuda a asociar un usuario a uno o más grupos. Los grupos definen el permiso para las habilidades. Un usuario específico puede acceder a todas las habilidades asociadas al grupo público, los grupos de su perfil de usuario y cualquier habilidad específica vinculada directamente a estas (consulte Agregar habilidad a continuación para obtener más información). Los grupos se crean utilizando Groups pestaña en Gestión de usuarios.

Se pueden agregar grupos mientras se edita el usuario. Para agregar un grupo, haga lo siguiente:

1. Haga clic en Add Group (Agregar grupo) en la página Edit User (Editar usuario). Aparece la siguiente ventana:
   
2. Seleccione el grupo necesario de la lista y haga clic en Agregar. Para agregar todos los grupos de la lista, seleccione la casilla de verificación en la cuadrícula del encabezado. De lo contrario, haga clic en Cancel (Cancelar) para salir.

Asociar usuarios con las habilidades

La opción Agregar habilidad ayuda a asociar varias habilidades al usuario. Las habilidades se crean con Skill Builder/wiki/spaces/Luma210ESLA/pages/26357698297

Se pueden agregar habilidades mientras se edita el usuario. Para agregar habilidades, haga lo siguiente:

1. Haga clic en Add Skill (Agregar habilidad) en la página Edit User (Editar usuario).
   
2. Seleccione las habilidades/s solicitadas de la lista y haga clic en Agregar. Para agregar todas las habilidades de la lista, seleccione la casilla de verificación en la cuadrícula del encabezado. De lo contrario, haga clic en Cancel (Cancelar) para salir.

Importar usuarios y grupos

Existen dos opciones para crear usuarios de forma masiva. Un administrador puede utilizar la API de REST o la opción Import Users (Importar usuarios) en la interfaz de usuario. Ambos métodos admiten archivos CSV o JSON.

Importación masiva de usuarios a través de la interfaz de usuario

En esta sección, se describe el proceso para importar un archivo CSV a través de la interfaz de usuario. Esta es una opción fácil para importar usuarios y grupos de forma masiva. La otra opción describe el proceso para crear usuarios y grupos a través de la API y también se admite a través del formato JSON. En la interfaz de usuario, se puede utilizar JSON además de CSV.

1. En la página User Management (Gestión de usuarios), haga clic en Import Users (Importar usuarios). Aparecerá la página siguiente.
   
2. En la página Importar usuarios, haga clic en el archivo Descargar importación de usuarios de muestra. Esto permite descargar un archivo CSV o JSON. Este ejemplo se centra en el formato CSV, así que seleccione CSV y haga clic en Download (Descargar).
   
3. Una vez que haya descargado el archivo CSV, se abrirá en un archivo de MS Excel, hojas de cálculo de Google o en un editor de CSV similar. Agregar los datos al archivo CSV, un usuario por fila. La plantilla de CSV debe contener las columnas obligatorias (indicadas con un *) y, opcionalmente, las otras columnas llamadas aquí.
   • ID 
   • Título 
   • Nombre * 
   • Segundo nombre
   • Apellido *
   • Nombre de usuario * 
   • Dirección de correo electrónico *
   • Teléfono 
   • Rol  
   • Idioma: se establece de forma predeterminada en el idioma del tenant si no se rellena. Los valores válidos son en_US para Inglés, zh_CN para Chino, pt_BR para Brasilero, es_ES para español, etc.
   • Status (Estado): puede ser Active (Activo) o Inactive (Inactivo). De forma predeterminada, el estado se establece como activo si no lo especifica el usuario.
4. Para importar usuarios de forma masiva, se puede crear una hoja de cálculo con los detalles anteriores tal y como se muestra a continuación. Los dos usuarios con un ID ya existen mientras que el usuario sin un ID es nuevo. Para los usuarios existentes, los nuevos datos sobrescribirán los datos existentes salvo para aquellos grupos a los que se agregarán grupos nuevos al usuario.
   
   
   • El tamaño máximo de archivo permitido para la importación de los usuarios a la plataforma es de 5 MB. 
   • Durante la importación, el sistema actualiza los detalles existentes del usuario si se encuentra cualquier registro que coincida utilizando los campos de conciliación: ID o Username (Nombre de usuario).
   • Las columnas State (Estado) y City (Ciudad) son atributos personalizados por el usuario para este tenant.
   • También se pueden agregar grupos durante el proceso de importación. Se pueden especificar varios grupos separándolos con una coma.
5. A continuación, seleccione o arrastre el archivo CSV a la página Import Users (Importar usuarios). El nombre del archivo se rellenará y se puede agregar opcionalmente una descripción para que se tenga un historial de lo que se ha cargado. Haga clic en Import File (Importar archivo) para iniciar la importación.
   
6. Aparecerá la página Estado de la importación actual como se muestra a continuación. Muestra el progreso para procesar y cargar los usuarios y los grupos. Haga clic en el ícono Refresh (Actualizar) para ver el último estado. 
   
7. Una vez finalizado el proceso, haga clic en la fila en la sección historial de importación para ver los detalles de la importación. En la siguiente pantalla User Import Log (Registro de importación de usuarios), se mostrarán el resumen y los detalles del proceso de importación.  
   
   
   
   Es habitual ver advertencias dado que cualquier campo vacío generará una advertencia. Muchos de los campos permiten aprovechar el valor predeterminado y, por lo tanto, dejar en blanco la celda. Se generará una advertencia, ya que se pretende que el registro sea detallado y ofrezca visibilidad completa del proceso de importación.
   
   

Importar grupos y usuarios de forma masiva mediante la API

Un administrador puede crear varios registros de usuario mediante una API y un archivo CSV o JSON en una única operación.

Debe iniciar sesión como tenant antes de ejecutar la API. Se producirá un error en la operación del servicio web si no inicia sesión primero el tenant. En la siguiente imagen, se muestran los detalles de inicio de sesión y de la dirección URL como ejemplo para un método de registro. 

Existen dos API,  BulkUpload-Files y BulkUpload-JSON para importar usuarios en el sistema. La API de BulkUpload-files acepta los registros de los usuarios en la hoja de cálculo y el archivo JSON. BulkUpload-JSON acepta la carga de JSON. Utilice el método de REGISTRO de BulkUpload-files con los parámetros y los valores de los siguientes encabezados y CUERPO. 

En la siguiente imagen, se muestran los valores que se deben especificar en el encabezado.

En la siguiente imagen, se muestran los valores que se deben especificar para el cuerpo.

En la sección archivo, cargue la hoja de cálculo o el archivo JSON que contiene los registros de los usuarios. La plantilla de hoja de cálculo debe contener las columnas obligatorias (indicadas con un *) y, opcionalmente, las otras columnas llamadas aquí.  

• ID 
• Título 
• Nombre * 
• Segundo nombre
• Apellido *
• Nombre de usuario * 
• Dirección de correo electrónico *
• Teléfono 
• Rol  
• Idioma: se establece de forma predeterminada en el idioma del tenant si no se rellena. Los valores válidos son en_US para Inglés, zh_CN para Chino, pt_BR para Brasilero, es_ES para español, etc.
• Status (Estado): puede ser Active (Activo) o Inactive (Inactivo). De forma predeterminada, el estado se establece como activo si no lo especifica el usuario.
  
  

Para importar usuarios de forma masiva, se puede crear una hoja de cálculo con los detalles anteriores tal y como se muestra a continuación.

• El tamaño máximo de archivo permitido para la importación de los usuarios a la plataforma es de 5 MB. 
• Durante la importación, el sistema actualiza los detalles existentes del usuario si se encuentra cualquier registro que coincida utilizando los campos de conciliación: ID o Username (Nombre de usuario).
• Las columnas Estado y Ciudad son atributos personalizados por el usuario
• También se pueden agregar grupos durante el proceso de importación. Se pueden especificar varios grupos separándolos con una coma.

Utilice la  API de BulkUpload para cargar la carga JSON.

En la siguiente imagen, se muestra la descripción del encabezado en la API BulkUpload-JSON:

En la siguiente imagen, se muestra la descripción del cuerpo en la API BulkUpload-JSON:

• Atributos del usuario personalizados

• Un atributo personalizado de usuario es un atributo que se encuentra en todos los perfiles de usuario en el sistema. Estos atributos son útiles para hacer uso de las habilidades. Por ejemplo, es posible que desee ramificar diferentes habilidades para el usuario que reside en dos lugares diferentes, Perú y Colombia.
• Un administrador puede agregar uno o más atributos personalizados por el usuario a través del proceso de importación masiva mediante el uso del formato CSV, el archivo JSON o la carga JSON. Las API de importación de usuarios también actualizan los valores de atributos personalizados por el usuario existentes. Cada atributo se debe representar como una columna en la hoja de cálculo en la que el valor de cada usuario sea la fila correspondiente a la columna. Para representar el atributo personalizado del usuario en el archivo JSON o la carga JSON, consulte el siguiente ejemplo. 
• Establezca el campo customUserAttributes en “null”  (Nulo); a partir de allí, puede agregar varios atributos personalizados por el usuario y sus valores correspondientes como ubicación de oficina, ID del empleado y grupos, como se muestra en el siguiente ejemplo de código.

{
    "id": 1002,
    "lastName": "Marin1111111",
    "userName": "Marin12111",
    "firstName": "Gonzalez1",
    "middleName": "Gutierrez1",
    "role": "Developer",
    "email": "Marin@gmail1.com",
    "phone": "98765432211",
    "title": "Mr",
    "status": "active",
    "language": "es_ES",
    "lastUpdatedSource": "WEB",
    "customUserAttributes": null, 
    "officeLocation": "hyderabad", 
    "employeeId": "1002", 
    "groups": "HR-TEAM,DEVELOPER-TEAM",
    "city":"Hyderabad",  
    "state":"Telangana"
}

• Los atributos del usuario del cliente se referencian en las habilidades y las operaciones utilizando la sintaxis @{user.<CustomUserAttributeName>}. Utilice solo el nombre del atributo personalizado, puesto que no hay ningún identificador del sistema. No hay ningún límite en el número de atributos del perfil del usuario que se pueden agregar.