> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mundialtelhastermicas.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# 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

<Steps>
  <Step title="Abra Configurações > API">
    A tela lista os tokens que já existem.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Copie o token na hora">
    O valor completo aparece uma vez só, no momento da criação.
  </Step>
</Steps>

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

## Guardar

<AccordionGroup>
  <Accordion title="Onde guardar">
    Direto na configuração do sistema que vai usar. Se precisar registrar em algum lugar, use um gerenciador de senhas.
  </Accordion>

  <Accordion title="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.
  </Accordion>
</AccordionGroup>

## Revogar

Revogue quando:

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

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

## 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.