> ## Documentation Index
> Fetch the complete documentation index at: https://muveya.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Equipe

> Veja as pessoas da sua clínica odontológica, convide novas e mude a função, as permissões e o acesso delas a unidades e depósitos, ou suspenda, reative e remova pessoas.

As telas de **Equipe** são onde você decide quem trabalha na sua clínica odontológica e o que cada pessoa pode alcançar. O acesso de uma pessoa tem três partes, e você define cada uma aqui:

* uma **função** (**Proprietário**, **Administrador** ou **Membro**), que é um modelo com algumas permissões incluídas;
* **permissões**, as ações e as informações que a pessoa pode usar;
* **unidades e depósitos**, os locais onde essas permissões valem.

[Funções e permissões](/docs/pt/account/roles-and-permissions) explica o que significa cada uma.

## Quem pode fazer

| Você é | O que pode fazer em Equipe |
| - | - |
| **Proprietário** | Tudo o que vem abaixo, incluindo convidar administradores, mudar funções e transferir a propriedade. |
| **Administrador** | Ver a equipe, convidar membros, reenviar e revogar convites, mudar permissões e acesso a unidades, suspender, reativar e remover. Você não pode convidar um administrador, mudar funções nem transferir a propriedade, e não pode suspender, reativar, remover nem mudar o acesso a unidades de um proprietário. |
| **Membro** com `members.manage` | O mesmo que um administrador. |
| **Membro** sem `members.manage` | Nada. **Equipe** não aparece no seu menu, e abrir `/members` mostra **Você não tem acesso à administração da equipe. Consulte o administrador da sua clínica.** |

Proprietários e administradores sempre têm `members.manage` pela função. Além da função, algumas ações têm limites próprios, indicados em cada seção: ninguém muda o próprio acesso a unidades, e você só pode conceder as unidades e os depósitos que você mesmo alcança.

## Onde

* **Equipe** no menu principal, `console.muveya.com/members`: a lista de pessoas e **Convites pendentes**.
* **Convidar pessoa**, `console.muveya.com/members/invite`.
* A página de uma pessoa, `console.muveya.com/members/` seguido do id dela, que abre ao selecionar o nome.

No **Início**, uma clínica nova mostra o cartão **Convide a sua equipe** (**Você é a única pessoa desta conta da clínica.**) para quem pode convidar.

## Veja a equipe

A tela **Equipe** (**Gerencie a equipe da sua clínica odontológica e seus acessos.**) mostra uma tabela com três colunas:

| Coluna | O que mostra |
| - | - |
| **Pessoa** | O nome da pessoa (um link para a página dela) e, abaixo, o e-mail. **Perfil indisponível** se o perfil não puder ser lido. |
| **Função** | **Proprietário**, **Administrador** ou **Membro**. |
| **Status** | **Ativo** ou **Suspenso**. **Conta desativada** se a própria conta muveya da pessoa estiver desativada. |

* Use o filtro **Status** para ver **Todos os status**, **Ativo** ou **Suspenso**.
* A tabela mostra 50 pessoas por página. Use **Página anterior** e **Próxima página**; a página atual aparece como **Página** seguido do número.
* Pessoas removidas não aparecem.

Estados vazios e de erro: **Não há membros suspensos**, **Não há membros nesta página. Volte para a página anterior.**, **A equipe não está disponível. Tente novamente.** (com **Tentar novamente**) e **Carregando a equipe…** enquanto carrega.

Esta tela não tem busca.

## Convide uma pessoa

**Quem pode fazer:** qualquer pessoa com `members.manage`. Só um **Proprietário** pode convidar um **Administrador**.

