Invite Bot

Aggiungi subito Sugo Bot al tuo server Discord.
Aggiungi il bot

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.

Slash Commands Config per server 40+ comandi IT / EN / ES Webhook Branding
41 Comandi slash disponibili
1 Comando centrale per il setup base: /setup
3 + 1 Funzioni automatiche piu rotazione stato
10 Moduli premium sbloccabili
Cosa copre questa wiki

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

  1. Configura il bot con /setup.
  2. Controlla i canali log e il messaggio di benvenuto.
  3. Attiva i moduli premium necessari con /activate se hai una licenza.
  4. 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

Slash commands Bottoni Menu selezione Modali Messaggi automatici DM

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.

Licensing

Free vs Premium

Base sempre disponibile

  • Configurazione generale /setup.
  • Messaggi di benvenuto.
  • Moderazione classica.
  • Utility base: /help, /ping, /userinfo, /serverinfo.

Moduli premium disponibili

tickets newsletter assistenza reactionroles verify serverbuilder utility_plus twitch whitelist giveaway

Come funziona l attivazione

  1. Il proprietario del bot genera o gestisce le chiavi premium.
  2. L admin del server usa /activate key:<CHIAVE>.
  3. La chiave sblocca uno o piu moduli sul server corrente.
  4. Da quel momento i comandi premium diventano utilizzabili nel server autorizzato.

Core Config

Configurazione generale del server

Comando /setup

Log e audit

log-channel, mod-log-channel

Imposta canali testo per log generali e moderazione.
Welcome

welcome

Canale, stato on/off e messaggio con placeholders.
Branding

colore, nome-bot, icona, lingua

Personalizza embed color, footer name, avatar e lingua.
Stato

visualizza

Mostra il riepilogo delle impostazioni attive della guild.

Placeholder supportati

{user} {username} {server} {membercount}

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

  1. /ticketmsg pubblica il pannello.
  2. L utente clicca il bottone generale o di categoria.
  3. Il bot apre il canale dedicato e invia il messaggio iniziale.
  4. Lo staff puo claimare, aggiungere utenti o rinominare il ticket.
  5. 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

{user} {username} {server} {category}

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 aggiungi collega emoji e ruolo a un messaggio esistente.
  • /reactionrole pannello crea un panel nuovo con bottoni o reazioni emoji.
  • Modalita: toggle, add, unique.
  • Listing e cleanup via lista e rimuovi.

Verifica captcha

  • /verify-config gestisce 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-config imposta canale review, reviewer role, approved role, pannello e DM templates.
  • /whitelist-domanda aggiunge, lista, resetta o rimuove fino a 5 domande form.
  • /whitelist-panel invia il bottone Apply.
  • 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
/setupsettingsAdminConfigurazione generale del bot.
/activatesettingsAdminApplica una chiave premium.
/helputilityPubblicoBrowser comandi disponibile.
/pingutilityPubblicoLatenza e stato bot.
/userinfoutilityPubblicoInformazioni su un utente.
/serverinfoutilityPubblicoStatistiche server.

Moderazione

/banBanna un utente con motivo e cleanup messaggi.
/unbanRimuove il ban usando user ID.
/kickEspelle un utente.
/muteApplica timeout temporaneo.
/unmuteRimuove il timeout.
/warnRegistra un warning.
/warningsLista warning utente.
/clearwarnsCancella uno o tutti i warning.
/purge, /slowmode, /modlogBulk delete, cooldown canale e log moderazione.

Moduli premium

/ticket-config, /ticket-category, /ticketmsg, /ticket-add, /ticket-rinomina, /ticket-statsTicket system.
/assistenza, /assistenza-config, /assistenza-statsRichieste assistenza e analytics.
/newsletter, /newsletter-history, /scanuserCampagne e recipient lists.
/reactionrolePannelli ruoli con emoji o bottoni.
/verify-configCaptcha verification.
/twitch-configNotifiche live Twitch.
/giveawayCreazione e gestione giveaway.
/whitelist-config, /whitelist-domanda, /whitelist-panelWhitelist/application flow.
/server-builderTemplate e builder server.
/serverbackup, /nukeBackup e strumenti distruttivi owner-oriented.

Owner / private operations

/botadminBlocca, sblocca o lista guild bloccate.
/gestioneAbilita/disabilita premium, stato, lista guild, key management.
/scanuserDisponibile solo al proprietario del bot.
/serverbackup, /nukeNel codice risultano comandi pensati per owner / deployment gestito.