# Agilize Docs para IA - Página atual

Este arquivo contém uma versão focada e legível por IA da página aberta na documentação pública da Agilize.
Use esta versão quando a pergunta do usuário estiver restrita ao documento atual.

Última geração: 2026-09-04T17:56:28.333Z

## Página

- Título: Cadastrar uma equipe organizacional
- URL humana: https://agilize.app/docs/configuracao/acessos-seguranca/cadastrar-equipe-organizacional
- Leitura completa para IA: https://agilize.app/docs/llms.txt
- Descrição: Como criar a hierarquia de equipes, definir supervisores, vincular usuários e validar o escopo de dados por time na Agilize.

## Seções

- Quando usar
- Planejar a estrutura
- Cadastrar a equipe
- Vincular os usuários
- Definir os supervisores
- Entender o efeito no acesso
- Validar a equipe
- Problemas comuns

## Conteúdo da página

# Cadastrar uma equipe organizacional

Equipe organizacional representa a estrutura de gestão da operação. Ela conecta usuários a times, supervisores e subequipes para controlar escopo de dados e leitura de relatórios sem conceder acesso de administrador.

Acesse :ScreenEntry{href="https://my.agilize.app/teamOrg" label="https://my.agilize.app/teamOrg" path="abra Configurações na navbar superior e, na tree de Configurações, selecione Equipes (Organizacional)."}.

Acesso pela tela: abra **Configurações** na navbar superior e, na tree de Configurações, selecione **Equipes (Organizacional)**.

## Quando usar

Use uma equipe organizacional para organizar, por exemplo:

- uma célula comercial e seu líder;
- equipes de atendimento subordinadas a uma coordenação;
- regionais e suas subequipes;
- vendedores que devem ter carteira individual;
- gestores que precisam analisar os registros do time.

Equipe organizacional não é departamento. A equipe organizacional controla hierarquia e escopo de dados; o [departamento](/docs/configuracao/roteamento-distribuicao/cadastrar-departamento) define a fila que recebe e distribui conversas.

## Planejar a estrutura

Antes do cadastro, desenhe uma árvore curta e estável. Exemplo:

---
title: "Exemplo de hierarquia organizacional"
caption: "Uma equipe superior pode reunir subequipes acompanhadas por uma coordenação."
definition: |
  flowchart TD
    A[Comercial] --> B[SDR]
    A --> C[Executivos de vendas]
    A --> D[Pós-venda]
    B --> E[Usuários do time]
    C --> F[Usuários do time]
    D --> G[Usuários do time]
---

Evite criar níveis apenas para reproduzir cargos individuais. Uma hierarquia profunda dificulta auditoria, manutenção e entendimento do acesso.

## Cadastrar a equipe

1. Na tela **Equipes (Organizacional)**, clique em **Adicionar**.
2. Em **Nome**, informe o nome real do time, célula, área ou regional.
3. Em **Descrição**, registre de forma breve a responsabilidade da equipe.
4. Em **Equipe Pai (Org)**, escolha a equipe superior, se houver.
5. Em **Supervisores**, selecione os líderes que devem acompanhar registros e relatórios do time e das subequipes.
6. Clique em **Cadastrar**.

![Formulário de equipe organizacional com equipe pai e supervisores](/docs/screenshots/config-cadastro-equipe-organizacional.png)

A equipe pai não pode ser a própria equipe. Para manter a árvore compreensível, evite também relações circulares entre diferentes níveis.

## Vincular os usuários

Os usuários só podem ser vinculados depois que a equipe for salva.

1. Abra a equipe cadastrada para edição.
2. Na seção **Usuários vinculados**, clique em **Adicionar usuários**.
3. Pesquise por nome ou e-mail.
4. Selecione cada pessoa que pertence ao time.
5. Confirme a lista exibida na própria equipe.

Cada usuário possui uma equipe organizacional principal. Se você adicionar alguém que já pertence a outra equipe, a plataforma solicitará confirmação e moverá a pessoa para a nova equipe. Ela deixará de pertencer à equipe anterior.

Ao remover um usuário da lista, o vínculo de equipe organizacional dele é limpo. Isso pode alterar imediatamente o escopo de dados e relatórios disponível para a pessoa e para seus supervisores.

## Definir os supervisores

Supervisores são diferentes dos usuários vinculados à equipe:

- **Usuários vinculados** são os membros do time.
- **Supervisores** são as pessoas autorizadas a acompanhar o time e suas subequipes nas áreas que aplicam escopo por responsável/equipe.

O supervisor ainda precisa de um [perfil de usuário](/docs/configuracao/acessos-seguranca/cadastrar-perfil-de-usuario) com acesso às telas e relatórios necessários. A supervisão amplia o conjunto de dados visíveis; ela não libera uma tela bloqueada pelo perfil.

Não conceda administrador apenas para resolver visão de time. Prefira configurar a função, a equipe e o supervisor corretamente.

## Entender o efeito no acesso

| Configuração | Efeito esperado |
| --- | --- |
| Usuário com **Registros próprios** | Consulta principalmente os registros atribuídos a ele. |
| Supervisor da equipe | Pode consultar registros dos membros e subequipes nas áreas que respeitam esse escopo. |
| Função sem acesso à tela | A equipe não libera a tela; é preciso ajustar a função. |
| Usuário movido para outra equipe | Deixa o escopo da equipe anterior e passa ao escopo da nova equipe. |
| Administrador | Mantém acesso amplo, independentemente da estrutura de supervisão. |

Esse recorte pode afetar oportunidades, contatos, relatórios, monitoramentos, tarefas, suporte e outros registros associados a um responsável.

## Validar a equipe

1. Entre com um usuário comum que seja membro da equipe.
2. Confirme que **Registros próprios** limita a carteira quando essa for a política.
3. Entre com um supervisor não administrador.
4. Abra as mesmas telas e relatórios.
5. Confirme que o supervisor vê o time e, quando aplicável, as subequipes.
6. Verifique se um usuário externo ao time continua fora do escopo.
7. Teste filtros por responsável, equipe e período.

## Problemas comuns

| Sintoma | O que verificar |
| --- | --- |
| A seção de usuários está bloqueada | Salve a equipe primeiro e abra o cadastro novamente. |
| Um usuário desapareceu da equipe anterior | Ele foi movido porque cada usuário possui uma equipe organizacional principal. |
| O supervisor não vê os dados do time | Confirme se ele está em **Supervisores**, se os membros estão vinculados e se a função libera a tela. |
| O membro vê registros demais | Revise **Registros próprios**, função e acesso administrativo. |
| O relatório mostra menos dados que o esperado | Revise período, filtros, fonte de dados, responsáveis e hierarquia de equipes. |
| Não é possível escolher a própria equipe como pai | Esse vínculo é inválido; selecione uma equipe superior diferente ou deixe o campo vazio. |

## Resultado esperado

A equipe fica salva com posição clara na hierarquia, supervisores definidos e usuários vinculados. Membros e líderes passam a consultar o escopo de dados coerente com a política da operação.

## Próximos passos

- [Cadastrar um usuário](/docs/configuracao/acessos-seguranca/cadastrar-usuario)
- [Escopo de dados por equipe organizacional](/docs/configuracao/acessos-seguranca/escopo-dados-equipe-organizacional)
- [Cadastrar um perfil de usuário](/docs/configuracao/acessos-seguranca/cadastrar-perfil-de-usuario)
- [Usuários, equipes e permissões](/docs/configuracao/acessos-seguranca/usuarios-equipes-e-permissoes)