Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Version History

« Previous Version 2 Next »

Este artigo aborda os seguintes tópicos:

Na interface do Criador de bot, você pode adicionar, editar, ativar e desativar usuários. Isso permite que os usuários possam criar, editar e testar bots e habilidades. Um administrador pode gerenciar funções como administrador, desenvolvedor, agente de suporte e usuário final. Cada função tem permissões específicas para usar o Criador de bot. Para reduzir o esforço gasto na administração de permissões de habilidade, um administrador pode atribuir usuários a grupos e, em seguida, atribuir as habilidades aos grupos.

Para obter mais informações, consulte Define Roles, Permissions, and Groups

Exibir lista de usuários

No painel de navegação esquerdo, expanda Inquilino e selecione Gerenciamento de usuários. A lista de usuários é exibida, conforme mostrado a seguir.

A lista de usuários inclui todos os usuários atualmente no sistema. Ela inclui os seguintes detalhes de usuário:

  • Nome de usuário
  • Email
  • Nome
  • Sobrenome
  • Função
  • Última origem atualizada
  • Modificado pela última vez em (data)
  • Status (ativo/inativo)

É possível classificar todas as colunas em ordem alfabética clicando no nome da coluna no cabeçalho.

Pesquisar usuários

É possível pesquisar usuários existentes na lista de usuários. Para pesquisar um usuário:

  1. Especifique o nome de usuário, email, nome ou sobrenome na caixa de texto Pesquisar.
  2. Pressione a tecla Enter.
    O Criador de bot recupera todos os registros de usuário correspondentes aos detalhes especificados.
  3. Para retornar à lista anterior, exclua os critérios de pesquisa e pressione Enter novamente.

Criar usuários

O administrador pode adicionar novos usuários e atribuir uma função a eles. Para adicionar usuários, siga este procedimento:

  1. Na página Gerenciamento de usuários, clique em Criar usuário.
    A página Criar usuário é exibida, como mostrado abaixo.

  2. Especifique o nome de usuário. Ele é usado para efetuar logon no Criador de bot. Normalmente, é o endereço de email do usuário.
  3. Especifique um endereço de email válido do usuário para comunicações por email, incluindo para redefinições de senha. Por exemplo, joe.user@acmecorp.com
  4. Informe o nome e sobrenome do usuário.
  5. Selecione o idioma de preferência do usuário. Isso afeta os rótulos mostrados na interface do Criador de bot. As opções disponíveis são Inglês e chinês.
  6. Selecione a Função do usuário. Existem três opções:
    • Usuário final
    • Agente de suporte
    • Desenvolvedor
    • Administrador

  7. Click Create to create the user. Else, click Cancel to discard the process.

    Observação

    Após a criação do usuário:

    • Uma ID é automaticamente atribuída ao usuário.
    • O status é definido como Ativo automaticamente.
    • O usuário é atribuído ao grupo público. Todos os usuários estão no grupo público.
    • Se o usuário estiver na função de administrador, ele também será atribuído ao grupo de administradores


Editar usuários

O administrador pode modificar os detalhes do usuário, se necessário. Todos os usuários fazem parte do grupo público e não podem ser removidos dele. O grupo público simplifica a publicação de habilidades para todos os usuários.

As seguintes informações de usuário podem ser editadas:

  • Informações na seção Detalhes
  • Função
  • Grupos 
  • Habilidades

Para editar os usuários existentes, siga estas etapas:

  1. Na lista Usuários, clique na linha do usuário que você deseja editar.
  2. O usuário será exibido no modo somente leitura.
  3. Clique no botão Editar para alterar as informações do usuário. Os campos aparecem editáveis como abaixo.

  4. Para modificar a função existente do usuário, selecione a função necessária na lista suspensa da seção Função. Para saber mais sobre cada função, consulte Define Roles, Permissions, and Groups
  5. Faça as alterações necessárias e clique em Salvar para salvar as alterações. Caso contrário, clique em Cancelar para descartar os dados modificados.

