Comandi della cronologia

Controlla quali record di moderazione ha un membro sul tuo server, lascia che i membri consultino i propri e cancella i record conclusi di un membro quando si è guadagnato una fedina pulita.

Tre comandi si occupano di questo: /history (staff), /my-history (chiunque) e /clear-history (staff, elimina).

🔎 Vedere il record di un membro: /history

1. Copia l'ID utente Discord del membro: in Discord attiva la Modalità sviluppatore (Developer Mode; Impostazioni utente, Avanzate), fai clic con il tasto destro sul membro e scegli Copia ID utente (Copy User ID).
2. Scrivi /history, incolla l'ID in user_id e premi Invio.
3. Il bot risponde in privato, solo a te, con gli ultimi 10 record, dal più recente.

Ogni riga si presenta così:

1. BAN 🔴 (3d) - spamming invites - 2 hours ago #418

• il tipo in maiuscolo (BAN, MUTE, KICK, WARN, SOFTBAN, UNBAN, UNMUTE)
• 🔴 quando il record è ancora attivo
• la durata tra parentesi per ban, mute e softban
• il motivo, oppure "No reason"
• quando è successo
• il numero del caso dopo il #. È il numero da usare con /reason per cambiare la formulazione di un record.

Per vedere il comando serve il permesso Kick Members in Discord. La stessa lista, con più dettagli, è nel pannello: Moderazione → scheda Storico, una tabella con una riga per record che puoi filtrare per tipo e per stato.

🙋 Lasciare che i membri vedano il proprio record: /my-history

Chiunque può scrivere /my-history. Il bot mostra, in privato, gli ultimi 10 record di moderazione che il server conserva su di loro. È un modo rapido per chiarire "per cosa sono stato avvisato?" senza disturbare lo staff.

• Richiede che la funzione Moderazione sia attiva sul tuo server. Se è spenta, il membro riceve un messaggio che lo dice.
• Ignora l'impostazione Ruoli moderatore consentiti: non serve nessun ruolo.
• Con un prefisso dei comandi testuali impostato, funziona anche !my-history, ma una risposta testuale non può essere privata: il bot la pubblica nel canale e la cancella dopo 30 secondi.
• Un membro senza record riceve "You have no moderation records on this server." (non hai record di moderazione su questo server).

La pagina personale del membro nel pannello, Le mie sanzioni, elenca gli stessi record su tutti i server.

🧹 Cancellare i record conclusi di un membro: /clear-history

/clear-history elimina ogni record che non è più attivo per un membro sul tuo server. Usalo quando qualcuno ha scontato la pena e vuoi una scheda pulita.

1. Controlla che il membro non abbia nulla di attivo (vedi sotto).
2. Scrivi /clear-history, incolla l'ID utente del membro in user_id e premi Invio.
3. Il bot risponde Cleared N inactive records for @member (N record inattivi cancellati) oppure No inactive records found for @member (nessun record inattivo trovato).

Non si può annullare. I record vengono eliminati, non nascosti.

Cosa conta come inattivo

I record attivi non vengono toccati. Se vuoi eliminare anche gli avvisi di un membro, rimuovili prima nel pannello, poi esegui /clear-history.

Chi può usarlo

Tutte queste condizioni devono essere vere:

• la funzione Moderazione è attiva sul server
• la persona ha il permesso Ban Members in Discord (nota: più alto di /history, che richiede Kick Members)
• se hai impostato Ruoli moderatore consentiti (comandi slash) nelle impostazioni di Moderazione, la persona ha anche uno di quei ruoli

La stessa azione nel pannello

Moderazione → scheda Storico, poi Cancella tutto su un qualsiasi record concluso (non attivo) di quel membro: fai clic, poi fai clic di nuovo dove c'è scritto Fai clic di nuovo per confermare. Elimina tutti i record conclusi di quel membro, la stessa cancellazione del comando.

Il pulsante del pannello scrive una riga nel Registro attività del tuo server ("Svuotata la cronologia inattiva...") e, se hai impostato un canale di log della moderazione, pubblica anche lì. Il comando /clear-history non scrive nessuna delle due cose: non lascia alcuna voce nel Registro attività e non pubblica nulla nel canale di log. Se il tuo team vuole una traccia visibile, usa il pulsante del pannello, oppure scrivi a mano una riga nel tuo canale di log.

💡 Esempio

Un membro è stato avvisato due volte a marzo e silenziato per un giorno ad aprile. Siamo a ottobre e si è comportato bene.

1. /history user_id:123456789012345678 mostra: MUTE (1d, senza pallino, concluso), WARN 🔴, WARN 🔴.
2. I due avvisi sono ancora 🔴, quindi /clear-history da solo rimuoverebbe solo il mute.
3. Nel pannello: Moderazione → scheda Storico, trova il membro e fai clic su Rimuovi sulla riga di ciascun avviso.
4. Ora /clear-history user_id:123456789012345678. Il bot risponde Cleared 3 inactive records e la scheda del membro è vuota.

🔧 Quando qualcosa va storto

🚨 "The Moderation feature is not enabled for this server"

Attiva la funzione nel pannello, poi riprova. Il messaggio contiene il link.

🚨 "You do not have a role that is allowed to use moderation commands on this server"

Il tuo server limita i comandi di moderazione ad alcuni ruoli. Chiedi a un admin di aggiungere il tuo sotto Ruoli moderatore consentiti (comandi slash), oppure di svuotare quella lista.

🚨 Non vedo /clear-history nell'elenco dei comandi

Discord lo nasconde a chiunque non abbia Ban Members. Un admin del server può anche cambiare chi lo vede in Impostazioni server → Integrazioni → YAWBDB (Server Settings → Integrations).

🚨 "No inactive records found" ma /history mostra dei record

I record sono ancora attivi. Revocali o rimuovili prima nel pannello (avvisi e softban si rimuovono sempre e solo a mano).

🚨 "Failed to clear history" o "Server not registered in panel"

Il bot non è riuscito a raggiungere il pannello, oppure il server non è collegato. Riprova tra un minuto; se il server è nuovo, collegalo prima.

🚨 Ho cancellato il membro sbagliato

Non si può ripristinare. Ricrea i record dai tuoi appunti o dal tuo Registro attività; il Registro attività conserva una riga solo per una cancellazione fatta dal pannello.

🚨 /my-history dice che il server non è registrato

Stessa causa di sopra: il server non è collegato al pannello.