<Steps>
  <Step title="Abra o formulário">
    Em **Equipe**, selecione **Convidar pessoa**. A tela diz **Convide alguém por e-mail para entrar nesta clínica odontológica com o acesso que você escolher.**
  </Step>

  <Step title="Pessoa">
    Informe o **E-mail**, escolha o **Idioma do e-mail** (English, Español ou Português; o idioma do console vem selecionado) e a **Função**: **Membro**, ou **Administrador** se você for proprietário.
  </Step>

  <Step title="Permissões">
    Marque as permissões que a pessoa recebe **além** da função. A dica diz **Selecione as permissões que esta pessoa recebe além das incluídas na sua função. Você só pode conceder acessos que possui.** As permissões ficam agrupadas em **Catálogo**, **Estoque**, **Pedidos**, **Aprovações**, **Atendimento**, **Relatórios e auditoria** e **Administração**.
  </Step>

  <Step title="Unidades e depósitos">
    Em **Acesso às unidades** escolha **Todas as unidades desta conta** ou **Unidades selecionadas**; em **Acesso aos depósitos** escolha **Todos os depósitos desta conta** ou **Depósitos selecionados**. Com uma opção "selecionados", marque pelo menos um local na lista.
  </Step>

  <Step title="Crie o convite">
    Selecione **Criar convite**. A tela mostra **Convite criado para** o e-mail, com **Estamos enviando o e-mail. Isso não confirma que a pessoa o recebeu; você pode reenviá-lo na página da equipe quando o reenvio estiver disponível.** Selecione **Voltar para a equipe** ou **Convidar outra pessoa**.
  </Step>
</Steps>

Nas listas de locais, os inativos aparecem marcados **(inativo)**, e cada depósito aparece com sua unidade, ou com **Depósito central** se for um depósito central. Se ainda não houver locais, a lista diz **Ainda não há unidades para atribuir.** ou **Ainda não há depósitos para atribuir.** "Todos" também cobre as unidades e os depósitos criados depois.

Ao marcar **Ajustar e contar estoque**, o console também marca e bloqueia **Receber entregas**, **Registrar consumo** e **Transferir caixas entre depósitos**, com a nota **(Incluído em Ajustar e contar estoque)**, porque essa permissão já as inclui.

**Regras e limites**

* **E-mail:** um endereço válido, até 320 caracteres. É salvo em letras minúsculas.
* **Função:** **Membro** ou **Administrador**. Ninguém pode ser convidado como **Proprietário**; a propriedade é transferida depois.
* **Permissões:** cada permissão marcada precisa ser uma que você tem (incluindo as que sua função dá). O formulário mostra todas as permissões; o servidor recusa as demais.
* **Locais:** se o seu acesso se limita a algumas unidades ou depósitos, você só pode oferecer esses, e não pode oferecer "todos". Um convite sempre concede pelo menos uma unidade e um depósito, ou todos; "nenhuma unidade" só pode ser definido depois, na página da pessoa.
* **Um convite por e-mail:** enquanto houver um convite pendente para esse e-mail, você não pode criar outro. Reenvie ou revogue o existente.
* **Validade:** o link vale 24 horas.

**O que o sistema registra:** um convite pendente com a função, as permissões e os locais escolhidos, os nomes desses locais (para que a pessoa convidada veja nomes e não ids), quem enviou e um registro de auditoria. O e-mail é enviado em segundo plano, então a confirmação nunca significa que ele foi entregue. Nada é criado para a pessoa convidada até ela aceitar. O que a pessoa convidada vê está em [Entrar](/docs/pt/account/sign-in), seção **Aceite um convite**.

## Gerencie os convites pendentes

Abaixo da lista de pessoas, **Convites pendentes** mostra cada convite que ainda está em `pending`, de 50 em 50 (**Convites anteriores** e **Mais convites** mudam de página).

| Coluna | O que mostra |
| - | - |
| **E-mail** | O endereço convidado. |
| **Função** | A função oferecida. |
| **Expira** | Data e hora em que o link atual deixa de funcionar. |
| **Ações** | **Reenviar convite** e **Revogar convite**. |

Quando não há nenhum, a seção diz **Não há convites pendentes.**

