Introduzione a BotForge
Benvenuto nella documentazione di BotForge! Qui troverai tutto ciò che ti serve per iniziare a usare la nostra piattaforma e creare bot Discord potenti e personalizzati, senza scrivere una riga di codice.
BotForge è lo strumento definitivo per automatizzare il tuo server Discord. Che tu voglia inviare messaggi di benvenuto, gestire ruoli, creare comandi interattivi o integrare servizi esterni, il nostro intuitivo editor a blocchi rende tutto possibile.
Perché BotForge?
- No-Code: Nessuna conoscenza di programmazione richiesta.
- Visivo: Costruisci i tuoi bot con un semplice drag-and-drop.
- Potente: Funzionalità avanzate per ogni tipo di automazione.
- Flessibile: Gestisci più bot e server da un'unica dashboard.
- Sicuro: La sicurezza dei tuoi dati è la nostra priorità.
Inizia esplorando la Guida Rapida o scopri come ottenere il tuo Token Discord per connettere il tuo primo bot.
Guida Rapida
Segui questi semplici passaggi per avere il tuo primo bot Discord online con BotForge:
1. Crea un account
Se non l'hai ancora fatto, registrati gratuitamente su BotForge. Il piano Starter è perfetto per iniziare!
2. Crea un'applicazione bot su Discord
Vai sul Discord Developer Portal. Clicca su "New Application", dai un nome al tuo bot e crea l'applicazione. Poi, nella sezione "Bot", clicca su "Add Bot" e conferma. Copia il token che ti verrà mostrato (assicurati di non condividerlo con nessuno!).
3. Connetti il tuo bot a BotForge
Nella dashboard di BotForge, usa il modal "Crea nuovo bot" e inserisci il nome e il token che hai appena ottenuto. Clicca su "Salva e avvia Bot".
4. Invita il bot sul tuo server
Sempre nel Discord Developer Portal, vai nella sezione "OAuth2" -> "URL Generator". Seleziona "bot" e i permessi necessari (es. "Send Messages", "Manage Roles"). Copia il link generato e incollalo nel tuo browser per invitare il bot sul tuo server.
5. Inizia a creare comandi!
Ora che il tuo bot è online, vai nella sezione "Comandi" della dashboard e inizia a costruire le tue automazioni con l'editor a blocchi. Divertiti!
Come ottenere il tuo token Discord
Il token del bot è una chiave segreta che permette a BotForge di autenticarsi e controllare il tuo bot Discord. È fondamentale non condividerlo con nessuno e tenerlo al sicuro.
Passaggi:
- Vai sul Discord Developer Portal.
- Accedi con il tuo account Discord.
- Crea una nuova applicazione cliccando su "New Application" o seleziona un'applicazione esistente.
- Nel menu a sinistra, clicca su "Bot".
- Se non hai ancora un bot per questa applicazione, clicca su "Add Bot" e conferma.
- Sotto la sezione "TOKEN", clicca su "Reset Token" e poi su "Copy".
Importante: Il token viene mostrato solo una volta. Se lo perdi, dovrai resettarlo. Trattalo come una password e non condividerlo mai!
Concetti di base dell'Editor a Blocchi
L'editor a blocchi di BotForge è il cuore della creazione dei tuoi comandi. Ti permette di definire una sequenza di azioni che il tuo bot eseguirà quando un comando viene invocato.
Come funziona:
- Comandi: Ogni comando inizia con un prefisso slash (es.
/hello) e può essere invocato dagli utenti su Discord.
- Blocchi: I blocchi sono le singole azioni che il tuo bot può compiere (es. inviare un messaggio, dare un ruolo). Li trascini nell'area di lavoro per costruire la logica del tuo comando.
- Sequenza: I blocchi vengono eseguiti nell'ordine in cui li posizioni, dall'alto verso il basso.
- Parametri: Ogni blocco ha dei parametri specifici che puoi configurare (es. il testo di un messaggio, il canale di destinazione).
Esplora le sezioni dedicate a ciascun tipo di blocco per imparare a usarli al meglio.
Blocco 'Invia Messaggio' 💬
Questo è il blocco più semplice e più usato. Permette al tuo bot di inviare un messaggio di testo in un canale specifico del server Discord.
Parametri:
- Canale: Il canale dove il messaggio verrà inviato (seleziona dalla lista dei canali disponibili o digita l'ID).
- Testo: Il contenuto del messaggio. Puoi usare formattazione Markdown di Discord (es.
**grassetto**, *corsivo*).
async def send_message(channel_id, text):
print(f"Sending to {channel_id}: {text}")
Blocco 'Embed' 📋
Gli embed sono messaggi ricchi e visivamente accattivanti che Discord permette di inviare. Sono ottimi per annunci, informazioni dettagliate o per presentare dati in modo più strutturato.
Parametri:
- Titolo: Il titolo dell'embed.
- Descrizione: Il testo principale dell'embed, supporta Markdown.
- Colore: Una barra laterale colorata per dare enfasi (codice esadecimale #RRGGBB).
- (Opzionale) URL: Un link per il titolo.
- (Opzionale) Immagine: URL di un'immagine da mostrare all'interno dell'embed.
async def send_embed(channel_id, title, description, color):
print(f"Sending embed to {channel_id}: Title='{title}', Color='{color}'")
Blocco 'Rispondi' ↩️
Questo blocco fa in modo che il bot risponda direttamente al messaggio o all'interazione che ha invocato il comando. È utile per feedback diretti e interazioni contestuali.
Parametri:
- Testo: Il contenuto del messaggio di risposta.
- Ephemeral: (Checkbox) Se selezionato, solo l'utente che ha invocato il comando vedrà la risposta (utile per comandi privati).
async def reply_to_interaction(interaction, text, ephemeral):
print(f"Replying to interaction (ephemeral={ephemeral}): {text}")
Blocco 'DM Utente' 📩
Permette al bot di inviare un messaggio diretto (DM) a un utente specifico. Ottimo per notifiche private, messaggi di benvenuto personalizzati o istruzioni riservate.
Parametri:
- Utente: L'utente a cui inviare il DM (ID utente o menzione).
- Testo: Il contenuto del messaggio privato.
async def send_dm(user_id, text):
print(f"Sending DM to {user_id}: {text}")
Blocco 'Dai/Togli Ruolo' 🏷️
Automatizza la gestione dei ruoli sul tuo server. Puoi aggiungere o rimuovere un ruolo specifico a un utente.
Parametri:
- Utente: L'utente a cui modificare il ruolo (automaticamente l'invocatore del comando).
- Ruolo: Il nome o l'ID del ruolo da assegnare/rimuovere.
- Azione: Scegli tra "Aggiungi" o "Rimuovi".
async def manage_role(member, role_id, action):
print(f"{action} role {role_id} for {member.id}")
Blocco 'Attendi' ⏳
Questo blocco introduce un ritardo nell'esecuzione del tuo comando. Utile per creare sequenze temporizzate o per non sovraccaricare le API di Discord.
Parametri:
- Secondi: La durata dell'attesa in secondi.
import asyncio
async def wait(seconds):
print(f"Waiting for {seconds} seconds...")
await asyncio.sleep(seconds)
print("Wait finished.")
Blocco 'Condizione' 🔀
Il blocco condizione ti permette di creare logiche ramificate, eseguendo blocchi diversi in base a un controllo. Ad esempio, puoi verificare se un utente ha un certo ruolo o se un messaggio contiene una parola chiave.
Parametri:
- Tipo di controllo: Ad esempio, "Utente ha Ruolo", "Messaggio contiene", "Variabile è uguale a".
- Valore: Il valore da confrontare (nome ruolo, testo, ecc.).
- Blocchi IF: I blocchi da eseguire se la condizione è vera.
- Blocchi ELSE (Opzionale): I blocchi da eseguire se la condizione è falsa.
def check_condition(type, value):
if type == "user_has_role":
return user.has_role(value)
return False
if check_condition("user_has_role", "Admin"):
print("Condition met!")
else:
print("Condition not met.")
Blocco 'Elimina Messaggio' 🗑️
Questo blocco ti permette di eliminare un messaggio specifico. Utile per la moderazione, pulire i canali o rimuovere risposte temporanee del bot.
Parametri:
- Messaggio: Il messaggio da eliminare (ID del messaggio).
- Ritardo (secondi): Tempo di attesa prima di eliminare il messaggio (0 per eliminare subito).
async def delete_message(message_id, delay):
import asyncio
if delay > 0:
print(f"Waiting {delay}s before deleting {message_id}")
await asyncio.sleep(delay)
print(f"Deleting message {message_id}")
Esportare i comandi
Attualmente, BotForge non supporta l'esportazione diretta del codice Python generato. L'anteprima del codice è fornita a scopo illustrativo per aiutare a capire la logica dei blocchi.
Stiamo lavorando per implementare funzionalità di esportazione e importazione in futuro, per una maggiore flessibilità.
Deployment avanzato
BotForge gestisce automaticamente il deployment e l'hosting dei tuoi bot. Non devi preoccuparti di server o configurazioni complicate. I tuoi bot sono sempre online e monitorati dai nostri sistemi.
Per grandi carichi di lavoro o esigenze specifiche, i piani a pagamento offrono opzioni di performance garantite e supporto dedicato.
FAQ Documentazione
Ecco alcune domande frequenti relative alla documentazione:
- La documentazione è aggiornata? Ci sforziamo di mantenere la documentazione il più aggiornata possibile. Se trovi discrepanze, segnalacelo!
- Posso contribuire? Al momento non accettiamo contributi esterni alla documentazione.
- Non trovo la mia risposta qui. Se non trovi la risposta che cerchi, contatta il nostro supporto o unisciti alla nostra community Discord.