Base de conhecimento

Quer integrar o Octadesk com seus sistemas externos (ERP, CRM ou E-commerce) de forma muito mais segura? Temos uma novidade incrível para te apresentar!

Se você já utiliza nossas integrações, sabe que a segurança dos dados é prioridade. Por isso, criamos uma forma de você esconder suas chaves de API.

Vamos lá? 😉

O que são Tokens Externos?

Quando você conecta o Octadesk a outro sistema, esses sistemas pedem uma "chave de porta" chamada API Token ou API Key. Antes, você precisava digitar essa chave diretamente no fluxo do bot. Agora, você pode criar um "apelido" para essa chave, mantendo o código real protegido e criptografado. 🔒

Por que essa mudança é importante?

Listamos os principais benefícios dessa nova funcionalidade para você:

Segurança Máxima: O valor do token é criptografado. Após o cadastro, ninguém (nem mesmo você!) conseguirá visualizar o código novamente.
Privacidade: Administradores que editam o bot verão apenas o "apelido" da chave (ex: $chave-api-erp), sem ter acesso à credencial real.

Passo a passo: Cadastrando seu primeiro Token Externo

Agora que você já entendeu a importância, vamos colocar a mão na massa? =)

1. Onde encontrar a funcionalidade

O acesso a essa página é restrito aos SuperAdmins (os mesmos que já possuem acesso à ativação da API da Octadesk).

Acesse o seu Octadesk;
Clique em Configurações (ícone da engrenagem);
Vá em Geral e depois em API;
Clique na nova guia: Tokens Externos.

(Você também pode acessar direto pelo link)

2. Cadastrando o Token

Para registrar uma nova chave de um sistema que você usa, siga estes passos:

Clique em Adicionar Token;
Dê um Nome/Apelido (ex: Token-Pagamentos);
Adicione uma descrição no Token ( opcional )
No campo Token ou Chave de Acesso, cole a chave que você obteve no seu sistema externo (ERP, CRM, etc);
Clique em Adicionar Token.

Atenção: Assim que você salvar, o valor ficará oculto/criptografado para sempre. Se você perder a chave original, precisará deletar esse registro e criar um novo, ok?

Como utilizar no "Conecte a outro sistema"

Com o seu token cadastrado, utilizá-lo nos seus fluxos ficou muito mais simples.

Em qualquer lugar onde o componente Conecte a outro sistema estiver disponível (Construtor de bots, WOZ Customizações ou Fluxo de eventos), você não precisará mais colar aquele código gigante de API.

Basta selecionar o seu token pelo "apelido" que você criou. O Octadesk se encarrega de descriptografar e enviar a informação com segurança para o outro sistema. 🐙

Como identificar problemas no Token?

Fique de olho no seu painel: Caso a última tentativa de integração apresente uma falha, o Octadesk exibirá um ícone de alerta (o "Izinho") indicando um Erro de Autenticação. Isso significa que o seu sistema externo (ERP ou CRM) recusou a chave, o que pode acontecer se o token tiver expirado, sido revogado na plataforma de origem ou cadastrado com algum erro de digitação.

Se isso ocorrer, basta conferir a validade da credencial no sistema de origem e realizar um novo cadastro no Octadesk, ajustando os Bots para que tudo volte a fluir perfeitamente! 🐙

Dicionário rápido:

Criptografia: É um método que "embaralha" a sua senha para que ninguém consiga ler, garantindo que sua integração seja inviolável.
SuperAdmin: Perfil de usuário com permissões totais no sistema, o único que pode gerenciar essas chaves.
Endpoint: É o endereço de destino para onde o Octadesk enviará as informações do seu token.

IMPORTANTE

Lembre-se: credenciais de sistemas externos são como senhas de banco. Nunca as compartilhe em chats ou campos visíveis. Use sempre a nova guia de Tokens Externos para manter sua operação segura!

Como gerenciar Tokens de Sistemas Externos no Octadesk?