Crea un bot AI per Discord in 10 minuti (senza codice)

Avvia il tuo chatbot AI su Discord

Vuoi creare un bot conversazionale intelligente per il tuo server Discord? Questa guida passo passo ti accompagna nella configurazione in soli 10 minuti, senza dover programmare!

Guarda il video

5 semplici passaggi per creare il tuo bot AI

Seguendo questi passaggi avrai un chatbot AI perfettamente funzionante sul tuo server Discord:

1. Crea un server Discord
2. Crea un’applicazione Discord
3. Aggiungi il bot al server
4. Crea un account Quickchat AI
5. Integra il bot Discord con Quickchat AI

Come sarà il tuo bot AI

Una volta configurato, il bot sarà online su Discord, pronto a sostenere conversazioni naturali con i membri del server.

Il metodo più rapido: attivazione con un clic

Se hai già un account Quickchat AI, puoi saltare completamente il Developer Portal. Nella dashboard, apri External Apps nella barra laterale sinistra, seleziona Discord e, sotto Connect, fai clic su Add to your Discord server.

La schermata di connessione con un clic, in External Apps → Discord.

Discord ti chiede di autorizzare l’app condivisa Quickchat AI e scegliere un server. Fai clic su Authorize e il bot è online: i membri possono @menzionarlo in qualsiasi canale. L’unico requisito è disporre del permesso Manage Server sul server scelto.

Chi si registra per la prima volta a Quickchat AI riceve una procedura iniziale dedicata a Discord che porta direttamente a questo flusso.

I nuovi iscritti iniziano con una schermata dedicata a Discord che conduce alla connessione con un clic.

I passaggi seguenti descrivono l’alternativa manuale, Use your own Discord app: crei la tua applicazione Discord e la colleghi tramite un token del bot. Scegli questa opzione se vuoi un nome e un avatar personalizzati, i messaggi diretti, le Discord AI Actions o più bot nello stesso server. Le Discord Actions richiedono la connessione di un bot tuo, perché questa fornisce il token usato per le richieste alle API di Discord.

1. Crea un server Discord

Se non hai un account Discord, creane uno su discord.com. Poi configura il tuo primo server:

2. Crea un’applicazione Discord

Vai al Discord Developer Portal e crea una nuova applicazione.

3. Aggiungi il bot al server Discord

Ricorda di abilitare la ricezione del contenuto dei messaggi per il bot attivando l’interruttore mostrato qui sotto:

Dopo aver creato il bot, devi aggiungerlo al server. Per farlo, costruisci un URL di Discord e incollalo nel browser:

https://discord.com/api/oauth2/authorize?client_id=<YOUR CLIENT ID>&permissions=309237713920&scope=bot

Da dove viene il numero dei permessi?

Il numero dei permessi (309237713920) corrisponde alla richiesta dei seguenti permessi:

• View Channels
• Send Messages
• Create Public Threads
• Send Messages in Threads
• Read Message History

Questo è l’insieme minimo di permessi necessario perché il bot funzioni correttamente. Puoi verificarlo su discord.com/developers/applications: seleziona l’applicazione, fai clic su Bot a sinistra e scorri verso il basso:

Dove trovi YOUR CLIENT ID?

Il modo più semplice è guardare la barra degli indirizzi del browser e copiare il numero lungo che fa parte dell’indirizzo:

https://discord.com/developers/applications/<YOUR CLIENT ID>/bot

In questo esempio il client ID è 1234567890123456789. L’URL completo da aprire per aggiungere il bot al server è quindi:

https://discord.com/api/oauth2/authorize?client_id=1234567890123456789&permissions=309237713920&scope=bot

Se qualcosa non funziona in questo passaggio:

• “Integration requires code grant”: nell’applicazione è attiva l’opzione Require OAuth2 Code Grant. Nel Developer Portal apri l’app, vai su Bot, disattiva l’opzione, salva e riapri l’URL di invito. (dettagli)
• Compare una torta o una schermata “baked”: è la pagina di conferma di Discord. Il bot è stato aggiunto. Verifica in Server Settings → Integrations → Bots and Apps.
• Suggerimento: quando incolli il token del bot nella dashboard di Quickchat AI (passaggio 5), la pagina dell’integrazione Discord costruisce questo URL di invito e mostra una checklist di configurazione. Puoi quindi evitare di comporre manualmente l’URL qui sopra.