Redefinir a senha

Os administradores podem redefinir a senha de um usuário na página Detalhes durante a exibição do perfil do usuário. A guia Redefinir senha é exibida somente para a função Administrador.

Para redefinir a senha, siga este procedimento:

  1. Na página Detalhes, clique em Redefinir senha. Um email é enviado para o endereço de email registrado do usuário com um link para redefinir a senha, como mostrado abaixo.

     
  2. Clique no link e a tela Redefinir senha será exibida como abaixo.

  3. Digite a nova senha no campo Nova senha.
  4. Digite a mesma senha novamente no campo Confirmar senha. Certifique-se de que a mesma senha seja informada nos campos Nova senha e Confirmar senha. Caso contrário, não será possível redefinir a senha.
  5. Clique em Enviar. A nova senha deve corresponder aos seguintes critérios, conforme mostrado a seguir.
    • Ao menos oito caracteres
    • Ao menos, 1 letra maiúscula (A-Z)
    • Ao menos uma letra minúscula (a-z)
    • Ao menos um número (0-9)
    • Ao menos um caractere especial
  6. Clique em Retornar ao logon para retornar à página de logon.

Alterar senha

O administrador também pode alterar a senha do usuário na página Detalhes durante a edição do perfil do usuário. A guia Alterar senha é exibida somente para a função Administrador.

Para alterar a senha, siga este procedimento:

  1. Na página Detalhes, clique em Alterar senha. A janela Alterar senha é exibida como mostrado abaixo.

  2. Digite a nova senha.
  3. Digite a mesma senha no campo Confirmar senha para garantir que ambas as senhas correspondam. A nova senha deve corresponder aos seguintes critérios, conforme mostrado a seguir.
    • Ao menos oito caracteres
    • Ao menos, 1 letra maiúscula (A-Z)
    • Ao menos uma letra minúscula (a-z)
    • Ao menos um número (0-9)
    • Ao menos um caractere especial
  4. Clique em Alterar senha para aplicar as alterações. Caso contrário, clique em Cancelar para descartar o processo.

Definir o status do usuário como Ativo/Inativo

Os administradores podem tornar os usuários ativos ou defini-los como inativos na página Detalhes durante a edição do perfil do usuário. Os usuários definidos como inativos não podem efetuar logon na interface do Criador de bot nem bater papo com bots em qualquer canal configurado.

Para definir os usuários como ativos ou inativos:

  1. Clique no ícone Editar na página Detalhes para editar os detalhes do usuário.
  2. Defina o status como Ativo ou Inativo selecionando o botão de alternância.
  3. Clique em Salvar para salvar as alterações.

Associar usuários a grupos 

A opção Adicionar grupo ajuda a associar um usuário a um ou mais grupos. Os grupos definem a permissão para habilidades. Um usuário específico pode acessar todas as habilidades associadas ao grupo público, aos grupos em seu Perfil do usuário e a qualquer habilidade específica vinculada diretamente a elas (consulte Adicionar habilidade, abaixo, para obter mais informações). Os grupos são criados usando a guia Groups  em Gerenciamento de usuários.

É possível adicionar grupos ao editar o usuário. Para adicionar um grupo, siga este procedimento:

  1. Clique em Adicionar grupo na página Editar usuário. A seguinte janela é exibida:

  2. Selecione o grupo necessário na lista e clique em Adicionar. Para adicionar todos os grupos da lista, marque a caixa de seleção na grade do cabeçalho. Caso contrário, clique em Cancelar para sair.

Associar os usuários às habilidades

A opção Adicionar habilidade ajuda a associar várias habilidades ao usuário. As habilidades são criadas usando a ação Skill Builder.

