# Tipos de acesso e permissões

A chave da API pública representa o membro que a criou. Cada chamada usa as permissões desse membro e seu workspace. O acesso também depende dos registros visíveis e dos recursos disponíveis.

## Papéis padrão

Os papéis definem permissões padrão e visibilidade dos negócios. Use esta tabela como referência inicial:

| Papel                                  | Indicado para                                                  | Acesso e permissões padrão                                                                                                                                                                                                      |
| -------------------------------------- | -------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Administrador                          | Diretores, responsáveis pela operação e gestores de TI         | Acessa todos os dados do workspace e tem todas as permissões padrão. Gerencia membros, integrações e configurações. Algumas alterações são exclusivas do Proprietário.                                                          |
| Gerente                                | Coordenadores e supervisores comerciais                        | Acessa os próprios negócios e os dos membros dos squads que gerencia. Pode reatribuir leads, consultar métricas do squad e exportar leads. Sem squad gerenciado, vê apenas os próprios negócios.                                |
| Closer                                 | Executivos de contas e vendedores responsáveis pelo fechamento | Acessa negócios sob sua responsabilidade. Conduz negociações, envia propostas conforme o processo comercial e registra o fechamento no funil. Pode usar agenda e conversas nos canais autorizados.                              |
| SDR (Sales Development Representative) | Pré-vendedores responsáveis por prospecção e qualificação      | Acessa negócios sob sua responsabilidade. Cria contatos e negócios, qualifica leads e faz o primeiro atendimento. A entrega ao Closer segue as regras de distribuição. Reatribuir manualmente exige a permissão correspondente. |

O **Proprietário** é um papel separado do Administrador. Ambos acessam todos os dados do workspace. Algumas configurações, como compartilhamento de leads e alvos de distribuição de tarefas, ficam reservadas ao Proprietário. O papel Proprietário não aparece no convite de membros.

Quando a API retorna um papel, ela usa um identificador em minúsculas: `admin`, `manager`, `closer` ou `sdr`. O Proprietário usa `owner`.

## Entenda as camadas de acesso

O papel é apenas uma das regras que determinam o acesso:

- **Permissões** definem ações, como criar negócios, exportar leads ou enviar mensagens. É possível personalizar permissões individuais em **Configurações** > **Acessos**, conforme o acesso de quem administra o workspace.
- **Visibilidade** define quais negócios cada membro pode abrir. Responsável, corresponsável, compartilhamento de leads, squad e acesso ao funil podem alterar esse alcance.
- **Canais** controlam quais conversas o membro pode acompanhar e por quais números pode enviar mensagens. Enviar exige a permissão de mensagens e acesso ao canal.
- **Recursos do workspace** também limitam a API. Por exemplo, conversas e automações exigem acesso à API avançada; calendário exige o recurso de calendário.

Para revisar presença, papéis, squads e permissões individuais, consulte [Gerenciar membros, presença e acessos](/configuracoes/membros/). Para emitir uma chave, consulte [Autenticação](/developers/authentication/).

## Interprete erros de acesso

Uma resposta `403` pode indicar falta de permissão, de acesso ao canal ou de um recurso necessário. Uma resposta `404` pode indicar que o negócio não existe ou está fora da visibilidade do membro. Consulte [Identificadores, paginação e erros](/developers/boas-praticas/) para tratar as respostas da API.