4. Crea un account Quickchat AI

Registrati a Quickchat AI per dare al tuo bot un’AI conversazionale capace di rispondere in modo naturale.

Quickchat AI permette di creare AI Agents con basi di conoscenza personalizzate, AI Actions e molto altro, ideali per bot Discord, siti web e altri canali.

5. Integra il bot con Quickchat AI

Per collegare il bot a Quickchat AI, recupera il Discord Bot Token dal Developer Portal.

1. Vai su Bot Settings → Reset Token → Copy Token

2. Nella dashboard di Quickchat AI, apri External Apps → Discord, scegli Use your own Discord app e incolla il token. Quickchat AI attiva il bot e ne mostra lo stato durante l’avvio.

Se il bot non va online

Quando un bot non riesce ad avviarsi, la pagina dell’integrazione Discord mostra l’errore esatto e rimanda direttamente alla soluzione. I due casi più comuni sono:

• Token non valido: il token è errato oppure è stato rigenerato. Reimpostare un token rende quello precedente inutilizzabile. Apri il bot nel Developer Portal, vai su Bot → Reset Token, copia il nuovo token, poi fai clic su Reconnect in Quickchat AI e incollalo. Vedi Invalid bot token per la schermata esatta.
• Message Content Intent disattivato, segnalato come PrivilegedIntentsRequired: il bot si è connesso, ma non può leggere i messaggi. Apri il bot nel Developer Portal, vai su Bot → Privileged Gateway Intents, attiva Message Content Intent e salva. Vedi Message Content Intent per individuare l’interruttore.

Il bot si riavvia ogni volta che modifichi il token o le impostazioni. Attendi fino a un minuto perché torni online.

Se il tuo bot è online ma non risponde mai

Controlla se nello stesso server è ancora presente il bot condiviso Quickchat AI aggiunto con un clic. Quando entrambi sono nel server, risponde il bot condiviso e quello personale resta silenzioso, anche se token, intent e permessi sono corretti. Apri External Apps nella dashboard di Quickchat AI, trova il server sotto Connected servers nella configurazione con un clic e rimuovilo da lì. Il tuo bot subentra immediatamente. Vedi Both bots are in the same server.

Il tuo bot AI è online!

Torna su Discord: il bot dovrebbe essere online e pronto a chattare. Basta @menzionarlo per iniziare una conversazione.

Quando viene @menzionato, il bot risponde nel canale per impostazione predefinita. Se scegli Thread nell’impostazione Reply in, crea un thread nel quale gli utenti possono continuare senza menzionarlo di nuovo.

Come risponde il bot

Il bot può essere attivato in diversi modi, ognuno con un comportamento diverso rispetto alla cronologia della conversazione:

Un normale messaggio nel canale non attiva nulla. È una scelta voluta, per mantenere silenzioso il bot nei server affollati, ed è il motivo più frequente per cui un bot appena aggiunto sembra non funzionare. /ask esiste anche come alternativa più facile da trovare: digitando / in un canale compare nell’elenco e funziona dove l’accesso al contenuto dei messaggi è limitato. È registrato sul bot condiviso con connessione in un clic. Se colleghi la tua applicazione, devi usare le @menzioni.

L’impostazione “Reply in”

Nella dashboard di Quickchat, in Channels > External Apps > Discord, il menu “Reply in:” offre due opzioni:

• Channel (predefinita): il bot risponde direttamente nel canale in cui viene menzionato. Ogni @menzione avvia una nuova conversazione senza memoria delle interazioni precedenti.
• Thread: il bot crea un nuovo thread per ogni @menzione. Il nome del thread contiene il nome del bot e quello dell’utente, per esempio “Aria & john_doe”. Nel thread il bot risponde a ogni messaggio senza richiedere una @menzione, e conserva tutta la cronologia della conversazione.

