> ## 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.
# Avvisi
> Regole di soglia sulle metriche delle tue chiamate — inviate a email, Slack o ai tuoi webhook nel momento in cui qualcosa sfugge.
Le regole di avviso monitorano le metriche delle chiamate della tua organizzazione e ti avvisano quando
viene superata una soglia — tasso di successo inferiore all'80% nell'ultimo giorno,
più di 500 chiamate in un'ora, una regressione della suite di test. Gestiscile in
**Impostazioni → Organizzazione → Avvisi**
(`/dashboard/organization?tab=alerts`). La gestione delle regole di avviso richiede
il ruolo **admin** o **owner**.
## Crea una regola
Fai clic su **Crea regola** e compila:
| Campo | Opzioni |
| ---------------------------------------- | ---------------------------------------------------------------------------------------------------- |
| **Metrica** | Tasso di successo · Tasso di errore · Punteggio medio · Volume di chiamate · Regressioni della suite |
| **Condizione** | è minore di · è al massimo · è maggiore di · è almeno |
| **Soglia** | Il numero con cui confrontare |
| **Finestra (ore)** | Quanto indietro viene calcolata la metrica — da 1 a 720 ore |
| **Destinatari email** | Separati da virgole, fino a 10 indirizzi |
| **URL webhook in entrata Slack** | Facoltativo — pubblica il messaggio di avviso in un canale |
| **Cooldown (minuti)** | Tempo minimo di inattività tra le attivazioni (predefinito 60) |
| **Consegna ai webhook per sviluppatori** | Invia anche un evento `alert.triggered` ai tuoi endpoint webhook |
| **Abilita regola di avviso** | Le regole possono essere salvate disabilitate e attivate in seguito |
Esempio: *"Il tasso di successo **è minore di** 80 nelle ultime 24 ore"*
si attiva quando le chiamate valutate nella finestra mobile di 24 ore scendono sotto un
tasso di successo dell'80%.
**Il tasso di errore conta più delle chiamate "Non riuscite".** La metrica di avviso
considera un errore ogni chiamata che non ha raggiunto un esito positivo — incluse le chiamate
senza alcuna conversazione (riagganci immediati, connessioni non riuscite). Il riquadro
**Non riuscite** della dashboard conta solo le chiamate valutate come
`unsuccessful`. Un avviso sul tasso di errore può quindi attivarsi anche quando il
riquadro della dashboard mostra un numero basso; è previsto, non è una discrepanza.
## Come funziona l'attivazione
Le regole vengono valutate rispetto alla finestra mobile configurata. Quando
la condizione è soddisfatta, la regola si attiva **una volta** e poi rimane inattiva per
il suo periodo di cooldown, anche se la metrica continua a violare la soglia — quindi un'ora
negativa produce una notifica, non una notifica per ogni valutazione. Ogni attivazione registra
il valore della metrica, la soglia e l'ora.
## Canali di consegna
Una singola regola può inviare notifiche su tutti e tre i canali contemporaneamente:
* **Email** — un messaggio a ogni destinatario elencato che indica la regola,
la metrica, il valore, la soglia e la finestra.
* **Slack** — lo stesso messaggio pubblicato tramite l'URL del webhook in entrata
Slack.
* **Webhook per sviluppatori** — un evento `alert.triggered` consegnato agli
[endpoint webhook](/it/webhooks/overview) della tua organizzazione, per integrare gli
avvisi con PagerDuty, strumenti per la reperibilità o i tuoi sistemi.
Il fallimento di un canale non blocca mai gli altri.
## Gestisci le regole
La scheda Avvisi elenca ogni regola con il relativo stato abilitato/disabilitato e
l'ultima volta che si è attivata. Attiva o disattiva le regole direttamente dall'elenco, fai clic su **Modifica** per
cambiare qualsiasi campo oppure elimina le regole che non ti servono più. L'attività recente degli avvisi
viene mostrata accanto, così puoi verificare che una regola si attivi effettivamente
come previsto.
## Passaggi successivi
Le dashboard basate sulle stesse metriche.
Ricevi alert.triggered (e ogni altro evento) nei tuoi sistemi.