ℹ️
Para que serve? O token identifica sua empresa nas requisições da API. Sem ele (ou com token inválido), a integração retorna erro de autenticação. Guarde o valor com o mesmo cuidado de uma senha.
O que é o Token de Integração
É uma chave gerada pelo TelcomNFe para conectar sistemas externos (ERP, gerenciador de provedor, automações) à API de NFCom. Cada empresa possui o seu próprio token.
| Item | Detalhe |
|---|---|
| Onde gerar | Configuração → aba Integrações |
| Botões | Gerar (cria/renova) e Copiar (área de transferência) |
| Uso | Autenticação nas chamadas da API TelcomNFe |
| Webhook (opcional) | Na mesma aba você pode informar uma URL para receber notificações de eventos |
1
Acessar Configuração do Sistema
⚙️
No menu lateral, clique em Configuração (ícone de engrenagem).
Menu lateral → Configuração
2
Abrir a aba Integrações
Na tela Configuração do Sistema, selecione a aba Integrações. Nela ficam o Token de Integração e as Notificações Webhook.
Configuração → Integrações
3
Gerar o token
Na seção Token de Integração, clique em Gerar. O sistema cria (ou renova) o token e exibe o valor no campo.
⚠️
Atenção: ao gerar um novo token, o anterior deixa de valer. Atualize imediatamente qualquer integração que ainda use o token antigo.
Botão Gerar
4
Copiar o token
Clique em Copiar para enviar o token à área de transferência. Cole no seu ERP, script ou painel de integração conforme a documentação da API.
Botão Copiar
5
Salvar alterações
Clique em Salvar Alterações (topo ou rodapé da tela) para gravar o token na configuração da empresa.
Salvar Alterações
Dicas de segurança
- Não compartilhe o token em chats públicos, prints ou repositórios Git.
- Prefira variáveis de ambiente / cofre de segredos no sistema que consome a API.
- Se houver suspeita de vazamento, gere um novo token e atualize as integrações.
- Documentação técnica dos endpoints: telcomnfe.com.br/api.