Integração GLPI + Zabbix: como abrir chamados automaticamente a partir de alertas

O Zabbix detecta a falha às 3h da manhã, mas o chamado só nasce às 8h, quando alguém do plantão registra o ocorrido. Esse intervalo entre detecção e registro custa caro: o incidente corre sem dono, sem SLA e sem rastreabilidade.

A integração GLPI + Zabbix fecha essa lacuna. Com o webhook oficial, cada alerta relevante do monitoramento vira um chamado no GLPI em segundos, já com urgência, categoria e ativo vinculado. Ou seja, o time atua com contexto desde o primeiro minuto.

Neste guia, você vai entender como a integração funciona e configurar tudo de ponta a ponta: API, tokens, media type e ações. Além disso, vai aplicar as boas práticas que evitam o efeito colateral clássico, o service desk afogado em tickets duplicados.

Por que integrar o GLPI com o Zabbix?

Integrar o GLPI com o Zabbix conecta o monitoramento ao service desk. Quando o Zabbix detecta um problema, o GLPI recebe um chamado automático com urgência, categoria e ativo corretos. Dessa forma, a operação ganha rastreabilidade completa do incidente, do alerta à resolução, sem depender do registro manual de cada ocorrência.

O custo da demora é mensurável. Na análise anual de interrupções do Uptime Institute, 54% dos entrevistados relataram custo acima de US$ 100 mil na indisponibilidade significativa mais recente. Além disso, 16% passaram de US$ 1 milhão.

Esse mesmo estudo aponta problemas de rede como a maior causa isolada de interrupções de serviços de TI. Justamente o tipo de evento que o Zabbix captura primeiro.

Sem integração, o fluxo depende de alguém copiar o alerta para o GLPI. Na prática, chamados nascem atrasados, incompletos ou simplesmente não nascem. Consequentemente, o histórico de incidentes fica furado e os relatórios de SLA perdem valor.

Está avaliando as ferramentas ainda? Então vale conhecer primeiro o que é o Zabbix. Depois disso, veja como a plataforma GLPI organiza chamados, ativos e inventário em um só lugar.

Como funciona a integração oficial entre Zabbix e GLPI

A integração oficial funciona por webhook: o Zabbix mantém um media type GLPI em seu repositório de integrações, embutido nas versões recentes da ferramenta. Quando um evento dispara, a ação de trigger chama o webhook. Esse componente autentica na API REST do GLPI e cria o chamado na seção de assistência.

O ciclo de vida acompanha o evento. Se o problema muda de severidade, o webhook atualiza título e urgência do chamado. Quando o Zabbix registra a recuperação, a integração adiciona um acompanhamento com os detalhes e move o ticket para resolvido.

A cobertura de versões é ampla. O media type atende do Zabbix 6.0 ao 7.4, com testes no GLPI 10 e no GLPI 11. Para o GLPI 11, a documentação oficial do media type recomenda a API REST v2 com OAuth2, caminho que os tutoriais antigos ainda não cobrem.

Além do caminho oficial, equipes com necessidades específicas usam scripts próprios contra a API do GLPI. No entanto, o webhook oficial resolve a maioria dos casos com manutenção muito menor.

Pré-requisitos: o que validar antes de começar

Antes de tocar em configuração, uma checagem rápida evita horas de troubleshooting. Confirme os itens abaixo nos dois ambientes:

• Versões compatíveis: Zabbix 6.0 ou superior e GLPI 10 ou 11 atualizados;
• Conectividade: o servidor Zabbix precisa alcançar a URL do GLPI via HTTPS;
• Acesso administrativo nas duas ferramentas para criar usuários, perfis e tokens.

Confirme também categorias e entidades definidas no GLPI, para os chamados caírem no lugar certo. Feche com uma política de severidade acordada: quais níveis de alerta merecem chamado.

Em caso de dúvida sobre a versão instalada, o site oficial do projeto lista as releases suportadas.

Vale destacar: se a sua árvore de categorias ainda é bagunçada, organize a gestão de chamados no GLPI antes. Automatizar a entrada de tickets em uma estrutura confusa só amplifica o problema.

Configuração no GLPI: API, perfil e tokens

O lado GLPI se resume a três movimentos: habilitar a API, criar uma identidade dedicada para o Zabbix e gerar os tokens de autenticação.

Ative a API REST

No menu Configurar, abra Geral e acesse a aba API. Habilite a API REST e anote a URL exibida, no formato https://seu-glpi/apirest.php. Em seguida, cadastre um cliente de API autorizado para o endereço do servidor Zabbix, o que restringe quem pode consumir o serviço.

Crie perfil e usuário dedicados

Evite usar uma conta de administrador na integração. Crie um perfil com o mínimo necessário: criar e acompanhar chamados, além de ler ativos. Depois, vincule a ele um usuário técnico exclusivo, como zabbix-integracao.

Com essa separação, a trilha de auditoria mostra exatamente o que a automação fez. Ao mesmo tempo, um eventual vazamento de token causa dano limitado.

Gere e teste os tokens

A integração usa dois tokens. O App-Token nasce no cadastro do cliente de API. Já o user_token pertence ao usuário técnico (aba Chaves de acesso remoto). Antes de configurar o Zabbix, valide a autenticação direto no terminal:

# Teste de sessão na API REST do GLPI
curl -X GET \
  -H "Content-Type: application/json" \
  -H "Authorization: user_token SEU_USER_TOKEN" \
  -H "App-Token: SEU_APP_TOKEN" \
  "https://glpi.suaempresa.com.br/apirest.php/initSession"

Se a resposta trouxer um session_token, a API está pronta. Erros como ERROR_WRONG_APP_TOKEN_PARAMETER indicam token incorreto ou cliente de API sem permissão para o IP de origem: os dois tropeços mais comuns nessa etapa.

Configuração no Zabbix: media type, usuário e ação

Do lado do Zabbix, o trabalho se concentra na interface de administração e leva poucos minutos.

Importe e configure o media type

Nas versões recentes, o media type GLPI já aparece em Alertas, Tipos de mídia. Se não estiver lá, importe o arquivo YAML do repositório oficial de integrações. Nos parâmetros, preencha a URL do GLPI, o App-Token e o user_token gerados na etapa anterior.

Associe a mídia ao usuário de integração

Crie (ou escolha) um usuário do Zabbix responsável pelos disparos e adicione a mídia GLPI ao seu perfil. Esse usuário precisa de permissão de leitura nos hosts monitorados. Sem isso, a ação até dispara, porém sem os dados do evento.

Crie a ação de trigger

Em Alertas, Ações, crie uma ação com condição de severidade mínima (High ou superior) e a operação de enviar mensagem pelo media type GLPI. Comece restrito: é mais fácil ampliar o escopo depois do que limpar centenas de chamados de teste.

Severidade no Zabbix, prioridade no GLPI: o mapeamento que protege o SLA

Abrir o chamado é só metade do trabalho. A outra metade é classificá-lo direito: a urgência definida na criação alimenta a matriz de prioridade do GLPI, que determina o SLA aplicado. Um mapeamento mal feito gera P1 para um alerta trivial de disco ou, pior, P4 para produção fora do ar.

O media type oficial já faz uma conversão padrão (a severidade Disaster, por exemplo, vira urgência muito alta no GLPI). Ainda assim, vale revisar o resultado com a régua de severidade de incidentes da sua operação. A tabela abaixo resume um ponto de partida testado:

 
Registre esse mapeamento junto ao catálogo de serviços e revise a cada trimestre. Novas triggers entram no ambiente o tempo todo, portanto o que era raro ontem pode virar enxurrada amanhã.

Boas práticas para não afogar o service desk

A reclamação mais comum de quem liga monitoramento ao service desk não é técnica: é o volume. Sem critério, cada flap de interface vira chamado e o time passa a ignorar a fila. As práticas abaixo mantêm o sinal alto e o ruído baixo:

• Filtre por severidade: comece abrindo chamados apenas para High e Disaster;
• Trate a duplicidade na origem: aplique deduplicação e agrupamento de alertas antes do disparo;
• Feche no recovery: deixe a atualização automática resolver o chamado sozinho.

Complete o desenho com dependências entre triggers: se o roteador caiu, os hosts atrás dele não precisam de chamados próprios. Por fim, audite a fila toda semana. Chamados automáticos ignorados são sintoma de mapeamento desajustado.

Em resumo, a integração devolve tempo quando o desenho respeita a capacidade do time. O objetivo não é registrar tudo: é registrar o que exige ação humana.

Indo além: inventário e visão unificada da operação

A abertura de chamados é a porta de entrada, mas a dupla rende mais. Com o GLPI Agent nos servidores, o inventário no GLPI se mantém atualizado automaticamente. Assim, o chamado aberto pelo Zabbix aponta para um ativo com histórico, contratos e localização conhecidos.

O próximo passo natural é cruzar as bases. Relatórios que combinam disponibilidade (Zabbix) com custo e ciclo de vida dos ativos (GLPI) sustentam decisões de capacidade e renovação. Times maduros chegam a alimentar dashboards executivos com essa visão unificada.

Se a sua equipe prefere acelerar com apoio especializado, os projetos de GLPI da OpServices cobrem implantação, integrações e sustentação da plataforma.

Conclusão

A integração GLPI + Zabbix transforma alertas em chamados com contexto, elimina o registro manual e devolve rastreabilidade ao ciclo de incidentes. O caminho técnico é curto: API habilitada no GLPI, tokens gerados, media type configurado no Zabbix e uma ação de trigger bem filtrada.

O caminho operacional pede mais atenção. Mapeamento de severidade alinhado ao SLA, deduplicação na origem e revisão periódica da fila fazem a diferença entre automação útil e ruído automatizado.

Comece pequeno, com os serviços críticos e as severidades altas. Depois, expanda o escopo conforme o time ganha confiança na automação. Em poucas semanas, os relatórios de SLA passam a refletir a realidade da operação e o esforço de plantão cai de forma visível.

Quer acelerar esse desenho ou delegar a integração para quem faz isso no dia a dia? A OpServices implementa GLPI, monitoramento e a ponte entre os dois. Fale com nossos especialistas e leve seu service desk para o próximo nível.