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:

CampoPara que servePadrão
formato_tituloModelo 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_padraoValores 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
Problemas comuns
SintomaO que verificar
O teste de conexão acusa o tokenO user_token é do mesmo usuário informado em usuario_glpi?
A resposta do técnico não chega ao 1DocURL e segredo do plugin estão certos? O cron do GLPI está rodando? O acompanhamento não era privado?
Resposta repetida no documentoConfira se o usuario_glpi está certo. É ele que impede o eco das mensagens do próprio Robô.
Anexo não apareceO ticket traz a linha "Anexo não importado". Os links dos anexos da volta expiram em 21 dias.