Sistema di Alert

La sezione Alerts ti permette di configurare come e quando ricevere notifiche quando qualcosa non funziona sui siti dei tuoi clienti.

Canali di Notifica

Polipo supporta 3 canali per gli alert:

CanaleDescrizioneConfigurazione
EmailNotifiche via emailSMTP server
SMSMessaggi di testoTwilio o provider SMS
WhatsAppMessaggi WhatsAppWhatsApp Business API

Dashboard Alert

Statistiche

In alto vedi le statistiche degli ultimi 30 giorni:

  • Alert Totali: Numero di alert inviati
  • Per canale: Distribuzione Email/SMS/WhatsApp
  • Successo/Falliti: Percentuale di consegna

Log Alert

La tabella mostra gli ultimi alert con:

  • Data/ora invio
  • Tipo (downtime, SSL, dominio, ecc.)
  • Canale usato
  • Destinatario
  • Stato (inviato, fallito, in coda)
  • Messaggio inviato

Configurare Email

Impostazioni SMTP

  1. Vai su Alerts β†’ Configurazione β†’ Email
  2. Inserisci i dati del server SMTP:
CampoDescrizione
Host SMTPServer email (es. smtp.gmail.com)
Porta587 per TLS, 465 per SSL
UsernameEmail o username
PasswordPassword o App Password
SicurezzaTLS/SSL/Nessuna
Email mittenteIndirizzo β€œDa”
  1. Clicca Salva

Configurazioni Comuni

Gmail:

  • Host: smtp.gmail.com
  • Porta: 587
  • Sicurezza: TLS
  • Usa App Password (non la password normale)

Outlook/Office 365:

  • Host: smtp.office365.com
  • Porta: 587
  • Sicurezza: TLS

Configurare SMS

Twilio

  1. Vai su Alerts β†’ Configurazione β†’ SMS
  2. Inserisci le credenziali Twilio:
CampoDescrizione
Account SIDTrovalo nella console Twilio
Auth TokenToken di autenticazione
Numero mittenteNumero Twilio (con prefisso +39)
  1. Clicca Salva

Altri Provider

Polipo supporta anche:

  • Vonage (ex Nexmo)
  • MessageBird
  • Provider custom via webhook

Configurare WhatsApp

WhatsApp Business API

  1. Vai su Alerts β†’ Configurazione β†’ WhatsApp
  2. Inserisci le credenziali:
CampoDescrizione
Phone Number IDID del numero Business
Access TokenToken API Meta
Template NameNome del template approvato

Nota: WhatsApp richiede template pre-approvati per messaggi automatici.

Configurare i Destinatari

Destinatari Globali

Notifiche inviate per tutti gli alert:

  1. Vai su Impostazioni β†’ Destinatari
  2. Aggiungi email/telefoni
  3. Seleziona i canali preferiti per ciascuno

Destinatari per Cliente

Notifiche specifiche per un cliente:

  1. Vai su Clienti β†’ Seleziona cliente β†’ Notifiche
  2. Aggiungi destinatari specifici
  3. Gli alert di quel cliente andranno anche a loro

Tipi di Alert

Quando viene inviato un alert

EventoDescrizionePrioritΓ 
Sito OfflineSito non raggiungibileAlta
Sito RecoverySito tornato onlineMedia
SSL in scadenzaCertificato scade entro X giorniMedia
SSL scadutoCertificato giΓ  scadutoAlta
Dominio in scadenzaDominio scade entro X giorniMedia
Response lentoTempo risposta > sogliaBassa
Errore HTTP500, 503, ecc.Alta

Configurare le Soglie

Per ogni tipo puoi impostare:

  • Abilita/Disabilita l’alert
  • Soglia (es. SSL scade tra 30 giorni)
  • Canali da usare (Email e/o SMS e/o WhatsApp)

Test delle Notifiche

Prima di fidarti, testa i canali:

  1. Vai su Alerts β†’ Test
  2. Seleziona il canale (Email/SMS/WhatsApp)
  3. Inserisci un destinatario di test
  4. Clicca Invia Test
  5. Verifica di ricevere il messaggio

Troubleshooting

Email non arrivano

  • Verifica credenziali SMTP
  • Controlla la cartella SPAM
  • Per Gmail usa App Password
  • Alcuni provider bloccano l’invio da IP sconosciuti

SMS non arrivano

  • Verifica saldo Twilio
  • Controlla formato numero (+39…)
  • Alcuni numeri potrebbero essere bloccati

WhatsApp non funziona

  • Verifica che il template sia approvato
  • Controlla i log nell’API Meta
  • Il numero deve essere in formato internazionale

Cooldown e Rate Limiting

Per evitare spam:

  • Cooldown: Stesso alert non reinviato entro X minuti
  • Aggregazione: Multipli problemi raggruppati in un messaggio
  • Escalation: Se non risolto, reinvia dopo X ore

Best Practices

  1. Configura piΓΉ canali - Email per tutto, SMS solo per critici
  2. Testa regolarmente - Verifica che i canali funzionino
  3. Non esagerare - Troppi alert = alert ignorati
  4. Imposta cooldown - Evita 100 email in 5 minuti
  5. Monitora i log - Controlla che gli alert vengano consegnati