> ## 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

> Reglas de umbral para tus métricas de llamadas, enviadas por correo electrónico, Slack o tus webhooks en cuanto algo se desvía.

Las reglas de alerta supervisan las métricas de llamadas de tu organización y te notifican cuando
se cruza un umbral: tasa de éxito inferior al 80 % durante el último día,
más de 500 llamadas en una hora, una regresión en una suite de pruebas. Adminístralas
en **Configuración → Organización → Alertas**
(`/dashboard/organization?tab=alerts`). Administrar reglas de alerta requiere
un rol de **administrador** o **propietario**.

## Crear una regla

Haz clic en **Crear regla** y completa lo siguiente:

| Campo                                   | Opciones                                                                                           |
| --------------------------------------- | -------------------------------------------------------------------------------------------------- |
| **Métrica**                             | Tasa de éxito · Tasa de fallas · Puntuación promedio · Volumen de llamadas · Regresiones de suites |
| **Condición**                           | es menor que · es como máximo · es mayor que · es como mínimo                                      |
| **Umbral**                              | El número con el que se compara                                                                    |
| **Ventana (horas)**                     | Hasta dónde se calcula la métrica — de 1 a 720 horas                                               |
| **Destinatarios de correo electrónico** | Separados por comas, hasta 10 direcciones                                                          |
| **URL del webhook entrante de Slack**   | Opcional — publica el mensaje de alerta en un canal                                                |
| **Enfriamiento (minutos)**              | Tiempo mínimo de espera entre activaciones (60 de forma predeterminada)                            |
| **Enviar a webhooks de desarrollador**  | También envía un evento `alert.triggered` a tus endpoints de webhook                               |
| **Activar regla de alerta**             | Las reglas pueden guardarse desactivadas y activarse más tarde                                     |

Ejemplo: *"La tasa de éxito **es menor que** 80 durante las últimas 24 horas"*
se activa cuando las llamadas calificadas en la ventana móvil de 24 horas bajan de una tasa de éxito
del 80 %.

<Note>
  **La tasa de fallas incluye más que las llamadas "Sin éxito".** La métrica de alerta
  considera como falla toda llamada que no alcanzó un resultado exitoso, incluidas las llamadas
  sin ninguna conversación (colgadas inmediatas, conexiones fallidas). El recuadro **Sin éxito**
  del panel cuenta solo las llamadas calificadas como
  `unsuccessful`. Por lo tanto, una alerta de tasa de fallas puede activarse incluso cuando el
  recuadro del panel muestra un número bajo; es lo esperado, no una discrepancia.
</Note>

## Cómo funciona la activación

Las reglas se evalúan según la ventana móvil que configuraste. Cuando
se cumple la condición, la regla se activa **una vez** y luego permanece inactiva durante
su período de enfriamiento, incluso si la métrica sigue incumpliendo el umbral; así, una mala
hora produce una alerta, no una alerta por cada evaluación. Cada activación registra
el valor de la métrica, el umbral y la hora.

## Canales de entrega

Una sola regla puede notificar en los tres canales a la vez:

* **Correo electrónico** — un mensaje a cada destinatario indicado con el nombre de la regla,
  la métrica, el valor, el umbral y la ventana.
* **Slack** — el mismo mensaje publicado mediante la URL de tu webhook entrante
  de Slack.
* **Webhooks de desarrollador** — un evento `alert.triggered` enviado a los
  [endpoints de webhook](/es/webhooks/overview) de tu organización, para integrar
  alertas con PagerDuty, herramientas de guardia o tus propios sistemas.

El fallo de un canal nunca bloquea los demás.

## Administrar reglas

La pestaña Alertas muestra todas las reglas con su estado de activación o desactivación y
cuándo se activaron por última vez. Activa y desactiva reglas directamente, selecciona **Editar** para
cambiar cualquier campo o elimina las reglas que ya no necesites. La actividad reciente de alertas
se muestra junto a ellas para que puedas confirmar que una regla se activa
como esperas.

## Próximos pasos

<CardGroup cols={2}>
  <Card title="Observabilidad" icon="chart-line" href="/es/guides/observability">
    Los paneles detrás de las mismas métricas.
  </Card>

  <Card title="Webhooks" icon="webhook" href="/es/webhooks/overview">
    Recibe alert.triggered (y cualquier otro evento) en tus propios sistemas.
  </Card>
</CardGroup>
