> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flexxible.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Configurar um webhook

> Como criar uma integração webhook para notificar uma ferramenta externa quando ocorre um evento na organização.

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**.

> [!WARNING]
>
> 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](https://docs.flexxible.com/pt-BR/features/integrations/webhooks.md).