# Integração GLPI (Chamados) na Super Zapp

### ✅ Para quem (em 20 segundos)

Com a integração GLPI, a Super Zapp consegue:

* **Criar um chamado no GLPI** quando o atendimento for transferido para uma fila (ex.: “Suporte Humano”).
* **Consultar chamados em aberto** para evitar duplicidade e dar status rápido ao cliente.

> Importante: o Super Zapp **não vira um GLPI**. Ele se conecta a um **GLPI que você já usa** (self-hosted ou cloud).

***

### 🚀 Benefícios (valor percebido)

#### 📌 Mais organização (menos caos)

* Cada conversa vira um **protocolo** no GLPI.
* Histórico fica **centralizado** no helpdesk, não espalhado em chats.

#### ⏱️ Menos trabalho manual

* Reduz “copia e cola” de prints e mensagens para abrir chamado.
* Evita que o time perca tempo registrando atendimento.

#### 🧠 Mais controle de suporte

* Melhor para **SLA, responsáveis, categorias e filas**.
* Facilita auditoria e acompanhamento por gestores.

#### ⭐ Experiência melhor para o cliente

* Cliente recebe **mais clareza**: “Seu chamado foi aberto”.
* Dá sensação de empresa organizada e atendimento profissional.

#### 🧩 Diferenciação (para vender melhor a Super Zapp)

* “Integra com GLPI” posiciona você como solução séria de suporte (nível helpdesk).
* Excelente para operações de TI, provedores, suporte técnico e times com processo.

***

### ✅ Quando usar (e quando não usar)

#### Use GLPI se você precisa:

* Chamados com **categorias**, **responsáveis**, **SLA**, **histórico** e **relatórios**
* Um helpdesk “de verdade” para o suporte

#### Talvez não seja o ideal se:

* Você quer CRM de vendas (pipeline, oportunidades) → aí é outro tipo de ferramenta
* Você só precisa de um atendimento simples sem processo de chamados

***

### 🔧 Pré-requisitos

Antes de configurar, você precisa ter:

* Um GLPI ativo (instalado por você ou em cloud)
* Acesso para gerar:
  * **URL da API do GLPI**
  * **APP TOKEN**
  * **USER TOKEN**

⚠️ Atenção: a URL geralmente termina com `.../apirest.php` e **não deve ter “/” no final**.

***

## Tutorial passo a passo (configuração)

### Etapa 1 — Preparar o GLPI

1. No GLPI, habilite/permita uso da **API REST** (se necessário).
2. Gere o **APP TOKEN** (token do aplicativo).
3. Gere o **USER TOKEN** (token do usuário que vai “abrir os chamados”).

📌 Dica: use um usuário “integração” no GLPI (ex.: `superzapp.api`) para manter rastreável.

### 🌐 Obtendo a URL da Integração e APP TOKEN <a href="#obtendo-a-url-da-integracao-e-app-token" id="obtendo-a-url-da-integracao-e-app-token"></a>

No **GLPI**, acesse:

> **Configurar → Geral → API**

<figure><img src="/files/ikwnu4SQ5DUnvUOuh9RI" alt=""><figcaption></figcaption></figure>

**✅ Ativar a API**

Após ativar a API, cadastre na Super Zapp no formato:

<a class="button secondary">Copiar</a>

```
https://seudominio.com.br/glpi/apirest.php
```

⚠️ **Importante:** Não coloque `/` no final da URL.

***

#### 🔑 Gerar APP TOKEN <a href="#gerar-app-token" id="gerar-app-token"></a>

1. Clique em **Adicionar Cliente de API**

<figure><img src="/files/3Kq0UC07g3xGUyd5zRS7" alt=""><figcaption></figcaption></figure>

1. Deixe o campo **IP em branco**
2. Marque como **Ativo**
3. Marque **Re-gerar**
4. Clique em **Adicionar**

Depois:

* Vá em **Clientes de API**
* Clique no cliente recém-criado
* Copie o campo **Token da Aplicação**

<figure><img src="/files/p6chlRQpTppGLwDQiVVK" alt=""><figcaption></figcaption></figure>

### 👤 Gerar **User Token** (Usuário Global) <a href="#gerar-user-token-usuario-global" id="gerar-user-token-usuario-global"></a>

Este usuário será responsável por **criar chamados nas empresas desejadas via API**.

⚠️ Recomendado criar **um usuário exclusivo para integração**, com acesso às empresas que poderão abrir chamados.

#### 📌 Como gerar o token <a href="#como-gerar-o-token" id="como-gerar-o-token"></a>

Acesse no GLPI:

**Administração → Usuários**

1. Abra o usuário que será utilizado na integração
2. Role até o final da página
3. Localize o campo **API Token**
4. Clique em **Re-gerar**
5. Salve

O token será exibido.

👉 Copie esse token e utilize no campo **`User_token`** na Super Zapp.

<figure><img src="/files/tMprU6dV7YpD7TInA85c" alt=""><figcaption></figcaption></figure>

#### 👥 Regras Importantes de Usuários <a href="#regras-importantes-de-usuarios" id="regras-importantes-de-usuarios"></a>

Além do usuário com token (global), será necessário criar **usuários específicos por empresa** para permitir a identificação correta dos clientes.

**🔹 1️⃣ Usuário com Token (Global)**

* Terá acesso às empresas desejadas
* Será utilizado **apenas para autenticação da API**
* Deve possuir permissão para criar chamados

***

**🔹 2️⃣ Usuários por Empresa (Sem Token)**

Para que o sistema funcione corretamente:

