Pular para o conteúdo principal
Um webhook permite que, quando ocorre um evento na organização (um alerta, a execução de um microsserviço, uma operação…), a plataforma chame uma URL externa e envie uma mensagem com as informações do evento. Somente um usuário com a função de Administrador da organização pode configurá-lo.

Criar o webhook

  1. Acessar Configuração → Organização → Webhooks.
  2. Clicar em Novo.
  3. Em Visão geral, preencher:
    • Nome. Nome do webhook.
    • Tipo de evento. O evento que irá acioná-lo: Alerta acionado, Microsserviço executado, Objeto criado/modificado/excluído, Operação executada ou Operação executada em um workspace.
    • URL de destino. Endereço do sistema externo que receberá a mensagem.
  4. Em Elementos, selecionar os recursos específicos que irão disparar o webhook (por exemplo, quais alertas ou quais microsserviços), ou ativar a opção Enviar webhook para todos do tipo correspondente.
  5. Em Configuração da mensagem, definir o template JSON que será enviado. As variáveis (por exemplo #workspace_name ou #alert_name) são substituídas automaticamente pelo valor real quando o evento ocorre.
  6. Clicar em Salvar.
Evite criar dois webhooks com a mesma configuração: isso pode gerar envios duplicados.

Testar o webhook

Na visualização de detalhes, a ação Testar envia uma mensagem com o conteúdo do template (sem substituir as variáveis) para a URL configurada, para validar a conectividade e o formato sem esperar que o evento real ocorra.

Informações relacionadas

Para a lista completa de variáveis disponíveis por tipo de evento, exemplos de template para Slack e Microsoft Teams e o detalhe das novas tentativas de envio, consulte Webhooks.