### Reenvie um convite

1. Selecione **Reenviar convite** na linha.
2. A caixa de diálogo diz **Confirmar para** o e-mail, e **Enviaremos um novo e-mail com um link novo, e o link anterior deixará de funcionar. O acesso oferecido continua o mesmo.**
3. Selecione **Reenviar este convite**. A seção mostra **Um novo e-mail para** seguido do endereço, e informa que **Isso não confirma que a pessoa o recebeu.**

Um reenvio cria um link novo válido por 24 horas e cancela o anterior. Você pode reenviar um convite no máximo uma vez por minuto; até lá o botão fica desativado e a linha mostra **Você poderá reenviá-lo a partir de** seguido do horário. Para reenviar, você precisa poder emitir hoje esse mesmo convite (a função, as permissões e os locais dele). O convite mantém quem o enviou originalmente.

### Revogue um convite

1. Selecione **Revogar convite** na linha.
2. A caixa de diálogo diz **O convite é cancelado e o link do e-mail deixa de funcionar. Para convidar esta pessoa novamente, crie um novo convite.**
3. Selecione **Revogar este convite**. A seção mostra **O convite para** seguido do endereço **foi revogado.**

Selecione **Cancelar** ou **Fechar** para sair de qualquer uma das caixas de diálogo sem mudanças.

### Ciclo de vida de um convite

| Estado | O que significa | Onde você vê |
| - | - | - |
| `pending` | Enviado e aguardando a pessoa convidada. | **Convites pendentes**. |
| `accepting` | A pessoa convidada está concluindo a aceitação neste momento. | Não aparece na lista. |
| `accepted` | A pessoa entrou. | A pessoa aparece na lista da equipe. |
| `revoked` | Você o revogou. O link não funciona mais. | Sai da lista. |
| `expired` | Não é usado por enquanto: um convite cujo tempo acabou continua em `pending` (veja a nota abaixo). | Não aparece na lista. |

<Note>
  Um convite cujo horário de **Expira** já passou continua em **Convites pendentes**: o link não funciona mais, mas o convite segue pendente e ainda impede criar outro para o mesmo e-mail. Reenvie-o para mandar um link novo de 24 horas, ou revogue-o.
</Note>

Se a pessoa convidada vir **O administrador da clínica precisa revisar este convite**, quem enviou o convite não tem mais a função, as permissões ou os locais que ele oferece (por exemplo, porque foi suspenso). Um reenvio mantém esse remetente, então não resolve: revogue o convite e crie um novo você mesmo.

O console não mostra convites aceitos, revogados ou expirados.

## Abra a página de uma pessoa

Selecione um nome na lista. A página (**Confira a função, as permissões e o acesso operacional desta pessoa.**) mostra **E-mail**, **Função** e **Status**, e depois as seções abaixo. **Voltar para a equipe** retorna à lista.

* Se o status é **Ativo**, você vê **Função** (só proprietários), **Permissões**, **Unidades e depósitos** e as ações disponíveis.
* Se o status é **Suspenso**, você vê **Esta associação está suspensa. Suas permissões não podem ser editadas.**, a lista de permissões que ela tem, e **Reativar acesso** e **Remover da clínica**.
* Se o perfil não puder ser lido, a página mostra **Este perfil está incompleto. Atualize o membro antes de editar seu acesso.** e nenhum editor.

### Mude a função

**Quem pode fazer:** um **Proprietário**, para uma pessoa que não é proprietária. Nos outros casos, a seção não aparece.

1. Em **Função**, escolha **Administrador** ou **Membro**. A seção explica **Somente um proprietário pode alterar funções. A propriedade é transferida separadamente.**
2. Selecione **Salvar função**. A seção mostra **Função salva**.

**O que acontece:** a nova função vale na hora. As permissões concedidas além da função são mantidas (**A função inclui as permissões indicadas. As atribuições adicionais são mantidas ao alterar a função.**). A sessão da pessoa é encerrada em todos os lugares e ela precisa entrar de novo.

