Consultar e atualizar o token da API
O token da API é a credencial que uma aplicação integrada usa para falar com o Atlaz. Este tutorial mostra onde ele fica, como copiá-lo e quando gerar um novo. Os demais campos da tela estão em Outros.
Acesso à página
Caminho: Configurações → Outros, bloco API, campo Token da API
Pré-requisitos
- Permissão Visualizar recursos e Acessar Plataforma para abrir a tela. Gerar um novo token exige Acessar Plataforma.
- Saber quais aplicações usam o token (por exemplo, sistemas externos e o ZapBot).
O token é como uma senha
Quem tem o token acessa o Atlaz pela API. Não o publique na Wiki, em capturas, em mensagens ou em chamados.
Passo 1 — Localize o token
Abra Configurações → Outros. No bloco API, o campo Token da API mostra o token.
Passo 2 — Copie o token
Clique no botão Copiar para a área de transferência e cole o valor na configuração da aplicação. Copie sempre o token inteiro, sem espaços ou trechos removidos.
Passo 3 — Gere um novo token, só se for preciso
O botão Gerar um novo token cria um token novo e invalida imediatamente o anterior, sem esperar o Salvar. Use só quando houver necessidade real, como suspeita de vazamento ou troca planejada de credencial.
Antes de clicar:
- Liste as aplicações que usam o token atual.
- Combine o horário com quem cuida dessas aplicações.
Depois de clicar:
- Copie o token novo.
- Atualize todas as aplicações que usavam o anterior.
As integrações com o token antigo param de funcionar
Enquanto a aplicação usar o token antigo, ela não consegue se comunicar com o Atlaz.
Resultado esperado
O campo mostra o token vigente, e as aplicações atualizadas voltam a se comunicar com o Atlaz.
Problemas comuns
| Situação | O que fazer |
|---|---|
| Uma integração parou depois da troca | Ela ainda usa o token antigo. Atualize com o token novo. |
| Não consigo abrir a tela | Falta Visualizar recursos ou Acessar Plataforma. |
| Gerei o token por engano | Não há como voltar ao antigo. Copie o novo e atualize as integrações. |
Checklist
- Aplicações que usam o token identificadas
- Token copiado inteiro, ou novo token gerado de propósito
- Todas as integrações atualizadas
- Token fora de capturas e mensagens