Suporte
Guia de Configuração
Passo a passo para ligar um cliente novo na integração 1Doc ⇄ GLPI.
1. No GLPI (o cliente ou o Suporte)
1
Em Configurar → Geral → API, ative a API REST e crie um cliente de API. Copie o app_token.
2
Crie um usuário exclusivo da integração, com perfil que crie tickets e acompanhamentos. Gere o user_token e anote o id desse usuário (usuario_glpi).
3
Anote a URL da API, no formato https://glpi.cliente.gov.br/apirest.php/.
2. No 1Doc
1
Crie o usuário Robô e anote o id (usuario_robo).
2
Tenha em mãos os dados da base: id_cliente, client_auth, token, secret, xapikey, grupo e id_documento.
3. Cadastrar o cliente (Admin API)
Na Swagger da Admin API, chame POST /clientes com os dados acima. Campos opcionais:
| Campo | Para que serve | Padrão |
|---|---|---|
| formato_titulo | Modelo do título do ticket. Variáveis: {assunto} {num} {ano} {numero} {usuario} {setor} {patrimonio}. Ex.: {assunto} - {numero} gera "Rede caiu - 116/2026". | Só o assunto |
| ticket_padrao | Valores padrão do ticket: priority, impact, urgency, type, itilcategories, status. | 3, 3, 1, 7, 1, status do GLPI |
O PUT substitui o cadastro inteiro. Para mudar só um campo, reenvie os demais.
A resposta traz o hash do cliente, as URLs prontas e o segredo do plugin. O segredo aparece uma única vez: copie na hora.
4. Testar a conexão
Chame POST /clientes/{hash}/testar. O teste confere o acesso ao GLPI, o acesso ao 1Doc e se o token pertence ao usuario_glpi. Só ligue os webhooks depois que o teste passar.
5. Webhook do assunto no 1Doc (ida)
No assunto, aponte o webhook para:
https://<url-da-function>/1doc?hash=<hash-do-cliente>
Para sobrescrever os valores do ticket em um assunto específico, acrescente na URL:
&priority=4&impact=3&urgency=2&type=1&itilcategories=15&status=2
Valor na URL vale mais que o ticket_padrao do cliente, que vale mais que o padrão da integração.
6. Plugin no GLPI (volta)
1
Instale e ative o plugin Webhook 1Doc v2.
2
Em Configurar → Plugins, abra a configuração do Webhook 1Doc e cole a URL https://<url-da-function>/glpi/<hash> e o segredo recebido no cadastro.
3
Clique em Testar conexão.
4
O cron do GLPI precisa estar ativo, porque é ele que reenvia os eventos que falharam.
7. Conferir de ponta a ponta
- Abra um documento no assunto configurado e confira o ticket no GLPI e o despacho do Robô.
- Responda o ticket no GLPI e confira o despacho no documento.
- Solucione o ticket e confira o despacho da solução.
Problemas comuns
| Sintoma | O que verificar |
|---|---|
| O teste de conexão acusa o token | O user_token é do mesmo usuário informado em usuario_glpi? |
| A resposta do técnico não chega ao 1Doc | URL e segredo do plugin estão certos? O cron do GLPI está rodando? O acompanhamento não era privado? |
| Resposta repetida no documento | Confira se o usuario_glpi está certo. É ele que impede o eco das mensagens do próprio Robô. |
| Anexo não aparece | O ticket traz a linha "Anexo não importado". Os links dos anexos da volta expiram em 21 dias. |