* Deve ser criado **um usuário para cada empresa**
* Esses usuários **não precisam de API Token**
* Devem estar vinculados à empresa (Entidade correta)

***

#### 🔎 Como funciona a busca do cliente <a href="#como-funciona-a-busca-do-cliente" id="como-funciona-a-busca-do-cliente"></a>

Quando a Super Zapp for criar um chamado, o sistema irá:

1. 🔍 Buscar o cliente pelo **telefone (WhatsApp)**
2. Caso não encontre, buscar pelo **e-mail**
3. Se não existir, o cliente será **cadastrado automaticamente.**

***

#### ⚠️ Configuração Obrigatória <a href="#configuracao-obrigatoria" id="configuracao-obrigatoria"></a>

No usuário vinculado à empresa:

* A **Entidade padrão** deve estar configurada corretamente com a empresa correspondente
* O usuário deve possuir:
  * 📧 E-mail cadastrado **ou**
  * 📱 Telefone cadastrado

Sem essas configurações o chamado pode:

* Ser criado na entidade errada
* Não localizar o cliente corretamente
* Falhar na criação automática

***

### Etapa 2 — Configurar na Super Zapp

### 🎯 Configurar a Fila <a href="#configurando-a-fila" id="configurando-a-fila"></a>

\
**Cadastro → Filas → (selecione a fila) → Integrações → Adicionar**

1. Clique em **Adicionar integração**
2. Selecione **GLPI**
3. Informe:
   * **URL da API**
   * **APP TOKEN**
   * **USER TOKEN**
4. Defina quais ações quer ativar:
   * ✅ **Criar Chamado (GLPI)**
   * ✅ **Consultar Chamado (GLPI)** (opcional, mas recomendado)
5. Ajuste o **intervalo entre mensagens (ms)**

✅ Recomendação prática: **15000 ms (15s)**\
Isso ajuda a **juntar mensagens enviadas em sequência** e abrir **um único chamado**, evitando “1 chamado por mensagem”.

<figure><img src="/files/PvbF0Wlldpnr7EswOBCV" alt=""><figcaption></figcaption></figure>

Depois:

1. Crie uma fila
2. Vincule a integração GLPI
3. Marque a opção **Iniciar ao transferir**

<figure><img src="/files/PtKdrUhcifvNL6qftOhD" alt=""><figcaption></figcaption></figure>

#### 🚀 Como funciona na prática <a href="#como-funciona-na-pratica" id="como-funciona-na-pratica"></a>

Basta o **bot transferir o atendimento para essa fila**.

Ao transferir:

* A integração será iniciada automaticamente
* O chamado será criado no GLPI
* O número do chamado poderá ser retornado ao cliente

***

### Etapa 3 — Definir a regra de disparo (melhor prática)

O modelo mais seguro é:

* O bot atende normalmente
* Quando precisar de humano, transfere para a fila “Suporte Humano”
* **Ao entrar na fila**, a integração GLPI abre o chamado

✅ Resultado: você abre chamado só quando realmente virou suporte humano (melhor qualidade e menos lixo no GLPI).

***

### Etapa 4 — Testar (checklist rápido)

1. Abra um atendimento de teste
2. Envie 3–5 mensagens seguidas rapidamente
3. Transfira para a fila com GLPI
4. Confirme no GLPI:
   * ✅ Foi criado **apenas 1 chamado**
   * ✅ O chamado contém o conteúdo esperado
5. (Opcional) Teste “Consultar chamado” para ver se retorna corretamente

> **Print sugerido (Imagem 3):** Chamado criado no GLPI com o conteúdo do atendimento.

***

## Boas práticas (para não dar dor de cabeça)

* **Use a integração por fila**, não “global”, para controlar quando abre chamado.
* Defina um **intervalo (ms)** para evitar duplicidade quando o cliente manda “rajada” de mensagens.
* Mantenha tokens em local seguro (evite compartilhar em prints).
* Crie uma fila exclusiva “GLPI / Suporte” se você tiver vários setores.

***

## FAQ (Perguntas frequentes)

**GLPI é obrigatório?**\
Só se você quiser usar essa integração. O Super Zapp funciona sem GLPI — GLPI entra quando você quer um helpdesk com chamados.

**Precisa contratar o GLPI?**\
Não necessariamente. Você pode usar GLPI instalado por você (self-hosted) ou uma versão cloud/serviço. A integração funciona com um GLPI que tenha API acessível.

**Isso abre chamado para toda mensagem?**\
Não, se você configurar do jeito recomendado: **abre chamado quando transferir para a fila**.

**Por que usar “Consultar Chamado”?**\
Para evitar duplicidade e ajudar o atendente a identificar se já existe chamado em andamento.

***

## Solução de problemas

**1) Não cria chamado**

* Confira URL da API (sem “/” no final)
* Confira APP TOKEN e USER TOKEN
* Verifique se o GLPI permite acesso à API

**2) Está criando chamados demais**

* Aumente o **intervalo entre mensagens (ms)** (ex.: 15000–30000)
* Garanta que o disparo esteja por **transferência para fila**, não por evento genérico

**3) Consulta não retorna nada**

* Confirme se existem chamados abertos para o contato/critério usado
* Verifique permissões do usuário do token

***

### CTA (conversão suave, opcional no final da página)

Quer que a gente configure essa integração pra você e deixe a fila pronta com boas práticas (intervalo, gatilhos e teste completo)? Fale com o suporte.


---

# Agent Instructions: 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:

```
GET https://ajuda.super-zapp.com.br/integracao-glpi-chamados-na-super-zapp.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.