Invite Bot
Aggiungi subito Sugo Bot al tuo server Discord.Documentation Hub
Wiki Sugobot
Questa documentazione spiega come usare il bot dentro Discord: configurazione iniziale, moduli disponibili, flussi interattivi, funzioni automatiche e reference dei comandi.
/setup
Primo setup nel server, configurazioni da admin, moduli premium, comportamento del bot, dati che vengono salvati e reference operativa dei comandi.
Quick Start
Primi passi nel server
Cosa serve prima di iniziare
- Il bot deve essere gia presente nel server.
- Chi configura il bot dovrebbe avere permessi amministratore o equivalenti.
- Per i moduli avanzati il bot deve poter gestire canali, ruoli, messaggi, timeout, webhook e allegati.
- Per Twitch e richiesto che il proprietario del bot abbia collegato il modulo live.
Ordine consigliato
- Configura il bot con
/setup. - Controlla i canali log e il messaggio di benvenuto.
- Attiva i moduli premium necessari con
/activatese hai una licenza. - Pubblica pannelli e configurazioni dei moduli che vuoi usare davvero nel server.
L idea migliore e partire dal minimo indispensabile e poi aggiungere ticket, verify, whitelist, reaction roles, giveaway o Twitch in base al tipo di community.
Permessi consigliati per un uso completo
| Permesso | Quando serve | Perche |
|---|---|---|
| Gestisci canali | Ticket, builder, backup, verify | Per creare, aggiornare o riorganizzare canali e categorie. |
| Gestisci ruoli | Verify, reaction roles, whitelist, builder | Per assegnare o rimuovere ruoli automaticamente. |
| Gestisci messaggi | Moderazione e pannelli | Per purge, pannelli e gestione ordinata dei messaggi automatici. |
| Modera membri | Timeout e moderazione | Per /mute e altri controlli staff. |
| Ban / Kick membri | Moderazione | Per usare ban e kick dal bot. |
| Webhook / Allegati | Branding, transcript, captcha | Per avatar personalizzati, transcript HTML e immagini captcha. |
How It Works
Come funziona nel server
Esperienza d uso
- Il bot usa slash commands come punto di ingresso principale.
- Molti moduli continuano con bottoni, menu e modali per ridurre i comandi lunghi.
- Le azioni piu importanti vengono confermate con embed chiari e messaggi visibili solo a chi serve.
Personalizzazione per server
- Nome visuale, colore embed, icona e lingua possono cambiare per ogni server.
- Quando possibile il bot pubblica con un aspetto coerente al branding della community.
- Le lingue disponibili sono italiano, inglese e spagnolo.
Interazioni supportate
Interazioni veloci
Ticket, assistenza, verify, giveaway e whitelist usano pulsanti e modali per rendere il flusso piu guidato.
Branding per server
Nome bot, footer e icona possono cambiare per guild. Quando possibile il bot usa webhook per pubblicare messaggi con avatar e naming contestuali al server.
Localizzazione
La stessa installazione del bot puo parlare lingue diverse a seconda del server configurato.
Feedback chiaro
Se qualcosa non va, il bot risponde con errori leggibili e in genere evita di sporcare i canali pubblici.
Core Config
Configurazione generale del server
Comando /setup
Log e audit
log-channel, mod-log-channel
Welcome
welcome
Branding
colore, nome-bot, icona, lingua
Stato
visualizza
Placeholder supportati
Il sistema welcome usa questi segnaposto per costruire messaggi e embed contestuali all utente che entra nel server.
Moderation
Moderazione e storico azioni
Azioni dirette
/ban, /kick, /mute, /unban,
/unmute rispettano gerarchie ruoli e possono notificare l utente.
Warnings separati
Gli avvisi restano separati dallo storico generale, cosi lo staff puo distinguere i warn dalle altre azioni.
Gestione canali
/purge elimina fino a 100 messaggi per batch, anche filtrando per utente.
/slowmode modifica il cooldown del canale corrente.
Storico consultabile
/modlog e /warnings aiutano lo staff a tenere traccia delle azioni gia fatte.
Reference rapida
| Comando | Scopo | Note |
|---|---|---|
/ban |
Ban utente | Supporta motivo e giorni di messaggi da rimuovere. |
/kick |
Espulsione | Motivo opzionale. |
/mute |
Timeout temporaneo | Durata in formato 10m, 1h, 1d, 7d. |
/unmute, /unban |
Revoche | Revocano timeout e ban. |
/warn, /warnings, /clearwarns |
Avvisi | Rimozione per singolo ID o reset completo. |
/purge, /slowmode, /modlog |
Canale e audit | Bulk delete, cooldown e log azioni per utente. |
Premium Module
Sistema ticket
Capacita principali
- Categorie multiple, ognuna pubblicata come bottone nel pannello ticket.
- Ruoli staff e categoria Discord dedicata per singola categoria.
- Messaggio iniziale personalizzato per categoria.
- Claim ticket, aggiunta utenti, rename canale e chiusura confermata.
- Transcript HTML automatico su canale log e opzionalmente in DM al creator.
- Reminder automatici per ticket aperti.
- Formato nome canale personalizzabile.
Flow utente/staff
/ticketmsgpubblica il pannello.- L utente clicca il bottone generale o di categoria.
- Il bot apre il canale dedicato e invia il messaggio iniziale.
- Lo staff puo claimare, aggiungere utenti o rinominare il ticket.
- Alla chiusura viene generato transcript e aggiornato lo stato.
Comandi del modulo
/ticket-config
Configura log, categoria, ruolo supporto, messaggio, transcript, reminder e naming format.
/ticket-category
Aggiunge categorie con emoji, ruoli, sezione Discord, colore bottone e limite ticket aperti.
/ticketmsg
Pubblica il pannello ticket con embed personalizzabile nel canale corrente.
Operativi
/ticket-add, /ticket-rinomina, /ticket-stats per gestione live dei canali ticket.
Placeholder del ticket welcome
Premium Module
Assistenza strutturata
Richiesta via slash command
/assistenza raccoglie oggetto, descrizione e priorita; poi crea un item staff con pulsanti.
Workflow staff
Pulsanti claim, close, conferma chiusura e raccolta feedback via modal.
Controlli anti abuso
Cooldown tra richieste, massimo aperte per utente e reminder automatici su pending / claimed.
Configurazione server
/assistenza-config imposta abilitazione, canali, ruolo staff, limiti, messaggi e promemoria.
Premium Module
Newsletter e scan list
/newsletter
- Invio verso un ruolo o una lista salvata con
/scanuser. - Modalita DM oppure pubblicazione in canale.
- Supporto titolo, colore, immagini, thumbnail, footer, URL, mention ruolo, embed on/off.
- Progress tracking durante gli invii massivi.
/scanuser owner-only
scansiona: salva una lista utenti riusabile anche da guild sorgente diversa.liste: mostra le liste disponibili.vedi: esporta gli utenti in JSON.elimina: rimuove la lista.
Persistenza
Le newsletter vanno in newsletters, mentre le liste utenti sono spezzate tra
scan_lists e scan_list_users. Lo storico si consulta con
/newsletter-history.
Access
Ruoli automatici e verifica
Reaction roles
/reactionrole aggiungicollega emoji e ruolo a un messaggio esistente./reactionrole pannellocrea un panel nuovo con bottoni o reazioni emoji.- Modalita:
toggle,add,unique. - Listing e cleanup via
listaerimuovi.
Verifica captcha
/verify-configgestisce enable, ruolo verificato, canale, log, timeout e kick on fail.- Captcha immagine da 6 caratteri con verifica guidata.
- Flow ephemeral con modal input, refresh captcha e massimo 3 tentativi.
- Supporta invio pannello dedicato con
pannello.
Growth
Twitch live e giveaway
Twitch notifications
/twitch-config monitora piu streamer per guild, con canale target, ruolo ping,
messaggio custom e protezione duplicati via last_stream_id.
Scheduler live ogni 60 secondi
Il modulo controlla automaticamente gli streamer monitorati e invia l annuncio live nel canale scelto.
Giveaway system
/giveaway supporta create, manual end, reroll, list e delete con premi,
durata, ruolo richiesto, embed brandizzato e numero vincitori.
Join / Leave tramite bottoni
Le partecipazioni vengono salvate in giveaway_entries; alla chiusura il bot
aggiorna il messaggio, annuncia i vincitori e prova a inviare DM.
Applications & Ops
Whitelist, builder e strumenti server
Whitelist / application system
/whitelist-configimposta canale review, reviewer role, approved role, pannello e DM templates./whitelist-domandaaggiunge, lista, resetta o rimuove fino a 5 domande form./whitelist-panelinvia il bottoneApply.- Review staff con bottoni approve / reject e assegnazione ruolo automatica.
Server builder
/server-builder preset,configura,crea,anteprima,guida,reset.- Supporta formato rapido con categorie
[Nome], testuali#, vocali+. - Tag rapidi:
private,public,readonly,nsfw,show[],hide[],slowmode[],limit[]. - Riusa canali esistenti quando possibile e riallinea permessi.
Utility avanzate di struttura
/serverbackup
Salva e ripristina template completi di ruoli, categorie, canali e permission overwrites.
/nuke
Comando distruttivo owner-only per svuotare canali e ruoli, conferma esplicita NUKE.
Operations
Comandi owner e amministrazione bot
/activate
Usato dagli admin di una guild per applicare una licenza premium valida.
/gestione
Suite owner-only per abilitare feature, generare chiavi, vedere stato premium e gestire licenze.
/botadmin
Blocca o sblocca server dall uso del bot. E un comando riservato al proprietario del servizio.
Comandi nascosti all utenza normale
Alcuni strumenti esistono solo per il proprietario del bot e non fanno parte dell uso quotidiano del server.
Automation
Funzioni automatiche
Cosa fa il bot da solo
- Invia reminder periodici per ticket e richieste assistenza aperte.
- Controlla gli streamer Twitch monitorati e pubblica la notifica quando vanno live.
- Chiude automaticamente i giveaway scaduti e annuncia i vincitori.
- Aggiorna ciclicamente lo stato del bot con messaggi informativi.
Ingresso membri
Quando entra un nuovo membro, il bot puo inviare il messaggio di benvenuto gia configurato.
Sync reaction roles
Eventi dedicati aggiungono o rimuovono ruoli quando l interazione avviene con reazioni classiche.
Pronto anche sui nuovi server
Quando il bot entra in un server nuovo puo partire subito con la configurazione base del sistema.
Autocomplete
Alcuni comandi come giveaway e scanuser espongono autocomplete lato Discord per velocizzare la UX.
Data & Privacy
Quali dati salva il bot
In pratica
Il bot salva solo i dati necessari a far funzionare i moduli: configurazioni del server, storico operativo e contenuti generati dalle funzioni attive. Questo permette di non perdere setup, log e stati tra un riavvio e l altro.
Configurazioni server
Canali log, welcome, branding, lingua, colori e impostazioni principali del bot.
Ticket
Ticket aperti o chiusi, categorie, claim, transcript e preferenze del modulo.
Moderazione
Warnings, ban, kick, mute e storico azioni staff.
Newsletter
Storico invii, liste destinatari e dati necessari alle campagne.
Assistenza
Richieste aperte, stato, feedback, limiti e reminder del sistema helpdesk.
Ruoli e verifica
Pannelli reaction role, impostazioni captcha e regole per assegnare ruoli automaticamente.
Builder e backup
Template di struttura server, snapshot di backup e configurazioni riutilizzabili.
Premium
Stato premium del server e moduli attivi necessari per abilitare i comandi sbloccati.
Giveaway
Giveaway creati, partecipanti, scadenze e vincitori estratti.
Twitch
Streamer monitorati, canali di notifica, ruoli ping e storico minimo per evitare duplicati.
Whitelist
Domande del form, candidature inviate e stato della review staff.
Reference
Reference completa dei comandi
Utility e core
| Comando | Categoria | Accesso | Descrizione |
|---|---|---|---|
/setup | settings | Admin | Configurazione generale del bot. |
/activate | settings | Admin | Applica una chiave premium. |
/help | utility | Pubblico | Browser comandi disponibile. |
/ping | utility | Pubblico | Latenza e stato bot. |
/userinfo | utility | Pubblico | Informazioni su un utente. |
/serverinfo | utility | Pubblico | Statistiche server. |
Moderazione
/ban | Banna un utente con motivo e cleanup messaggi. |
/unban | Rimuove il ban usando user ID. |
/kick | Espelle un utente. |
/mute | Applica timeout temporaneo. |
/unmute | Rimuove il timeout. |
/warn | Registra un warning. |
/warnings | Lista warning utente. |
/clearwarns | Cancella uno o tutti i warning. |
/purge, /slowmode, /modlog | Bulk delete, cooldown canale e log moderazione. |
Moduli premium
/ticket-config, /ticket-category, /ticketmsg, /ticket-add, /ticket-rinomina, /ticket-stats | Ticket system. |
/assistenza, /assistenza-config, /assistenza-stats | Richieste assistenza e analytics. |
/newsletter, /newsletter-history, /scanuser | Campagne e recipient lists. |
/reactionrole | Pannelli ruoli con emoji o bottoni. |
/verify-config | Captcha verification. |
/twitch-config | Notifiche live Twitch. |
/giveaway | Creazione e gestione giveaway. |
/whitelist-config, /whitelist-domanda, /whitelist-panel | Whitelist/application flow. |
/server-builder | Template e builder server. |
/serverbackup, /nuke | Backup e strumenti distruttivi owner-oriented. |
Owner / private operations
/botadmin | Blocca, sblocca o lista guild bloccate. |
/gestione | Abilita/disabilita premium, stato, lista guild, key management. |
/scanuser | Disponibile solo al proprietario del bot. |
/serverbackup, /nuke | Nel codice risultano comandi pensati per owner / deployment gestito. |