Webhooks (Alertas)
Como configurar webhooks de entrada no OpsScript para receber eventos de sistemas externos e abrir chamados automaticamente
Os webhooks do OpsScript são de entrada: sistemas externos enviam requisições HTTP para o OpsScript e, a partir delas, chamados são abertos automaticamente. É o mecanismo usado, por exemplo, para transformar alertas de ferramentas de monitoramento (como o Alertmanager) em chamados na sua operação.
O recurso fica na página Integrações, no card Alertas, e é restrito a administradores.
Como funciona
Você cria uma política de alerta. O OpsScript gera um token e uma URL exclusivos para essa política. Você cola essa URL no sistema externo. Quando esse sistema envia uma requisição HTTP POST para a URL, o OpsScript executa a ação Criar chamado e abre um chamado com os dados recebidos.
Sistema externo (ex.: Alertmanager) → POST na URL da política → OpsScript abre o chamadoDiferente das integrações nativas (Slack, Teams), que enviam notificações da plataforma para fora, os Alertas fazem o caminho inverso: recebem eventos de qualquer sistema capaz de fazer uma requisição HTTP e os convertem em chamados.
Criando uma política de alerta
Acesse os Alertas
Clique em Integrações no menu lateral e abra o card Alertas. Você verá a lista de políticas configuradas e o botão para criar uma nova.
Crie a política
Informe um nome para a política, escolha a ação Criar chamado e defina os dados do chamado que será aberto (como o projeto de destino e a prioridade).
Copie o token e a URL
Ao salvar, o OpsScript exibe o token e a URL da política. Copie a URL — é ela que você vai colar no sistema externo. O token só é exibido nesse momento; guarde-o em local seguro.
Configure o sistema externo
Cole a URL na configuração de webhook/notificação do seu sistema externo (por exemplo, o receiver de webhook do Alertmanager).
Ajuste o template (opcional)
Se o payload enviado pelo sistema externo não estiver no formato esperado, configure um template para mapear os campos recebidos nos campos do chamado (título, descrição, prioridade, tags).
Dados do chamado
A partir do payload recebido, o OpsScript preenche os campos do chamado. Os principais são:
| Campo | Descrição |
|---|---|
title | Título do chamado |
description | Descrição do chamado |
priority_id | Prioridade do chamado |
project_id | Projeto de destino (opcional) |
external_id | Identificador do evento no sistema de origem, usado para deduplicação |
tags | Tags do chamado (tags inexistentes são criadas automaticamente) |
Os chamados abertos por uma política de alerta são registrados com o tipo Alerta.
O external_id evita chamados duplicados: se o mesmo evento chegar mais de uma vez, o OpsScript reaproveita o chamado já aberto em vez de criar um novo. É possível também configurar uma condição de resolução automática para encerrar o chamado quando o alerta correspondente se normaliza.
Segurança
Cada política é protegida pelo token embutido na URL — quem possui a URL pode abrir chamados por ela. Por isso:
- Restrinja por IP: cadastre os IPs ou faixas (CIDR) autorizados a enviar requisições para a política. Sem nenhum IP cadastrado, qualquer origem é aceita.
- Regenere o token quando necessário: gerar um novo token invalida o anterior imediatamente. Qualquer sistema externo que ainda use o token antigo deixará de conseguir enviar alertas até ser atualizado.
Silenciamento
Você pode silenciar temporariamente uma política para que ela não abra novos chamados enquanto o silêncio estiver ativo — útil durante janelas de manutenção previstas, quando os alertas são esperados.
Registro de eventos recebidos
O OpsScript mantém um registro dos eventos recebidos por cada política, onde é possível acompanhar o status do processamento de cada requisição. Se um evento falhar, você pode reprocessá-lo manualmente pela opção Reenviar no registro.
O histórico de eventos recebidos é mantido por 7 dias por padrão.