> For the complete documentation index, see [llms.txt](https://assertchat.gitbook.io/manual-assertchat/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://assertchat.gitbook.io/manual-assertchat/pagina-inicial/api-e-webhook/api.md).
# API
### API Keys
Na aba **API Keys**, o usuário pode visualizar os tokens cadastrados para integrações com sistemas externos.
Esses tokens são utilizados para autenticar requisições feitas à API do AssertChat, permitindo que sistemas autorizados acessem os recursos liberados para a empresa.
### Indicadores da tela
Na parte superior, a plataforma apresenta alguns resumos importantes:
* **Tokens ativos:** quantidade de tokens que estão atualmente válidos para uso;
* **Tokens cadastrados:** quantidade total de tokens já criados na empresa;
* **Último uso:** data e horário do uso mais recente de um token.
> A diferença entre **tokens cadastrados** e **tokens ativos** ocorre quando um ou mais tokens já foram revogados.
### Tokens da empresa
Abaixo dos indicadores, é apresentada a lista de tokens cadastrados.
Para cada token, podem ser exibidas informações como:
* nome do token;
* status atual;
* permissões vinculadas;
* data de criação;
* data de expiração;
* último uso;
* último IP utilizado;
* user-agent da requisição.
Esses dados ajudam a identificar qual integração está utilizando o token e qual é o seu nível de acesso.
### Permissões do token
Cada token pode possuir permissões específicas para acessar determinados recursos da API, como:
* contatos;
* conversas;
* mensagens;
* tags;
* departamentos;
* relatórios;
* webhooks;
* outros recursos disponíveis na plataforma.
As permissões exibidas indicam exatamente o que aquele token pode consultar ou alterar.
{% embed url="" %}
### Revogar token
Quando necessário, é possível desativar um token por meio da opção **Revogar**.
Ao revogar um token, ele deixa de poder ser utilizado nas integrações da empresa.
> A revogação é indicada quando um token não será mais utilizado, quando houver troca de integração ou por motivo de segurança.
### Criar token
Na parte superior da tela, a opção **Criar token** permite cadastrar um novo token de acesso para integração com a API.
O processo de criação e definição das permissões pode ser detalhado em uma subseção própria do manual, caso vocês desejem explicar essa etapa separadamente.
### Documentação
A opção **Documentação** direciona o usuário para a referência técnica da API, onde podem ser consultadas informações sobre autenticação, endpoints e utilização dos recursos disponíveis.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://assertchat.gitbook.io/manual-assertchat/pagina-inicial/api-e-webhook/api.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
