> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.basement.chat/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.basement.chat/_mcp/server.

# GLPI

O [GLPI](https://glpi-project.org) é uma central de chamados (helpdesk) e de inventário, de código aberto. A documentação oficial está em [help.glpi-project.org](https://help.glpi-project.org/). O Gateway conversa com o GLPI da sua empresa pela API dele. O assistente age com a sua conta do GLPI: vê os chamados que o seu perfil vê e escreve em seu nome.

## O que o assistente faz

| Com só leitura                                                                                                                                                                                                           | Com leitura e escrita                                                                                                                                                                                 |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Busca chamados por texto e situação. Lê um chamado com os solicitantes, os atribuídos, os acompanhamentos e a solução. Busca artigos da base de conhecimento e lê um artigo. Busca usuários. Mostra quem é você no GLPI. | Tudo da leitura. Abre chamados. Adiciona um acompanhamento, público ou privado. Adiciona uma solução. Altera título, situação, urgência ou prioridade. Atribui um chamado a um usuário ou a um grupo. |

O assistente não exclui chamados. O que ele escreve aparece no GLPI com o seu nome.

## Passo 1: o administrador configura o GLPI (uma vez)

Em **Conexões**, no cartão **GLPI**, toque em **Configurar**. Informe o **Endereço do GLPI** (por exemplo `https://glpi.suaempresa.com.br`). Depois escolha uma das duas opções, ou as duas:

#### Entrar com o GLPI (recomendado)

Exige GLPI 11 ou mais recente. Cada pessoa entra no GLPI com o próprio login e autoriza o Basement.

1. No GLPI, abra **Configurar → Geral → API** e ative **Habilitar API**.
2. Abra **Configurar → Clientes OAuth → Adicionar**. Nome: Basement. Concessões: **Código de autorização**. Escopos: **api** e **user**. Toque em **Adicionar URI** e cole o endereço que o Gateway mostra na tela.
3. Salve. Copie o **ID do cliente** e o **Segredo do cliente** para o Gateway.

#### Tokens de API pessoais

Funciona em qualquer GLPI a partir da versão 9.5. Cada pessoa cola o próprio token de API do GLPI.

1. No GLPI, abra **Configurar → Geral → API** e ative **Habilitar API Rest** e **Habilitar login com token externo**.
2. Em **Clientes de API**, adicione um cliente chamado Basement. Ativo: **Sim**. Faixa de IP: vazia. Marque **Regenerar** no token de aplicação e salve.
3. Copie o **Token de aplicação** para o Gateway.

Toque em **Salvar**. O Gateway testa o endereço na hora.

## Passo 2: cada pessoa conecta a própria conta

Em **Conexões**, no cartão **GLPI**, toque em **Conectar minha conta**.

* **Entrar com o GLPI**: o Gateway abre o seu GLPI. Entre com o seu login e autorize o Basement. Pronto.
* **Token de API**: no GLPI, abra **Minhas configurações** e encontre **Token de API** (em "Senhas e chaves de acesso" ou "Chaves de acesso remoto"). Marque **Regenerar**, salve e copie o token. Cole o token no Gateway.

O cartão mostra **Conectado**. Os seus agentes agora usam o GLPI com o seu perfil.

## Exemplos de pergunta

* "Quais chamados estão abertos no meu nome?"
* "Resuma o chamado 4821 e os acompanhamentos."
* "Existe um artigo na base de conhecimento sobre reset de senha do VPN?"
* "Abra um chamado para o grupo Infra: 'Servidor de arquivos lento desde ontem', prioridade alta." (precisa de leitura e escrita)
* "Adicione a solução no chamado 4821: 'Serviço reiniciado às 10h'." (precisa de leitura e escrita)

## Se não funcionar

| Mensagem                                              | O que fazer                                                                                                                 |
| ----------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| "Um administrador precisa configurar o GLPI primeiro" | Peça a um administrador o passo 1.                                                                                          |
| O GLPI não aceita o login                             | Confira a versão do GLPI (11 ou mais recente para **Entrar com o GLPI**) e se **Habilitar API** está ativo.                 |
| O token não funciona                                  | Gere um token novo em **Minhas configurações** e cole de novo. Confira se **Habilitar login com token externo** está ativo. |
| O assistente não vê um chamado                        | O seu perfil no GLPI não vê esse chamado. O assistente vê o mesmo que você.                                                 |
| Uma escrita responde "não permitido"                  | O seu nível de acesso tem só leitura no GLPI. Peça ao administrador um nível com escrita.                                   |