**Limites:** você não pode mudar a função de um proprietário (transfira a propriedade em vez disso). Para promover alguém a **Administrador**, o seu acesso a unidades e depósitos precisa cobrir o dela.

### Mude as permissões

**Quem pode fazer:** qualquer pessoa com `members.manage`, para qualquer pessoa ativa, inclusive você.

1. Em **Permissões** (**Escolha as informações e operações que esta pessoa pode acessar.**), marque ou desmarque permissões.
2. Selecione **Salvar permissões**. A seção mostra **Permissões salvas**.

* As permissões que vêm da função aparecem marcadas, bloqueadas e com a nota **(Incluído na função)**.
* As permissões incluídas em **Ajustar e contar estoque** aparecem marcadas, bloqueadas e com a nota **(Incluído em Ajustar e contar estoque)**.
* O console salva só o que você marcou. A lista salva substitui totalmente a anterior.

**O que acontece:** a mudança vale a partir da próxima ação da pessoa. A sessão dela não é encerrada.

**Limites:** conceder **Gerenciar acesso da equipe** (`members.manage`) também dá à pessoa autoridade sobre os locais dela, então o seu acesso a unidades e depósitos precisa cobrir o dela.

<Tip>
  É assim também que um **Proprietário** novo ganha acesso operacional: abra sua própria página e marque, por exemplo, **Ver estoque**, **Criar pedidos de materiais** ou **Ver relatórios**. Nenhuma função as inclui.
</Tip>

### Mude o acesso a unidades e depósitos

**Quem pode fazer:** qualquer pessoa com `members.manage`, para outra pessoa. Só um proprietário pode mudar o acesso de um proprietário.

1. Em **Unidades e depósitos**, o texto diz **Para cada tipo, escolha se esta pessoa acessa todos, alguns ou nenhum. “Todos” inclui os criados depois.**
2. Em **Acesso às unidades** escolha **Todas as unidades desta conta**, **Unidades selecionadas** ou **Nenhuma unidade**. Em **Acesso aos depósitos** escolha **Todos os depósitos desta conta**, **Depósitos selecionados** ou **Nenhum depósito**.
3. Com uma opção "selecionados", marque os locais.
4. Selecione **Salvar acesso aos locais**. A seção mostra **Acesso aos locais salvo** e um resumo como **Unidades: todas · Depósitos:** seguido dos nomes dos depósitos.

As notas abaixo de cada opção a explicam:

* **Inclui as unidades criadas depois.** / **Inclui os depósitos criados depois.**
* **Não verá pedidos, aprovações nem custódia de nenhuma unidade.** (com **Nenhuma unidade**)
* **Não verá nem movimentará estoque em nenhum depósito.** (com **Nenhum depósito**)

**Limites:**

* Na sua própria página a seção fica bloqueada e diz **Você não pode alterar seus próprios locais e depósitos. Peça a outra pessoa que administre a equipe.**
* Você só pode conceder locais que você alcança, e "todos" só se você tiver "todos".
* **Selecionados** sem nada marcado é recusado: **Escolha pelo menos uma unidade, ou selecione “Nenhuma unidade” se esta pessoa não deve ter acesso.** (ou a versão de depósitos). Escolha **Nenhuma unidade** ou **Nenhum depósito** de forma explícita.
* Um local que não existe mais aparece como **Local indisponível** seguido de um número; desmarque-o para removê-lo.
* Até 500 unidades e 500 depósitos por pessoa.

**O que acontece:** o novo acesso vale a partir da próxima ação da pessoa. Veja [Funções e permissões](/docs/pt/account/roles-and-permissions) para saber o que ele limita.

### Suspenda o acesso

**Quem pode fazer:** qualquer pessoa com `members.manage`. Só um proprietário pode suspender um proprietário.