Messaggi diretti

I DM richiedono una tua applicazione Discord. Il bot condiviso con connessione in un clic risponde solo nei server, perché rispondere a DM non richiesti tramite un’unica identità condivisa avrebbe effetti su tutti i server che serve.

Con la tua applicazione, nei DM non serve la @menzione. Il bot risponde a ogni messaggio e mantiene la cronologia per tutta la sessione. Quando risponde nei DM, non ha accesso alla cronologia dei canali del server.

Nota: il bot risponde solo nei thread che ha creato. Se qualcuno crea un thread manualmente e vi scrive, il bot non risponde.

Come il bot comprende il contesto del canale

Quando qualcuno @menziona il bot in un canale, il bot non vede soltanto il messaggio in cui è stato menzionato. Recupera automaticamente i messaggi recenti del canale e li include nel prompt dell’AI come trascrizione con data e ora. Può così comprendere la conversazione in corso e fare riferimento a quanto detto prima.

Ecco un esempio di come appare quel contesto dal punto di vista dell’AI:

Most recent messages on the #general channel:
[2026-02-19 14:01] alice: Has anyone tried the new API endpoint?
[2026-02-19 14:03] bob: Yeah, I got a 429 back after about 50 requests
[2026-02-19 14:05] alice: @QuickchatBot what's the rate limit for the v2 API?

Il bot legge anche i messaggi dei thread attivi e archiviati nel canale, includendo così nel contesto le discussioni nei thread.

Quando qualcuno usa la funzione Reply di Discord per rispondere a un messaggio specifico, il bot restringe il contesto ai messaggi immediatamente vicini a quello citato, invece di recuperare tutta la cronologia recente. Ottiene così il contesto mirato della conversazione a cui l’utente si riferisce.

I contenuti speciali dei messaggi, come sticker, GIF, immagini, embed e reazioni, sono rappresentati con annotazioni. Il bot sa quindi che esistono, anche se non li vede visivamente nella trascrizione del contesto. I token delle @menzioni vengono sostituiti con nomi visualizzati leggibili.

Non è necessaria alcuna configurazione. Il contesto del canale è attivo per impostazione predefinita per tutti i bot Quickchat AI su Discord.

Ricerca AI intelligente nella cronologia del server

Per impostazione predefinita, il bot legge solo i messaggi del canale in cui è stato menzionato. Attivando Smart AI search over server history, l’AI può interrogare i messaggi di qualsiasi canale testuale del server. Decide quale canale consultare in base alla domanda dell’utente.

Per esempio, se qualcuno chiede in #general “qual è stata la conclusione in #engineering sulla migrazione?”, il bot può leggere la cronologia recente di #engineering e rispondere in base a ciò che trova.

La funzione supporta anche filtri per intervalli temporali e paginazione, così l’AI può risalire più indietro nella cronologia quando serve.

Nota: Smart AI search over server history è attualmente in beta. Se ti interessa, contattaci via email o sul server Discord di Quickchat.

Inviare immagini al bot

Gli utenti possono allegare un’immagine quando @menzionano il bot. L’AI la elaborerà tramite le proprie capacità visive. I formati supportati sono PNG, JPG, JPEG, GIF e WebP. Se vengono allegate più immagini, il bot elabora la prima.

L’URL dell’immagine sulla CDN di Discord viene passato al modello AI insieme al testo del messaggio come input multimodale. L’AI vede quindi sia il testo sia l’immagine nello stesso turno. Non serve alcuna configurazione: la comprensione delle immagini è attiva per impostazione predefinita.

Alcuni esempi pratici per le community Discord:

• Community di sviluppatori: un utente invia uno screenshot di uno stack trace o di un errore e chiede al bot di spiegarlo.
• Community di design: un utente condivide un mockup di interfaccia e chiede un parere al bot.
• Community di gaming: un utente condivide uno screenshot delle impostazioni di un gioco e chiede suggerimenti per ottimizzarle.
• Supporto e-commerce: un cliente invia la foto di un prodotto difettoso al bot di assistenza.

Collegare le AI Actions a Discord

