> For the complete documentation index, see [llms.txt](https://docs.poweromni.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.poweromni.ai/administracao-e-configuracao/usuarios.md).

# Usuários

A tela de **Usuários** permite gerenciar os usuários da organização no Power Omni, controlando acessos, permissões e licenças de forma centralizada.

O administrador pode criar usuários manualmente ou importar usuários diretamente do **Microsoft Entra ID**, facilitando a administração de acessos em ambientes corporativos.

<figure><img src="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2FFyyAGai7yAdhkz0U82Cz%2Fimage.png?alt=media&amp;token=34f1ac4a-4185-4785-850e-93b794da67ad" alt=""><figcaption></figcaption></figure>

### Visão geral

Na tela de usuários é possível:

* Visualizar todos os usuários cadastrados na organização.
* Consultar informações como nome, e-mail, função e licença associada.
* Associar ou remover licenças.
* Editar informações do usuário.
* Excluir usuários.
* Importar usuários através do Microsoft Entra ID.
* Gerenciar usuários em grande escala através da importação de grupos.

A tela apresenta indicadores gerais da organização:

* **Total de usuários:** quantidade total de usuários cadastrados.
* **Com licença:** usuários que possuem uma licença associada.
* **Sem licença:** usuários cadastrados sem licença vinculada.
* **Administradores:** usuários com permissão administrativa no Power Omni.

***

### Criar usuário

<figure><img src="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2FYY5y0Ed3A81u3XVPUCUD%2Fimage.png?alt=media&amp;token=e772a18f-2d48-4cfd-8167-9b60ecbca7bf" alt=""><figcaption></figcaption></figure>

Para criar um novo usuário manualmente:

1. Acesse **Configurações → Usuários**.
2. Clique no botão **Criar**.
3. Preencha as informações solicitadas.
4. Defina a função do usuário.
5. Salve o cadastro.

O usuário criado ficará disponível na lista de usuários da organização.

***

#### Importar Usuários (Lote)

<figure><img src="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2FW1im2210wpssYY9r5KmE%2Fimage.png?alt=media&amp;token=f58d5c27-8b1d-4f2c-ba76-425d4237555a" alt=""><figcaption></figcaption></figure>

1. Clique no botão "Importar".
2. O arquivo deve ser obrigatoriamente do tipo .CSV e conter uma coluna de e-mail.
3. Atenção: Não inclua cabeçalhos no arquivo. Outras informações como código do país e telefone são opcionais.
4. Selecione o arquivo e confirme a importação.

***

### Importar usuários do Microsoft Entra

O Power Omni permite importar usuários e grupos diretamente do **Microsoft Entra ID**.

Essa funcionalidade facilita a sincronização dos usuários corporativos existentes no ambiente Microsoft, permitindo:

* Importação de usuários individuais.
* Importação de grupos completos.
* Importação automática dos membros pertencentes aos grupos.
* Sincronização dos avatares cadastrados no Microsoft Entra.<br>

<figure><img src="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2FLmDsr2qwUlToE0m0LPtC%2Fimage.png?alt=media&amp;token=dd168150-7c44-4fce-82f2-2fefd6ff6fe2" alt=""><figcaption></figcaption></figure>

Para iniciar a importação:

1. Acesse **Configurações → Usuários**.
2. Clique em **Importar do Entra**.
3. Autorize o acesso ao diretório Microsoft Entra.
4. Selecione os usuários ou grupos desejados.
5. Defina a função dos novos usuários.
6. Clique em **Importar selecionados**.

***

### Autorização de acesso ao Microsoft Entra

<figure><img src="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2Fmb7x8FbcpcGLVizggrbZ%2Fimage.png?alt=media&amp;token=bb1dc2ea-bb55-427a-8358-b6b443c585b0" alt=""><figcaption></figcaption></figure>

Na primeira utilização da importação via Microsoft Entra, o Power Omni solicitará permissão para consultar o diretório corporativo.

É necessário que um usuário com permissão de **Administrador do Tenant Microsoft Entra** conceda o consentimento.

Ao clicar em **Autorizar acesso ao Entra**, será aberta a tela de consentimento da Microsoft.

Após a aprovação:

* O Power Omni poderá consultar usuários e grupos disponíveis no tenant.
* Os administradores poderão realizar importações normalmente.
* Não será necessário conceder o consentimento novamente para novas importações.

Caso o consentimento não seja concedido, a busca de usuários e grupos do Microsoft Entra ficará indisponível.

***

### Importar usuários

Na aba **Usuários**, é possível pesquisar usuários diretamente no Microsoft Entra.

A busca pode ser realizada por:

* Nome do usuário.
* Endereço de e-mail.

Durante a seleção, usuários que já existem no Power Omni serão identificados como **Já importado**.

Usuários existentes não serão duplicados durante o processo de importação.

***

### Importar grupos

Na aba **Grupos**, é possível selecionar grupos existentes no Microsoft Entra.

Ao importar um grupo:

* Todos os membros do grupo serão adicionados ao Power Omni.
* Usuários existentes serão identificados automaticamente.

Essa opção é recomendada para organizações que utilizam grupos corporativos para controle de acesso.

***

### Função dos novos usuários

Durante a importação, o administrador deve selecionar a função que será aplicada aos novos usuários.

A função escolhida será aplicada somente aos usuários que ainda não existem no Power Omni.

Usuários já cadastrados manterão suas configurações atuais.

***

### Sincronização de avatares

Quando o usuário possuir uma imagem cadastrada no Microsoft Entra, o Power Omni realizará a sincronização automática do avatar durante a importação.

Isso permite manter a identificação visual dos usuários alinhada ao diretório corporativo.

***

### Gerenciamento de usuários existentes

Na lista de usuários, o administrador pode realizar ações como:

* Editar informações do usuário.
* Associar ou remover licenças.
* Alterar permissões administrativas.
* Excluir usuários.

As alterações realizadas refletem imediatamente no gerenciamento de acesso da organização.

***

### Níveis de Permissão

O sistema utiliza permissões baseadas em funções para garantir a segurança e a governança dos dados.

<table data-header-hidden><thead><tr><th width="156"></th><th width="368"></th><th></th></tr></thead><tbody><tr><td><strong>Nível</strong></td><td><strong>Descrição de Acesso</strong></td><td><strong>Ideal para...</strong></td></tr><tr><td>Administrador</td><td>Acesso Total. Possui controle completo sobre o sistema, incluindo faturamento, dados fiscais, compra e atribuição de licenças, além de todos os agentes e workspaces.</td><td>Gestores de TI, proprietários da conta e diretores...</td></tr><tr><td>Colaborador</td><td>Gestão de Conteúdo. Pode criar e gerenciar agentes, workspaces e grupos. Tem liberdade para configurar automações (Conectores), mas não possui acesso ao faturamento ou gestão de licenças.</td><td>Líderes de projeto ou departamento, Analistas..</td></tr><tr><td>Usuário</td><td>Acesso Restrito. Só consegue visualizar e interagir com os Agentes de IA que foram explicitamente compartilhados com ele ou com o grupo/Workspace ao qual pertence.</td><td>Equipes de atendimento, vendas ou colaboradores que apenas consomem a IA.</td></tr></tbody></table>

***

### Segurança e Governança

* Hierarquia: Um Colaborador não pode promover a si mesmo ou a outros para Administrador. Essa ação é exclusiva de quem já possui o nível de Adm.
* Visibilidade de Agentes: Lembre-se que para o nível Usuário, não basta estar cadastrado; após o cadastro, você deve ir até as configurações do Agente desejado e dar a permissão de acesso para este usuário ou para o grupo/Workspace dele.

{% hint style="info" %}

### Dica:

Use a função de Colaborador para descentralizar a criação de Agentes entre seus departamentos sem o risco de alterações acidentais no faturamento ou no plano de licenças da empresa.
{% endhint %}

#### Exportar

Para exportar a lista de usuários cadastrados:

* Clique no botão "Exportar" para gerar um arquivo .CSV com a lista completa de usuários, e-mails, permissões e status de licenciamento para fins de auditoria.

#### Gerenciar Licenças

<figure><img src="https://1296644906-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLGvDlIVKG3lx8yU6pzIF%2Fuploads%2FX1yfStnAUpYvetAfDczA%2Fimage.png?alt=media&amp;token=eb99ac93-cf17-485d-b407-42acdd142ea0" alt=""><figcaption></figcaption></figure>

O controle de licenças é feito individualmente na listagem de usuários:

* Atribuir Licença: Para que um usuário consiga logar e utilizar a plataforma, ele precisa de uma licença ativa. Ative a chave de licença na linha correspondente ao usuário.
* Remover Licença: Ao desativar uma licença, ela retorna para o seu "pool" de licenças disponíveis, permitindo que seja atribuída a outra pessoa sem custo adicional.

***