Tokens de API

Como criar e revogar o token que permite outro sistema conversar com o ERP.

Quando usar

Quando outro sistema precisa ler ou escrever no ERP: uma automação, um painel externo, uma integração.

Quem pode fazer

Só Administrador.

O que é um token

É uma senha de máquina. Quem tem o token consegue fazer, pela integração, o que aquele acesso permite. Não é uma senha de pessoa: não deve ser digitada em tela de login nem compartilhada em conversa.

Criar

1. Abra Configurações > API

   A tela lista os tokens que já existem.

2. Clique em criar e dê um nome

   O nome é obrigatório, até 120 caracteres. Use nome que diz quem usa o token: “n8n disparo”, “painel BI”. Nome genérico como “token 1” torna impossível saber depois o que se quebra ao revogar.

3. Copie o token na hora

   O valor completo aparece uma vez só, no momento da criação.

Se você fechar a tela sem copiar, o token não pode ser recuperado. O caminho é revogar e criar outro.

Guardar

Onde guardar

Direto na configuração do sistema que vai usar. Se precisar registrar em algum lugar, use um gerenciador de senhas.

Onde não guardar

Em mensagem de chat, em e-mail, em planilha compartilhada ou em bloco de notas. Token em conversa fica pra sempre no histórico, visível pra quem entrar no canal depois.

Revogar

Revogue quando:

• A integração foi desligada
• Alguém que tinha acesso saiu da empresa
• Você suspeita que o token vazou

Revogar derruba a integração na hora. Antes de revogar, confira pelo nome quem usa aquele token, e avise.

Boas práticas

• Um token por integração, nunca um token compartilhado entre várias. Assim dá pra revogar uma sem derrubar as outras.
• Revise a lista de vez em quando. Token de integração que ninguém lembra pra que serve é risco parado.
• Token não substitui usuário. Pessoa acessa com login; sistema acessa com token.