> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thunderphone.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Alertas
> Regras de limite para as métricas das suas chamadas — enviadas por e-mail, Slack ou seus webhooks no momento em que algo sai do esperado.
As regras de alerta monitoram as métricas de chamadas da sua organização e notificam você quando
um limite é ultrapassado — taxa de sucesso abaixo de 80% no último dia,
mais de 500 chamadas em uma hora, uma regressão em um conjunto de testes. Gerencie-as
em **Configurações → Organização → Alertas**
(`/dashboard/organization?tab=alerts`). Gerenciar regras de alerta exige
a função de **admin** ou **owner**.
## Criar uma regra
Clique em **Criar regra** e preencha:
| Campo | Opções |
| ------------------------------------------ | ----------------------------------------------------------------------------------------------- |
| **Métrica** | Taxa de sucesso · Taxa de falha · Pontuação média · Volume de chamadas · Regressões de conjunto |
| **Condição** | é menor que · é no máximo · é maior que · é no mínimo |
| **Limite** | O número usado para comparação |
| **Janela (horas)** | Até onde a métrica é calculada — de 1 a 720 horas |
| **Destinatários de e-mail** | Separados por vírgula, até 10 endereços |
| **URL do webhook de entrada do Slack** | Opcional — publica a mensagem de alerta em um canal |
| **Intervalo de espera (minutos)** | Tempo mínimo de silêncio entre disparos (padrão: 60) |
| **Entregar aos webhooks de desenvolvedor** | Também envia um evento `alert.triggered` aos seus endpoints de webhook |
| **Ativar regra de alerta** | As regras podem ser salvas desativadas e ativadas depois |
Exemplo: *"A taxa de sucesso **é menor que** 80 nas últimas 24 horas"*
é disparada quando as chamadas avaliadas na janela móvel de 24 horas caem abaixo de uma
taxa de sucesso de 80%.
**A taxa de falha contabiliza mais do que chamadas "Sem sucesso".** A métrica de alerta
trata toda chamada que não alcançou um resultado bem-sucedido — incluindo chamadas
sem nenhuma conversa (desligamentos imediatos, conexões com falha) — como uma
falha. O cartão **Sem sucesso** do painel contabiliza apenas chamadas avaliadas como
`unsuccessful`. Portanto, um alerta de taxa de falha pode ser disparado mesmo quando o
cartão do painel mostra um número baixo; isso é esperado, não uma discrepância.
## Como funciona o disparo
As regras são avaliadas em relação à janela móvel configurada. Quando
a condição é atendida, a regra é disparada **uma vez** e permanece em silêncio durante
o período de espera, mesmo que a métrica continue fora do limite — assim, uma hora
ruim gera uma notificação, não uma notificação por avaliação. Cada disparo registra
o valor da métrica, o limite e o horário.
## Canais de entrega
Uma única regra pode notificar pelos três canais ao mesmo tempo:
* **E-mail** — uma mensagem para cada destinatário listado com o nome da regra,
a métrica, o valor, o limite e a janela.
* **Slack** — a mesma mensagem publicada pela URL do webhook de entrada
do Slack.
* **Webhooks de desenvolvedor** — um evento `alert.triggered` entregue aos
[endpoints de webhook](/pt/webhooks/overview) da sua organização, para integrar
alertas ao PagerDuty, a ferramentas de plantão ou aos seus próprios sistemas.
A falha de um canal nunca bloqueia os outros.
## Gerenciar regras
A guia Alertas lista todas as regras com seu estado ativado/desativado e
quando foram disparadas pela última vez. Ative e desative regras diretamente, use **Editar** para
alterar qualquer campo ou exclua regras que não são mais necessárias. A atividade recente de alertas
é exibida ao lado para que você possa confirmar que uma regra realmente é disparada
como espera.
## Próximas etapas
Os painéis por trás das mesmas métricas.
Receba alert.triggered (e todos os outros eventos) nos seus próprios sistemas.