Documentazione

Avvisi Discord: gli avvisi di Pingsured in un canale

Pingsured può pubblicare un avviso in un canale Discord quando un ping inizia a non funzionare, quando si ripristina e quando il suo certificato viene sostituito. È un webhook che parla Discord: dai a Pingsured l’URL di un webhook Discord e ogni avviso arriva come messaggio in quel canale. Gli avvisi Discord sono disponibili con gli stessi piani dei webhook, ogni piano a pagamento. Li configura un proprietario o un gestore dell’account, per un singolo ping o come predefinito per tutti i ping dell’account.

Cosa serve

  • Un server Discord su cui puoi gestire i webhook (il permesso Gestire i webhook) e il canale in cui devono arrivare gli avvisi. Un webhook pubblica in un solo canale; per avvisare in un secondo, crea un secondo webhook.

Creare il webhook in Discord

  • In Discord apri le impostazioni del canale (l’ingranaggio accanto al nome), vai su Integrazioni, poi Webhook, e scegli Nuovo webhook.
  • Dagli un nome e, se vuoi, un’icona, per esempio Pingsured, e controlla che il canale sia quello giusto.
  • Scegli Copia URL del webhook. Ha questo aspetto: https://discord.com/api/webhooks/…/….

Discord cambia di tanto in tanto i nomi dei suoi menu. Quello che serve a Pingsured è l’URL di un webhook.

Tratta l’URL come un segreto: chiunque lo abbia può pubblicare in quel canale. Pingsured lo mostra per intero solo a proprietari e gestori. Se trapela, elimina il webhook in Discord e creane un altro.

Aggiungerlo in Pingsured

  • Per tutti i ping, apri Impostazioni → Notifiche, vai a Integrazioni sotto Notifiche predefinite e scegli la scheda Discord.
  • Per un ping, apri il ping, vai alla sua sezione Notifiche, scegli Aggiungi sottoscrizione e seleziona Discord.

Incolla l’URL del webhook per intero, token compreso. Pingsured accetta solo gli indirizzi che hanno i webhook di Discord (su discord.com, sotto /api/webhooks/), quindi l’URL di un altro servizio, o uno troncato prima del token, viene rifiutato al salvataggio. Poi scegli i trigger. L’insieme consigliato è Primo errore e Primo ok, con Certificato cambiato se controlli i certificati: sai quando qualcosa si rompe e quando è risolto.

Scegli Invia test accanto al canale per pubblicare un messaggio contrassegnato come test. È il modo più rapido per verificare che l’URL e il canale siano giusti prima che un avviso dipenda da loro.

Come appare un messaggio

  • Un messaggio con una barra colorata e un titolo formato dal nome del ping e da un punto che indica lo stato: rosso se non funziona, giallo se è degradato, verde se si è ripristinato.
  • Il motivo, quando c’è: lo stato HTTP, l’errore o perché un controllo del contenuto è fallito.
  • Da dove è stato visto: o la località, come Da de, oppure, per un ping controllato da più località, quali non funzionano, come In errore da de, sg (2 su 3 località).
  • Un link, Visualizza il ping in Pingsured, che apre il ping.

Un cambio di certificato si legge Certificato cambiato su il ping, oppure Certificato inatteso su di esso quando il cambio non somiglia a un rinnovo, con i motivi sotto.

I messaggi non avvisano nessuno con le menzioni: un ping chiamato @everyone, o un testo di errore con una menzione, viene mostrato come testo e non notifica nessuno oltre a quanto fa il canale stesso per un nuovo messaggio.

La lingua dei messaggi

I messaggi sono scritti nella lingua delle notifiche dell’account, che un proprietario imposta in Impostazioni → Account. Esistono in inglese, tedesco, spagnolo, francese e italiano. Finché non è impostata, sono in inglese. La stessa impostazione è la lingua di riserva delle e-mail di avviso ai membri che non hanno scelto la propria. La riga del motivo è mostrata come l’ha riportata il servizio controllato, nella sua lingua.

Quando vengono inviati i messaggi

Un canale Discord segue le stesse regole di ogni altro canale di avviso: quali cambiamenti, quanti errori prima, con quale frequenza e da dove sono descritti nella pagina delle notifiche. Un cambio di stato viene sempre inviato subito, e gli avvisi ripetuti per lo stesso ping e canale vengono trattenuti per 15 minuti.

Se un messaggio non arriva

Quando Discord non è raggiungibile, limita la richiesta o risponde con un errore che può passare, l’invio viene ripetuto, 5 tentativi in tutto, a distanza di 30 secondi, 5 minuti, 30 minuti e 2 ore. Ogni altra risposta è definitiva, e Pingsured mostra cosa ha risposto Discord quando passi il mouse sul badge di stato accanto al canale in Impostazioni → Notifiche. La più comune è Unknown Webhook: il webhook è stato eliminato in Discord. Il rimedio è un nuovo webhook: crealo in Discord, aggiungilo in Pingsured e rimuovi quello vecchio.

Limiti

  • I canali Discord contano con i webhook per gli stessi limiti: 50 per tutto l’account e 20 su un ping.
  • I messaggi sono pubblicati con il nome e l’icona che il webhook ha in Discord. Le menzioni e i messaggi diretti non sono ancora disponibili.