Token de Autenticação

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.