# Como funcionam os grupos de usuários e suas permissões

Grupos de usuários são conjuntos de configurações de acesso que definem o que cada pessoa pode ver e fazer dentro do sistema. Em vez de configurar permissões individualmente para cada usuário, você cria um grupo com as permissões desejadas e vincula os usuários a ele.

No dia a dia, os grupos permitem padronizar o acesso por função: corretores têm acesso ao que precisam, gestores têm uma visão mais ampla e usuários de integração recebem apenas o acesso necessário para a conexão com sistemas externos. Qualquer ajuste feito no grupo se reflete automaticamente em todos os usuários vinculados a ele.

Os grupos são criados e gerenciados nesta rotina. Os usuários são vinculados ao grupo no cadastro de cada usuário ou diretamente a partir desta tela, pelo botão "Gerenciar Usuários".

---

#### **Navegação no módulo**

![entradagrupos.gif](https://ajuda.apresenta.me/uploads/images/gallery/2026-09/S8eentradagrupos.gif)**Rotina:**<span style="white-space: pre-wrap;"> Administrador &gt; Usuários &gt; Grupos de Usuários</span>

---

#### **Como funciona**

[![image.png](https://ajuda.apresenta.me/uploads/images/gallery/2026-09/scaled-1680-/TE7image.png)](https://ajuda.apresenta.me/uploads/images/gallery/2026-09/TE7image.png)A tela principal exibe todos os grupos cadastrados na conta. Para cada grupo, são exibidos o nome, os usuários vinculados (representados pelas iniciais), o tipo do grupo e as datas de criação e de última alteração. A partir dessa listagem, você pode cadastrar novos grupos, remover grupos existentes, gerenciar os usuários de cada grupo e acessar as equipes vinculadas.

<p class="callout info"><span style="white-space: pre-wrap;">Os tipos de grupo disponíveis são: </span>**Normal**<span style="white-space: pre-wrap;">, </span>**Administrador**<span style="white-space: pre-wrap;">, </span>**Área do Cliente**<span style="white-space: pre-wrap;"> e </span>**API**. O tipo determina o nível de acesso base do grupo antes mesmo de configurar permissões específicas.</p>

---

#### **Tipos de grupo**

Cada grupo tem um tipo que define seu perfil de acesso geral. Veja o que cada tipo representa:

<table id="bkmrk-tipodescri%C3%A7%C3%A3onormalp" style="width: 100%; table-layout: fixed;"><colgroup><col style="width: 160px;"></col><col></col></colgroup><tbody><tr><th style="width: 160px; white-space: nowrap;">**Tipo**

</th><th>**Descrição**

</th></tr><tr><td>Normal

</td><td>Perfil padrão para a maioria dos usuários operacionais, como corretores e equipes administrativas. As permissões são configuradas individualmente dentro do grupo.

</td></tr><tr><td>Administrador

</td><td>Acesso ampliado ao sistema, incluindo o painel de administração. Indicado para gestores e responsáveis pela configuração da conta.

</td></tr><tr><td>API

</td><td>Destinado a usuários de integração com sistemas externos. O acesso é limitado às operações necessárias para a conexão via integração.

</td></tr></tbody></table>

<p class="callout warning">Ao definir o tipo "Administrador", o usuário vinculado terá acesso ao painel de administração do sistema. Atribua esse tipo apenas a pessoas de confiança.</p>

---

#### **Cadastrando um novo grupo**

![Formulário de cadastro de grupo](https://ajuda.apresenta.me/uploads/images/gallery/2026-09/VW102-form-cadastro.png)Clique em "Cadastrar" na listagem para abrir o formulário de criação de um novo grupo. Preencha os campos conforme a função que o grupo vai exercer na sua operação.

<table id="bkmrk-campodescri%C3%A7%C3%A3oobriga" style="width: 100%; table-layout: fixed;"><colgroup><col style="width: 160px;"></col><col></col><col style="width: 110px;"></col></colgroup><tbody><tr style="height: 10px;"><th style="width: 160px; white-space: nowrap;">**Campo**

</th><th>**Descrição**

</th><th class="align-center" style="width: 110px; white-space: nowrap; text-align: center;">**Obrigatório**

</th></tr><tr><td>Nome do grupo

</td><td>Identificação do grupo na listagem e no cadastro de usuários. Use nomes descritivos que representem a função, como "Corretores", "Gestores" ou "Equipe Financeira".

</td><td class="align-center" style="text-align: center;">Sim

</td></tr><tr><td>Tipo do grupo

</td><td>Define o perfil de acesso base do grupo. Escolha entre Normal, Administrador, Área do Cliente ou API, conforme explicado na seção anterior.

</td><td class="align-center" style="text-align: center;">Sim

</td></tr><tr><td>Observações

</td><td>Campo livre para registrar informações internas sobre o propósito do grupo, como quais setores ou funções ele abrange. Não é exibido para os usuários vinculados.

</td><td class="align-center" style="text-align: center;">Não

</td></tr></tbody></table>

<p class="callout info">Após criar o grupo, você pode configurar as permissões específicas de acesso para ele. Essa configuração determina quais módulos e ações os usuários do grupo poderão utilizar.</p>

---

#### **Configurando permissões do grupo**

[![configdogrupo.gif](https://ajuda.apresenta.me/uploads/images/gallery/2026-09/configdogrupo.gif)](https://ajuda.apresenta.me/uploads/images/gallery/2026-09/configdogrupo.gif)Dentro do formulário do grupo, você encontra a seção de permissões. Cada permissão corresponde a uma funcionalidade ou módulo do sistema. Marque ou desmarque as opções conforme o que o grupo deve ter acesso. As permissões são organizadas por área, facilitando a configuração por setor de trabalho.

<p class="callout success">Revise as permissões sempre que um novo módulo for ativado na conta ou quando a função de um grupo mudar. Permissões desatualizadas podem liberar acesso indevido ou bloquear funcionalidades necessárias.</p>

**Você também pode definir permissões predefinidas**  
[![image.png](https://ajuda.apresenta.me/uploads/images/gallery/2026-09/scaled-1680-/FmMimage.png)](https://ajuda.apresenta.me/uploads/images/gallery/2026-09/FmMimage.png)

Ao configurar as permissões de um grupo de usuários, o sistema disponibiliza opções predefinidas que facilitam a definição dos acessos.

<table id="bkmrk-op%C3%A7%C3%A3odescri%C3%A7%C3%A3ooperar"><colgroup><col></col><col style="width: 739px;"></col></colgroup><tbody><tr><th>Opção

</th><th>Descrição

</th></tr><tr><td>**Operar**

</td><td>Aplica as permissões necessárias para que o usuário utilize as principais funcionalidades da rotina.

</td></tr><tr><td>**Acesso total**

</td><td>Libera todas as permissões disponíveis para a rotina selecionada.

</td></tr><tr><td>**Limpar**

</td><td>Remove as permissões selecionadas, permitindo realizar uma nova configuração de acesso.

</td></tr></tbody></table>

Essas opções agilizam a configuração, evitando a necessidade de marcar ou desmarcar cada permissão individualmente.

---

#### **Resultado após o cadastro**

Após salvar o grupo, ele aparece na listagem principal. A partir dali, você pode gerenciar os usuários vinculados clicando em "Gerenciar Usuários" na linha do grupo, acessar as equipes relacionadas ou remover o grupo caso não seja mais necessário.

<p class="callout warning">Ao remover um grupo, os usuários vinculados a ele perdem as configurações de acesso daquele grupo. Certifique-se de que esses usuários foram migrados para outro grupo antes de excluir.</p>

---

#### **Duplicando e transferindo responsabilidades**

[![image.png](https://ajuda.apresenta.me/uploads/images/gallery/2026-09/scaled-1680-/C8nimage.png)](https://ajuda.apresenta.me/uploads/images/gallery/2026-09/C8nimage.png)

O sistema oferece duas funcionalidades adicionais acessíveis pela listagem:

**Duplicar grupo:**<span style="white-space: pre-wrap;"> cria uma cópia do grupo com as mesmas configurações de permissões. Útil quando você precisa criar um grupo semelhante a um existente e quer aproveitar as configurações já definidas, ajustando apenas o que for diferente.</span>

**Transferir responsabilidades:**<span style="white-space: pre-wrap;"> permite migrar as pessoas e os imóveis vinculados a um grupo para outro grupo. Use essa função quando um grupo for desativado ou quando houver reorganização de equipes.</span>

[![image.png](https://ajuda.apresenta.me/uploads/images/gallery/2026-09/scaled-1680-/hUXimage.png)](https://ajuda.apresenta.me/uploads/images/gallery/2026-09/hUXimage.png)

Nesta tela, é possível definir para quais grupos serão transferidas as responsabilidades atualmente vinculadas.

<table id="bkmrk-op%C3%A7%C3%A3odescri%C3%A7%C3%A3otransf"><colgroup><col></col><col style="width: 523px;"></col></colgroup><tbody><tr><th>Opção

</th><th>Descrição

</th></tr><tr><td>**Transferir responsabilidade dos clientes para**

</td><td>Selecione o grupo que passará a ser responsável pelos clientes.

</td></tr><tr><td>**Transferir responsabilidade dos imóveis para**

</td><td>Selecione o grupo que passará a ser responsável pelos imóveis.

</td></tr><tr><td>**Transferir Responsabilidades**

</td><td>Confirma e realiza a transferência conforme os grupos selecionados.

</td></tr><tr><td>**Fechar**

</td><td>Encerra a janela sem concluir a transferência.

</td></tr></tbody></table>

<p class="callout danger">A transferência de responsabilidades é uma ação ampla: ela move vínculos de pessoas e imóveis em lote. Revise cuidadosamente o grupo de destino antes de confirmar.</p>

---

#### **Perguntas frequentes**

➜ **Posso ter um usuário em mais de um grupo ao mesmo tempo?**<span style="white-space: pre-wrap;"> Cada usuário é vinculado a um único grupo. Para alterar o grupo de um usuário, acesse o cadastro dele ou utilize a opção "Gerenciar Usuários" na listagem de grupos.</span>

➜ **Qual a diferença entre grupos e equipes?**<span style="white-space: pre-wrap;"> Grupos definem permissões de acesso ao sistema. Equipes são agrupamentos para fins operacionais, como distribuição de tarefas e relatórios. Um usuário pode pertencer a um grupo e a uma ou mais equipes ao mesmo tempo.</span>

➜ **Se eu alterar as permissões de um grupo, todos os usuários são afetados imediatamente?**<span style="white-space: pre-wrap;"> Sim. As permissões do grupo se aplicam a todos os usuários vinculados a ele. Qualquer mudança feita no grupo vale para todos os membros desde o momento em que é salva.</span>

➜ **Como faço para que um usuário tenha acesso a um módulo que hoje está bloqueado para ele?**<span style="white-space: pre-wrap;"> Acesse o grupo ao qual o usuário pertence, edite as permissões e habilite o módulo desejado. Se o usuário precisa de um acesso diferente do restante do grupo, considere criar um grupo específico para ele.</span>

<span style="white-space: pre-wrap;">➜ </span>**O grupo do tipo API pode ser usado por usuários comuns?**<span style="white-space: pre-wrap;"> Não é recomendado. O tipo API é voltado exclusivamente para usuários de integração com sistemas externos. Usuários operacionais devem usar o tipo Normal ou Administrador, conforme o nível de acesso necessário.</span>