Documentação
Integração 1Doc ⇄ GLPI
Como o chamado aberto no 1Doc vira um ticket no GLPI, e como a resposta do técnico volta para o documento, sem ninguém precisar copiar nada à mão.
Esta página é para CS, IS e Suporte. Para configurar um cliente novo, abra o
Guia de Configuração.
Ida: do 1Doc para o GLPI
1
O servidor abre o assunto no 1Doc e o webhook do assunto avisa a integração.
2
A integração cria o ticket no GLPI com o assunto, o texto e os campos extras (usuário, setor, patrimônio).
3
Os anexos sobem junto. Se houver mais de um, vão compactados em anexo_1.zip.
4
O Robô escreve um despacho no documento com o número do ticket no GLPI.
Se o 1Doc mandar o mesmo aviso duas vezes, o ticket não é duplicado.
Volta: do GLPI para o 1Doc
1
O técnico responde ou soluciona o ticket no GLPI.
2
O plugin do GLPI envia o evento assinado para a integração. Se a integração estiver fora do ar, ele guarda numa fila e tenta de novo (até 12 vezes).
3
O Robô escreve a resposta como despacho no documento do 1Doc, com os anexos como links.
Acompanhamentos privados do GLPI não vão para o 1Doc. Tickets abertos direto no GLPI,
sem documento no 1Doc, são ignorados sem alerta.
O que o cliente precisa ter
- Um usuário Robô no 1Doc (informado à integração pelo id).
- A API REST do GLPI ativa, com um cliente de API e um usuário exclusivo da integração.
- O plugin Webhook 1Doc v2 instalado no GLPI (clientes da v1 podem seguir como estão).
Clientes que já usavam a v1
Nada muda para eles. O mesmo hash, a mesma URL e o mesmo Robô continuam valendo. No primeiro acesso, a integração copia o cadastro do chaveiro antigo e passa a usar o novo, mantendo o hash.
Alertas
Quando algo falha (anexo que não baixou, vínculo perdido, GLPI fora do ar), a integração avisa o time pelo canal de alertas. Nenhuma falha de anexo impede a criação do ticket: o anexo faltante fica anotado no próprio ticket.