1. Em **Suspender acesso**, leia **Esta pessoa perderá o acesso a esta conta da clínica e suas sessões ativas serão revogadas.**
2. Selecione **Suspender acesso** e depois **Suspender esta pessoa** na caixa de diálogo.

**O que acontece:** o vínculo passa a **Suspenso** na hora. A sessão da pessoa é encerrada em todos os dispositivos, e toda sessão, chave de API e vínculo do WhatsApp emitidos antes da suspensão deixam de funcionar. A clínica mantém o histórico dela. Um registro de auditoria é gravado.

### Reative o acesso

**Quem pode fazer:** qualquer pessoa com `members.manage`. Só um proprietário pode reativar um proprietário. O seu acesso a unidades e depósitos precisa cobrir o da pessoa.

1. Na página de uma pessoa suspensa, selecione **Reativar acesso**. A caixa de diálogo diz **Esta pessoa recupera o acesso com sua função, permissões e locais atuais. Sessões, chaves de API e vínculos do WhatsApp anteriores à suspensão continuam encerrados; ela precisará entrar novamente.**
2. Selecione **Reativar esta pessoa**.

**O que acontece:** o vínculo volta a **Ativo** com a mesma função, as mesmas permissões e os mesmos locais. A pessoa entra de novo. Um registro de auditoria é gravado.

### Remova alguém da clínica

**Quem pode fazer:** qualquer pessoa com `members.manage`, para uma pessoa ativa ou suspensa que não seja você. Só um proprietário pode remover um proprietário.

1. Selecione **Remover da clínica**. A caixa de diálogo diz **Esta pessoa perderá o acesso à conta da clínica e suas sessões serão encerradas. O histórico dela permanece na clínica; para voltar, precisará de um novo convite.**
2. Selecione **Remover esta pessoa**. Você volta para a lista da equipe.

**O que acontece:** o acesso termina na hora, toda sessão, chave de API e vínculo do WhatsApp emitidos antes da remoção deixam de funcionar, a pessoa sai da lista, e o nome dela continua nos registros de que participou (pedidos, movimentos, aprovações). Para que ela volte, envie um convite novo: ao aceitar, ela volta com o acesso desse convite. Um registro de auditoria é gravado.

### Transfira a propriedade

**Quem pode fazer:** um **Proprietário**, para outra pessoa ativa.

1. Na página da outra pessoa, selecione **Transferir propriedade**. A caixa de diálogo diz **A pessoa escolhida será proprietária e você será administrador. Ambas as contas precisarão entrar novamente.**
2. Selecione **Transferir propriedade** na caixa de diálogo.

**O que acontece:** a pessoa passa a **Proprietário** e você a **Administrador**, em um só passo. As sessões das duas contas são encerradas em todos os lugares. O seu acesso a unidades e depósitos precisa cobrir o dela.

## Proteção do último proprietário

Uma clínica odontológica sempre mantém pelo menos um **Proprietário** ativo. Suspender ou remover o único proprietário ativo é recusado com **A conta da clínica precisa manter um proprietário ativo. Transfira a propriedade antes de remover esse acesso.** A função de um proprietário também não pode ser mudada na seção **Função**: transfira a propriedade primeiro.

## O que pode dar errado

