O Token é um código de autenticação, utilizado para validar a conta do usuário e autorizar a integração com outras ferramentas.
Para saber como criar, visualizar e gerenciar o Token, basta acessar aqui.
Cada usuário do RD CRM possui um Token único e imutável, cujas permissões de uso da API são definidas pelo nível de Visibilidade do usuário.
A visibilidade define quais informações referentes a Negociações, Empresas e Contatos cada usuário poderá visualizar.
Visibilidade dos resultados
Os níveis de visibilidade são divididos entre três categorias:
- Negociações
- Empresas
- Contatos
E os níveis possuem as seguintes especificidades:
- Restrito: o usuário só poderá visualizar as informações pelas quais é responsável, dentro da categoria definida.
- Equipe: o usuário poderá visualizar as informações de todos que façam parte de sua equipe, dentro da categoria definida.
- Geral: o usuário poderá visualizar todas as informações da categoria definida, sem restrição.
Rotas dependentes do nível de Visibilidade
As rotas cujas requisições e resultados são influenciados pelo nível de Visibilidade do usuário detentor do Token, são:
- Negociações
- Empresas
- Contatos
- Tarefas
Como funciona na prática?
Para exemplificar, veja abaixo como funciona o retorno da API no gerenciamento de negociações conforme o nível de visibilidade do usuário dono do Token na categoria de "Negociações":
Nível de Visibilidade: Restrito
-
Ao interagir com a rota de Listar negociações, serão retornadas somente as negociações cujo Responsável é o dono do Token.
-
Ao interagir com a rota de Exibir negociações, a negociação só será exibida se o deal_id passado na Query for referente a uma negociação que o dono do Token é Responsável.
-
Ao interagir com a rota de Atualizar negociações, você só conseguirá atualizar negociações cujo Responsável é o dono do Token.
-
Ao interagir com a rota de Criar negociações, você conseguirá criar Negociações para outros usuários, mas só conseguirá visualizar negociações criadas com o dono do Token como Responsável.
Nível de Visibilidade: Equipes
-
Ao interagir com a rota de Listar negociações, serão retornadas somente as negociações cujo dono do Token é Responsável e dos usuários das Equipes que o dono do Token faz parte.
-
Ao interagir com a rota de Exibir negociações, a negociação só será exibida se o deal_id passado na Query for referente a uma negociação cujo Responsável é o dono do Token ou um dos usuários das Equipes que o dono do Token faz parte.
-
Ao interagir com a rota de Atualizar negociações, você só conseguirá atualizar negociações cujo Responsável é o dono do Token ou um dos usuários das Equipes que o dono do Token faz parte.
-
Ao interagir com a rota de Criar negociações, você conseguirá criar Negociações para outros usuários, mas só conseguirá visualizar negociações criadas com o dono do Token como Responsável ou criadas com um dos usuários das Equipes que o dono do Token faz parte como Responsável.
Nível de Visibilidade: Geral
Consegue listar, exibir, criar e atualizar todas Negociações, independentemente de qual usuário é Responsável.
Atenção: a funcionalidade Visibilidade está disponível apenas para clientes do plano Basic e Pro.