Le AI Actions permettono al bot di chiamare API e strumenti esterni durante una conversazione Discord. Si configurano una sola volta nella dashboard di Quickchat, in AI Agent > Actions & MCPs, e funzionano su tutti i canali: Discord, widget del sito, WhatsApp, Telegram e altri.

Sono disponibili due tipi di azioni:

Ecco alcuni esempi di ciò che puoi realizzare con le AI Actions su Discord:

• Bot per il tracciamento degli ordini: collega un’API Action al backend del tuo e-commerce, così i membri possono chiedere “dov’è il mio ordine #12345?” e ricevere lo stato in tempo reale.
• Bot per le issue GitHub: collega un Remote MCP al tuo repository GitHub, così gli sviluppatori possono chiedere al bot “ci sono bug aperti con il tag critical?” direttamente da Discord.
• Bot per i ticket di supporto: lascia che il bot risponda usando la documentazione e apra un thread privato per il ticket con una menzione al ruolo di supporto solo quando non riesce a risolvere il problema.
• Assistente alla moderazione: scegli i template per timeout, espulsioni, ban e slowmode, così i moderatori possono eseguirli con richieste in linguaggio naturale.
• Pianificazione di appuntamenti: collega un Remote MCP a Cal.com o Google Calendar per permettere agli utenti di prenotare appuntamenti con il team da Discord.
• Integrazione CRM: collega HubSpot per consentire al bot di registrare lead o creare ticket dalle conversazioni Discord.
• Registrazione di lead e feedback: collega Google Sheets per registrare lead, domande senza risposta e richieste di demo dalle conversazioni Discord direttamente in un foglio già usato dal team.

Configurare un’API Action

1. Nella dashboard di Quickchat, vai su AI Agent > Actions & MCPs.
2. Fai clic su Add Action. Per un’operazione Discord supportata, scegli Discord Action e seleziona un template. Il template di supporto richiede server, canale e ruolo; i template di moderazione si installano direttamente. Quickchat crea la richiesta modificabile, la descrizione, i parametri, la gestione della risposta e le condizioni di esecuzione.
3. Solo quando ti serve un endpoint non presente nella galleria, scegli un’azione HTTP Request personalizzata. Assegna un nome, per esempio “Controlla stato ordine”, e una descrizione che indichi all’AI quando usarla, per esempio “Usala quando un utente chiede lo stato del suo ordine. Chiedi prima il numero dell’ordine.”
4. Imposta il metodo HTTP, per esempio GET, l’URL dell’endpoint e gli eventuali parametri, poi salva.

L’azione è ora disponibile all’Agent nei canali supportati. Le Discord Actions della galleria sono normali HTTP Request Actions modificabili: dopo una modifica, controlla autorizzazioni, destinazioni e parametri. Per una spiegazione più dettagliata, consulta il tutorial sulle AI Actions di HubSpot, la guida al bot di moderazione Discord, che tratta timeout, espulsioni, ban, ruoli e slowmode come AI Actions, oppure la documentazione delle Actions.

Altre letture

Queste guide approfondiscono argomenti collegati:

• Come creare un chatbot AI per il roleplay che rimanga nel personaggio: trasforma lo stesso bot in un personaggio persistente con un proprio canone narrativo.
• Come creare un chatbot AI per Telegram: pubblica lo stesso AI Agent su Telegram.
• Crea un bot AI per WhatsApp: guida all’integrazione WhatsApp.
• AI Actions di HubSpot: tutorial passo passo per configurare le API Actions.
• Bot AI per i ticket Discord: rispondi dalla base di conoscenza e inoltra il resto in thread privati per i ticket.
• Bot di benvenuto Discord: saluta nuovi membri, nuovi thread e nuovi canali ticket con un messaggio fisso.
• Collega un AI Agent ai ticket Jira: esempio di Remote MCP con Jira.
• MCP spiegato: cos’è il Model Context Protocol e come funziona.
• Documentazione delle Actions: riferimento completo.

Registrati a Quickchat AI per iniziare a creare il tuo AI Agent, oppure unisciti alla community su Discord: discord.gg/KqkHwvPRNH