| Mensagem | Por quê | O que fazer |
| - | - | - |
| **Você não tem acesso à administração da equipe. Consulte o administrador da sua clínica.** | Você não tem `members.manage`. | Peça a um proprietário ou administrador. |
| **Informe um e-mail válido.** | O e-mail do convite está mal escrito. | Corrija-o. |
| **Escolha pelo menos um local ou selecione acesso a todos.** | **Selecionados** sem nada marcado no formulário de convite. | Marque um local ou escolha "todos". |
| **Este e-mail já tem um convite pendente. Reenvie-o na página da equipe.** | Existe um convite pendente para esse e-mail (mesmo que o horário tenha passado). | Reenvie ou revogue em **Convites pendentes**. |
| **Algumas permissões ou locais selecionados não podem ser concedidos. Revise a seleção.** | Uma permissão que você não tem, um local fora do seu acesso, "todos" quando você só alcança alguns locais, nenhum local escolhido, ou um local que não existe. | Desmarque o que você não pode conceder, ou peça a um proprietário. |
| **Somente um owner pode convidar um administrador ou alterar esta função. Escolha a função de membro ou peça a um owner.** | A ação exige um proprietário, ou você não tem `members.manage`. | Peça a um proprietário. |
| **Esta pessoa já faz parte desta clínica.** | A pessoa já é membro ativo ou suspenso. | Abra a página dela. |
| **Este convite mudou desde que você abriu a lista. Revise-o antes de tentar novamente.** | Alguém o reenviou ou revogou nesse meio-tempo. | Recarregue a lista. |
| **Este convite não está mais pendente.** | Foi aceito ou revogado. | Recarregue a lista. |
| **A conta da clínica precisa manter um proprietário ativo. Transfira a propriedade antes de remover esse acesso.** | Proteção do último proprietário. | Transfira a propriedade primeiro. |
| **Uma permissão está indisponível. Atualize este membro antes de tentar novamente.** | O nome de uma permissão não foi reconhecido. | Recarregue a página e salve de novo. |
| **Você não pode alterar seus próprios locais e depósitos. Peça a outra pessoa que administre a equipe.** | Você tentou mudar o próprio acesso a unidades. | Peça a outra pessoa que administre a equipe. |
| **Você só pode alterar o acesso de pessoas que estejam totalmente dentro dos seus locais e depósitos, e somente para esses. Peça a alguém com acesso a todos os locais.** | A pessoa, ou o acesso escolhido, vai além dos seus próprios locais. | Peça a alguém com acesso a todos os locais. |
| **Confira as permissões e os locais selecionados.** | O formulário tem um valor inválido. | Recarregue e tente de novo. |
| **A conta de clínica odontológica ativa mudou. Recarregue a página antes de tentar novamente.** | Você mudou de clínica em outra aba. | Recarregue a página. |
| **Sua conta não tem permissão para esta ação.** | O servidor recusou a ação para o seu acesso. | Peça a um proprietário. |
| **Este registro não está disponível na conta de clínica odontológica ativa.** | A pessoa não é membro desta clínica (ou foi removida). | Volte para a lista. |
| **Não foi possível concluir a solicitação. Tente novamente.** | Um erro temporário, ou um reenvio antes da espera de um minuto. | Aguarde um momento e tente de novo. |
| **Não foi possível confirmar a operação. Verifique sua conexão e a lista antes de tentar novamente.** | Sem rede ao salvar. | Confira a lista antes de repetir. |

## O que você ainda não pode fazer

* Buscar ou exportar a lista da equipe.
* Editar o nome ou o e-mail de uma pessoa (cada pessoa os tem na própria conta).
* Ver convites aceitos, revogados ou expirados, ou editar o acesso de um convite pendente (revogue-o e crie um novo).
* Ler o histórico de auditoria das mudanças da equipe: ele é gravado, mas nenhuma tela o mostra.

## Páginas relacionadas

<CardGroup cols={2}>
  <Card title="Funções e permissões" icon="key" href="/docs/pt/account/roles-and-permissions">
    O catálogo completo de permissões e o que cada uma libera.
  </Card>

  <Card title="Entrar" icon="right-to-bracket" href="/docs/pt/account/sign-in">
    O que a pessoa convidada vê.
  </Card>

  <Card title="Unidades" icon="building" href="/docs/pt/locations/clinics">
    Crie as unidades que você atribui às pessoas.
  </Card>

  <Card title="Depósitos" icon="warehouse" href="/docs/pt/locations/warehouses">
    Crie os depósitos que você atribui às pessoas.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.