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

# Alertes

> Des règles de seuil sur les métriques de vos appels, envoyées par e-mail, Slack ou à vos webhooks dès que quelque chose dérape.

Les règles d’alerte surveillent les métriques d’appels de votre organisation et vous avertissent lorsqu’un seuil est franchi — taux de réussite inférieur à 80 % sur la dernière journée, plus de 500 appels en une heure, régression d’une suite de tests. Gérez-les dans **Paramètres → Organisation → Alertes**
(`/dashboard/organization?tab=alerts`). La gestion des règles d’alerte nécessite le rôle **admin** ou **owner**.

## Créer une règle

Cliquez sur **Créer une règle** et renseignez :

| Champ                                | Options                                                                                |
| ------------------------------------ | -------------------------------------------------------------------------------------- |
| **Métrique**                         | Taux de réussite · Taux d’échec · Score moyen · Volume d’appels · Régressions de suite |
| **Condition**                        | est inférieur à · est inférieur ou égal à · est supérieur à · est supérieur ou égal à  |
| **Seuil**                            | Le nombre auquel comparer                                                              |
| **Fenêtre (heures)**                 | Période sur laquelle la métrique est calculée — de 1 à 720 heures                      |
| **Destinataires des e-mails**        | Séparés par des virgules, jusqu’à 10 adresses                                          |
| **URL du webhook entrant Slack**     | Facultatif — publie le message d’alerte dans un canal                                  |
| **Délai de récupération (minutes)**  | Durée minimale de silence entre les déclenchements (60 par défaut)                     |
| **Envoyer aux webhooks développeur** | Envoie également un événement `alert.triggered` à vos endpoints webhook                |
| **Activer la règle d’alerte**        | Les règles peuvent être enregistrées désactivées et activées ultérieurement            |

Exemple : *« Le taux de réussite **est inférieur à** 80 sur les dernières 24 heures »*
se déclenche lorsque les appels évalués dans la fenêtre glissante de 24 heures passent sous un taux de réussite de 80 %.

<Note>
  **Le taux d’échec compte davantage que les appels « Non réussis ».** La métrique d’alerte
  considère comme un échec chaque appel qui n’a pas atteint un résultat réussi — y compris les appels
  sans aucune conversation (raccrochages immédiats, échecs de connexion). La tuile **Non réussis**
  du tableau de bord ne compte que les appels évalués comme `unsuccessful`. Une alerte de taux
  d’échec peut donc se déclencher même lorsque la tuile du tableau de bord affiche un faible nombre ;
  c’est attendu, pas une divergence.
</Note>

## Fonctionnement du déclenchement

Les règles sont évaluées par rapport à la fenêtre glissante que vous avez configurée. Lorsque
la condition est remplie, la règle se déclenche **une seule fois**, puis reste silencieuse pendant
sa période de récupération, même si la métrique reste hors seuil — ainsi, une mauvaise
heure produit une seule alerte, et non une alerte à chaque évaluation. Chaque déclenchement enregistre
la valeur de la métrique, le seuil et l’heure.

## Canaux de diffusion

Une même règle peut notifier via les trois canaux simultanément :

* **E-mail** — un message envoyé à chaque destinataire indiqué, précisant la règle,
  la métrique, la valeur, le seuil et la fenêtre.
* **Slack** — le même message publié via l’URL de votre webhook entrant
  Slack.
* **Webhooks développeur** — un événement `alert.triggered` transmis aux
  [endpoints webhook](/fr/webhooks/overview) de votre organisation, afin d’intégrer
  les alertes à PagerDuty, aux outils d’astreinte ou à vos propres systèmes.

L’échec d’un canal ne bloque jamais les autres.

## Gérer les règles

L’onglet Alertes répertorie chaque règle avec son état activé/désactivé et
la date de son dernier déclenchement. Activez ou désactivez les règles directement, cliquez sur **Modifier** pour
changer n’importe quel champ, ou supprimez les règles dont vous n’avez plus besoin. L’activité récente des alertes
est affichée à côté afin que vous puissiez confirmer qu’une règle se déclenche réellement
comme prévu.

## Étapes suivantes

<CardGroup cols={2}>
  <Card title="Observabilité" icon="chart-line" href="/fr/guides/observability">
    Les tableaux de bord associés à ces mêmes métriques.
  </Card>

  <Card title="Webhooks" icon="webhook" href="/fr/webhooks/overview">
    Recevez alert.triggered (et tous les autres événements) dans vos propres systèmes.
  </Card>
</CardGroup>