É possível adicionar habilidades durante a edição do usuário. Para adicionar habilidades, siga este procedimento:

  1. Clique em Adicionar habilidade na página Editar usuário.

  2. Selecione as habilidades necessárias na lista e clique em Adicionar. Para adicionar todas as habilidades da lista, marque a caixa de seleção na grade do cabeçalho. Caso contrário, clique em Cancelar para sair.

Importar usuários e grupos

Existem duas opções para a criação de usuários em massa. Um administrador pode usar a API REST ou a opção Importar usuários na interface do usuário. As duas abordagens oferecem suporte a arquivos CSV ou JSON.

Importação em massa de usuários por meio da interface do usuário

Esta seção detalha o processo de importar um arquivo CSV por meio da interface do usuário. Essa é uma opção simples para a importação em massa de usuários e grupos. A outra opção detalha o processo de criação de usuários e grupos por meio da API e que também é suportada no formato JSON. JSON pode ser usado além do CSV na interface do usuário.

  1. Na página Gerenciamento de usuários, clique em Importar usuários. A página a seguir é exibida.
  2. Na página Importar usuários, clique no arquivo Download da amostra de importação de usuários. Isso ajuda a fazer download de um arquivo CSV ou JSON. Este exemplo concentra-se no CSV, portanto, selecione CSV e clique em Fazer download.
  3. Depois de fazer download do arquivo CSV, ele é aberto em um arquivo do MS Excel, Google Sheets ou um editor de CSV semelhante. Adicione os dados ao arquivo CSV, um usuário por linha. O modelo CSV deve conter as colunas obrigatórias (indicadas com um *) e, opcionalmente, as outras colunas mencionadas aqui.
    • ID 
    • Título 
    • Nome * 
    • Segundo nome
    • Sobrenome *
    • Nome de usuário * 
    • Endereço de email *
    • Telefone 
    • Função  
    • Idioma –-padroniza para o idioma do inquilino, se não estiver preenchido. Os valores válidos são en_US para inglês e zh_CN para chinês.
    • Status - pode ser ativo ou inativo. Por padrão, o status será definido como ativo se não for especificado pelo usuário.
  4. Para importar usuários em massa, é possível criar uma planilha com os detalhes acima, conforme mostrado a seguir. Os dois usuários com uma ID já existem, enquanto o usuário sem uma ID é novo. Para os usuários existentes, novos dados substituirão os dados existentes, exceto em grupos onde novos grupos serão adicionados ao usuário.

    • O tamanho de arquivo máximo permitido para a importação de usuários na plataforma é de 5 MB. 
    • Durante a importação, o sistema atualiza os detalhes do usuário existente, caso algum registro correspondente seja encontrado usando os campos de reconciliação - ID ou Nome de usuário.
    • As colunas Estado e Cidade são atributos de usuário personalizados para esse inquilino.
    • Os grupos também podem ser adicionados durante o processo de importação. Vários grupos podem ser especificados, bastando separá-los com uma vírgula.
  5. Em seguida, selecione ou arraste o arquivo CSV para a página Importar usuários. O nome do arquivo será preenchido e, se desejar, você pode adicionar uma descrição para ter um histórico do que foi carregado. Clique em Importar arquivo para iniciar a importação.
  6. A página Status da importação atual é exibida, como mostrado abaixo. Ela mostra o andamento do processo e do upload de usuários e grupos. Clique no ícone Atualizar para ver o status mais recente. 
  7. Depois que o processo for concluído, clique na linha da seção Histórico de importação para ver os detalhes da importação. A seguir, a tela Log de importação de usuários mostrará o resumo e os detalhes do processo de importação.  



É comum ver avisos quando qualquer campo vazio produz um aviso. Em muitos dos campos, você pode aproveitar o padrão e, portanto, deixar a célula em branco. Isso irá gerar um aviso, pois o log deveria ser detalhado e dar a você visibilidade total do processo de importação.

Importação em massa de usuários e grupos por meio da API

