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.
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.
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. Para emitir uma chave, consulte Autenticação.
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 para tratar as respostas da API.