Integrações no Portal Nyverra: Zabbix, WhatsApp, LDAP/SAML e e-mail

Nenhum ITSM trabalha sozinho. Alertas vêm do monitoramento, conversas chegam pelo WhatsApp, o login vem do diretório corporativo, os avisos saem por e-mail. O módulo de Integrações do Portal Nyverra ITSM é o que conecta o portal ao restante do ecossistema de TI.

Este guia percorre as principais integrações, o que cada uma habilita e como validá-las com segurança.

Interface do módulo no Portal Nyverra ITSM.

O que o módulo concentra

Integração	Finalidade
Zabbix	Alertas viram ou atualizam chamados; autodiscovery de hosts
WhatsApp (Meta)	Inbox operacional — ver WhatsApp
LDAP / SAML / OAuth2	Login corporativo (SSO) e provisionamento
E-mail (SMTP) e webhooks	Notificações e automações

Zabbix: do alerta ao chamado

É a integração que mais reduz trabalho manual. Quando o monitoramento detecta um problema, o Portal recebe o evento (via webhook) e cria ou atualiza um chamado — com host, severidade e contexto. O fluxo é resiliente: a ingestão é assíncrona (fase de recebimento + processamento), evitando perda de eventos em picos. Combinada ao Downtime Manager, evita alertas durante manutenções.

WhatsApp: atendimento no canal que o cliente usa

A integração com a API da Meta habilita o Inbox de WhatsApp dentro do portal: conversas viram atendimentos, com aceitar, transferir, encerrar e vincular a chamado. Reforça a regra da janela de 24h da Meta — fora dela, texto livre é bloqueado e usa-se template (“retomar contacto”).

LDAP / SAML / OAuth2: identidade corporativa

Em vez de senhas isoladas, o portal usa a identidade da empresa. Isso centraliza o acesso (quem entra e quem sai), reduz senhas e melhora a auditoria. Alinhe com o time de identidade antes de ativar em produção.

E-mail e webhooks

• SMTP: envio de notificações e relatórios; teste a configuração antes de habilitar em massa.
• Webhooks: entrada/saída de eventos para automações e outras ferramentas.

Quem usa

Perfil	Uso
Administrador	Configurar credenciais, webhooks e testar conexões
Infra / NOC	Integração de monitoramento (Zabbix)
Time de identidade	SSO (LDAP/SAML/OAuth2)

Como usar: passo a passo

1. Escolha a integração e reúna as credenciais (ex.: no Zabbix, o endpoint de webhook; na Meta, Phone Number ID e token).
2. Configure na área de Integrações.
3. Use o teste de conexão para validar.
4. Defina regras/roteamento (grupos que recebem eventos/conversas).
5. Monitore os eventos recebidos e ajuste.

Regras de negócio e segurança

Regra	Explicação
Janela de manutenção	Alterar integração de produção exige janela e teste — pode afetar o serviço.
Segredos	Credenciais de integração são sensíveis; use cofre e rotacione.
Webhook de entrada	Proteja o endpoint (token/chave) para evitar eventos falsos.
Idempotência	Eventos de monitoramento devem ser tratados para não duplicar chamados.

Boas práticas

• Comece por uma integração crítica (geralmente o Zabbix) e expanda.
• Teste sempre antes de ativar em produção.
• Combine Zabbix + Downtime Manager para não gerar alertas falsos em manutenção.
• Use chaves/tokens dedicados e rotacione periodicamente.
• Documente o que cada integração envia e para onde — facilita o troubleshooting.

Erros comuns

Situação	O que fazer
Chamados duplicados do monitoramento	Ajuste o mapeamento/idempotência dos eventos.
E-mail não sai	Teste o SMTP; verifique a auditoria de entregas.
Conversas do WhatsApp sem dono	Configure os grupos de escalação que recebem a fila.
SSO com falha	Revise configuração LDAP/SAML e metadados com o time de identidade.

Perguntas frequentes

Preciso de todas as integrações?
Não — ative conforme a necessidade. O Zabbix costuma ser o primeiro por causa do monitoramento.

Posso testar antes de valer para todos?
Sim, a área oferece teste de conexão; em produção, use janela.

Webhook de entrada é seguro?
Proteja com token/chave e valide a origem.

Automatize via API

Integrações e webhooks são expostos por API (/api/integracoes, incluindo webhooks de entrada e Slack/WhatsApp). Referência em developer.nyverra.com.

Cenários de uso: o ecossistema conectado

1. Zabbix gerando chamados. Um host cai; o monitoramento envia o evento; o Portal cria o chamado com host e severidade. O NOC deixa de abrir tickets manualmente e passa a triar o que chega — reduzindo tempo de detecção.

2. Manutenção sem falso alerta. A mudança derruba um serviço; o Downtime Manager suprime os alertas daquela janela. Sem a integração, a manutenção planejada viraria dezenas de incidentes falsos.

3. Login único corporativo. Com SSO (LDAP/SAML/OAuth2), o colaborador usa a identidade da empresa. O desligamento no diretório já encerra o acesso ao portal — segurança centralizada.

4. Conversas no WhatsApp. O cliente fala pelo canal que já usa; o operador atende dentro do portal, vinculando a conversa a um chamado.

Segurança das integrações

Risco	Mitigação
Segredos vazados	Cofre de segredos + rotação
Eventos falsos no webhook	Token/chave + validação de origem
Chamados duplicados	Idempotência na ingestão
Quebra em produção	Teste + janela de manutenção

Troubleshooting que economiza horas

Quando algo “não chega”, a investigação segue uma ordem: (1) a integração está ativa? (2) o teste de conexão passa? (3) os eventos aparecem do lado de origem? (4) as notificações saíram (auditoria de entregas)? Documentar o que cada integração envia e para onde encurta drasticamente esse caminho. Integração é o que faz o ITSM trabalhar em rede — mas exige governança de segredos e teste.

Checklist de integrações

1. Reúna credenciais e endpoints de origem.
2. Configure na área de Integrações.
3. Rode o teste de conexão.
4. Defina grupos de destino e regras.
5. Monitore os eventos recebidos.
6. Proteja segredos e planeje rotação.

Perguntas frequentes adicionais

Chamado duplicado do monitoramento: o que fazer?
Ajuste o mapeamento/idempotência dos eventos de origem.

Posso ativar tudo de uma vez?
Não é recomendável; comece pela integração crítica e valide.

Como proteger o webhook de entrada?
Com token/chave e validação de origem.

Conclusão

Integrações transformam o Portal Nyverra ITSM em hub do ecossistema de TI. Monitoramento, mensageria e identidade conectados significam menos trabalho manual, resposta mais rápida e uma operação que conversa entre si.