Um administrador pode criar vários registros de usuário usando uma API e um arquivo CSV ou JSON em uma única operação.

É necessário efetuar logon no inquilino antes de executar a API. A operação de serviço web não será bem-sucedida se você não for conectado ao inquilino primeiro. A imagem a seguir mostra os detalhes de URL e logon como exemplo de um método Post. 

 

Existem duas APIs, BulkUpload-Files e BulkUpload-JSON , para importar usuários no sistema. A API BulkUpload-Files aceita os registros de usuário fornecidos em planilha e arquivo JSON. BulkUpload-JSON aceita a carga JSON. Use o método POST de BulkUpload-Files com os seguintes parâmetros e valores de cabeçalho e corpo. 

A imagem a seguir mostra os valores que devem ser especificados no cabeçalho.

A imagem a seguir mostra os valores que devem ser especificados para o corpo.

Na seção de arquivo, faça upload da planilha ou do arquivo JSON que tem os registros de usuários. O modelo de planilha deve conter as colunas obrigatórias (indicadas com um *) e, opcionalmente, as outras colunas mencionadas aqui.  

  • ID 
  • Título 
  • Nome * 
  • Segundo nome
  • Sobrenome *
  • Nome de usuário * 
  • Endereço de email *
  • Telefone 
  • Função  
  • Idioma –-padroniza para o idioma do inquilino, se não estiver preenchido. Os valores válidos são en_US para inglês e zh_CN para chinês.
  • Status - pode ser ativo ou inativo. Por padrão, o status será definido como ativo se não for especificado pelo usuário.

Para importar usuários em massa, é possível criar uma planilha com os detalhes acima, conforme mostrado a seguir.

  • O tamanho de arquivo máximo permitido para a importação de usuários na plataforma é de 5 MB. 
  • Durante a importação, o sistema atualiza os detalhes do usuário existente, caso algum registro correspondente seja encontrado usando os campos de reconciliação - ID ou Nome de usuário.
  • As colunas Estado e Cidade são atributos de usuário personalizados
  • Os grupos também podem ser adicionados durante o processo de importação. Vários grupos podem ser especificados, bastando separá-los com uma vírgula.

Use a API BulkUpload-JSON para fazer upload da carga JSON.

A imagem a seguir mostra a descrição do cabeçalho na API BulkUpload-JSON:

A imagem a seguir mostra a descrição do corpo na API BulkUpload-JSON:

Atributos de usuário personalizados

Um atributo de usuário personalizado é um atributo existente em todos os perfis de usuário no sistema. Esses atributos são úteis para aproveitamento de habilidades. Por exemplo, você pode querer ramificar diferentes habilidades para o usuário que reside em dois locais diferentes, Peru e Colômbia.

Um administrador pode adicionar um ou mais atributos personalizados de usuário por meio do processo de importação em massa usando CSV, arquivo JSON ou carga JSON. As APIs de importação de usuário também atualizam os valores de atributo de usuário personalizado existentes. Cada atributo deve ser representado como uma coluna na planilha em que o valor para cada usuário é a linha correspondente ao usuário. Para representar o atributo de usuário personalizado no arquivo JSON ou na carga JSON, consulte o exemplo a seguir. 

Defina o campo customUserAttributes como "null"  assim, você pode adicionar vários atributos de usuário personalizados e seus valores correspondentes, como officelocation, employeeid e groups, como mostrado no código de exemplo a seguir.

Exemplo de JSON
{
    "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"
}

Observação

Os nomes de atributo de usuário personalizado devem ser exclusivos e não podem conter espaços. O nome usado na planilha é como o nome deve ser usado no sistema.

Os atributos de usuário do cliente são referidos em habilidades e operações usando a sintaxe @{user.<CustomUserAttributeName>}. Use apenas o nome do atributo personalizado, pois não há identificador do sistema. Não há limites quanto ao número de atributos de perfil de usuário que podem ser adicionados. 

  • No labels