---
title: "Alertes"
description: "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>
