# Ajouter un canal d'alerte

Un canal d’alerte est un endroit où Status envoie une alerte de panne, de rétablissement ou d’expiration. Une organisation peut en avoir jusqu’à 20.

**Avant de commencer** : une organisation dans Status, et pour un webhook, un point d’arrivée HTTPS que tu contrôles.

## Choisir le type de canal

| Type                  | Ce qui part                              | Quand le choisir                                 |
| --------------------- | ---------------------------------------- | ------------------------------------------------ |
| **E-mail**            | Un e-mail envoyé depuis Status           | Une équipe qui lit ses e-mails                   |
| **Notification ntfy** | Une notification sur téléphone via ntfy  | Une alerte qu’on ne rate pas, sur téléphone      |
| **Webhook signé**     | Une requête HTTP signée vers ton système | Un outil d’astreinte, un Slack, un système à toi |

## Ajouter le canal

1. Ouvre **Alertes**, puis clique **Ajouter un canal**.

2. Renseigne le **Nom** (80 caractères au plus) et choisis le **Type de canal**.

3. Saisis la cible :

   - **E-mail** : l’adresse du destinataire.
   - **Notification ntfy** : l’adresse complète du sujet, par exemple `https://ntfy.sh/mon-sujet-prive`. Il manque le sujet si l’adresse n’en a pas.
   - **Webhook signé** : l’adresse HTTPS qui reçoit les requêtes, et le **Secret de signature** (voir [référence des alertes](/docs/reference/alertes/)).

4. Enregistre, puis envoie un test depuis la liste des canaux. Le message **Alerte de test envoyée.** confirme l’envoi.

Une cible doit être joignable depuis Internet. Utilise HTTPS : une adresse locale ou privée est refusée.

## Confirmer un destinataire

Un e-mail vers une adresse qui n’est pas celle d’un membre de l’organisation attend la confirmation de son destinataire. Le canal reste **En attente du destinataire** tant que le lien n’a pas été cliqué. Le nombre de confirmations envoyées chaque jour est limité : si la limite est atteinte, attends le lendemain, ou utilise l’adresse d’un membre.

## Quels évènements partent

Les alertes concernent les évènements des moniteurs : panne confirmée, rétablissement, expiration du certificat ou du domaine. Le détail de chaque évènement est dans la [référence des alertes](/docs/reference/alertes/).

Les envois qui échouent sont repris : après 30 secondes, 2 minutes, 10 minutes, 30 minutes puis 2 heures. L’historique des envois est gardé 30 jours.

## Si ça ne marche pas

- **Le test ne part pas.** Relis la cible : `https://` obligatoire, pas d’identifiants dans l’adresse, sujet ntfy présent.
- **« Cette adresse n’est pas joignable depuis Internet ».** La cible pointe vers un réseau privé ou local. Utilise une adresse publique.
- **« Trop d’adresses à confirmer aujourd’hui ».** Attends le lendemain, ou utilise l’adresse d’un membre.
- **Le webhook répond en erreur.** Ton point d’arrivée doit répondre 2xx, sans redirection. Une autre réponse déclenche des reprises (voir [référence des alertes](/docs/reference/alertes/#reprises)). Vérifie aussi que la signature est contrôlée avec le bon secret.
- **Les alertes arrivent en double sur ntfy.** Deux canaux pointent vers le même sujet. Supprime le doublon.

Référence complète : [alertes](/docs/reference/alertes/).