Salta ai contenuti

Collega Quickchat AI a Discord. Aggiungi il bot condiviso Quickchat AI con un clic e scegli un nome per ogni server, oppure usa una tua app Discord per un avatar personalizzato, messaggi diretti e AI Actions. Scopri anche cosa fare se entrambi i bot si trovano nello stesso server.

Puoi collegare il tuo AI Agent a Discord in due modi:

  1. Aggiungi al tuo server Discord: la procedura consigliata con un clic. Non servono il Developer Portal né un token del bot; sarà attivo in meno di un minuto.
  2. La tua app Discord: la procedura avanzata in cui crei un’applicazione Discord e fornisci tu un token del bot.

Ti consigliamo la procedura con un clic. Potrai passare a una tua app in seguito se ti serviranno le funzioni avanzate.

È la prima volta che usi Quickchat AI? Crea un account gratuito, poi torna qui. Puoi anche scoprire di più su Quickchat AI per Discord.

  • Verifica i prerequisiti di configurazione di Discord. Controlla le impostazioni dichiarate per bot e canali e individua eventuali lacune. Lo strumento non esamina il tuo account Discord e non installa bot.

  • Prepara un piccolo kit di lancio. Trasforma un obiettivo, un canale, le indicazioni per il passaggio a un operatore e fino a cinque coppie di domande e risposte in testi di configurazione e test sintetici. Lo strumento non crea né valuta un AI Agent.

Nella dashboard Quickchat AI, apri App esterne nella barra laterale sinistra, trova Discord e aprilo. Sotto Collega, controlla Nome del bot nel nuovo server, già compilato con il nome dell’AI Agent. Puoi modificarlo o lasciarlo vuoto per usare Quickchat AI, poi fai clic su Aggiungi al tuo server Discord. Devi avere il permesso Manage Server sul server di destinazione.

Aggiungere il bot al server Discord

Vieni reindirizzato a Discord per autorizzare l’app condivisa Quickchat AI. Scegli il server desiderato e fai clic su Authorize. Quickchat applica il nome scelto prima che il bot pubblichi il suo messaggio di presentazione, una sola volta: “Ready! @mention me or use /ask to chat. Powered by Quickchat AI.” Poi torni a Quickchat AI.

Il passaggio successivo dipende dal punto in cui ti trovi nella configurazione. Se stai ancora configurando un nuovo account, Quickchat conferma il server collegato e mostra Descrivi l’AI Agent che vuoi creare. Descrivi lo scopo del bot in una frase, poi fai clic su Crea il mio AI Agent. Quickchat ne crea il nome, Prompt principale, Linee guida e spunti di conversazione.

Quando l’identità di base è pronta, aggiungi fonti alla Base di conoscenza per ottenere risposte più accurate e aggiungi Actions se vuoi che il bot svolga attività. Prosegui con Scegli il piano. Poiché Discord è già collegato, Quickchat non ti chiede di distribuirlo di nuovo. Se la configurazione era già completa quando hai autorizzato Discord, torni invece alla dashboard.

A questo punto l’autorizzazione è completa. 🎉 Il tuo AI Agent è attivo su Discord. I membri avviano una conversazione @menzionandolo in un canale, e il bot risponde nei canali o nei thread.

Ogni conversazione Discord compare nella Posta in arrivo di Quickchat AI. Quando l’AI Agent passa una conversazione a un collega, quest’ultimo può prenderla in carico nella Posta in arrivo e rispondere direttamente nello stesso canale, thread o messaggio diretto di Discord.

I nuovi iscritti a Quickchat AI vedono una configurazione dedicata a Discord, in cui possono prima descrivere l’Agent desiderato oppure aggiungerlo a Discord. Qualunque azione scelgano per prima, la configurazione li guida nell’altra prima della scelta del piano.

Il bot non risponde a ogni messaggio del canale. Risponde quando viene @menzionato, quando qualcuno usa il comando /ask, quando qualcuno risponde a un suo messaggio e nei thread che ha creato. Ignora intenzionalmente tutto il resto per non intervenire continuamente nei server molto attivi.

È utile spiegarlo ai membri: un normale messaggio senza risposta può far pensare che il bot non funzioni, anziché che stia aspettando di essere interpellato.

Spesso /ask è più facile da trovare: digitando / in qualsiasi canale compare “Ask the Quickchat AI agent a question”, e funziona anche dove l’accesso al contenuto dei messaggi è limitato. È disponibile solo sul bot con un clic; se usi una tua app Discord, usa le @menzioni.

Solo le persone possono parlargli. In entrambe le configurazioni, il bot ignora i messaggi scritti da altri bot, app e webhook, anche se lo @menzionano. Un post di Zapier, n8n, Make o un altro bot non riceve mai risposta, quindi un altro bot non può conversare con lui. I messaggi automatici funzionano diversamente: seguono eventi del server, come l’apertura di un canale da parte di un bot per ticket, non messaggi.

Non pubblica a orari programmati. Ogni messaggio del bot segue qualcosa appena accaduto: il messaggio di un membro, la risposta di un collega dalla Posta in arrivo o un evento Discord monitorato da una regola di Messaggi automatici, oltre alla presentazione che il bot con un clic pubblica una sola volta quando entra nel server. Non pubblica nulla in base a un timer o a una programmazione ricorrente.

La Modalità di risposta decide dove il bot pubblica le risposte, non a quali messaggi risponde. La trovi in Impostazioni, sotto App esterne → Discord. Vale sia per il bot con un clic sia per la tua app Discord:

  • Rispondi nel canale (impostazione predefinita): il bot risponde nel canale in cui è stato @menzionato.
  • Rispondi nei thread: il bot crea un nuovo thread dal messaggio che lo ha @menzionato e risponde lì. I membri continuano in quel thread senza menzionare di nuovo il bot.

In entrambe le modalità, i messaggi in un thread ricevono risposta solo se il thread è stato creato dal bot stesso. I thread e i post nel forum creati da chiunque altro vengono ignorati, anche quando un membro vi @menziona il bot. Vedi Il bot non risponde in un thread o in un post nel forum.

Su Discord, l’AI Agent sa chi ha scritto il messaggio a cui sta rispondendo e come menzionarlo, quindi basta specificare quando farlo in una Guideline. Per esempio:

If the message is off topic, reply with "Invalid prompt!" and mention the member who wrote it.

La risposta contiene quindi una vera menzione Discord del membro, visualizzata come un’etichetta cliccabile. Il bot non aggiunge mai menzioni di propria iniziativa: lo fa solo quando il Prompt principale o una Guideline gli chiede di menzionare o taggare il membro.

Da sapere:

  • Scrivi “menziona il membro” invece di indicare un formato. In particolare, non chiedere di racchiudere l’ID utente tra <#...>: è la sintassi Discord per i canali, non menziona nessuno e il bot segue alla lettera un’istruzione del genere.
  • La menzione appare come un’etichetta, ma per ora non invia una notifica al membro. Un futuro aggiornamento del bot Discord aggiungerà la notifica.
  • In Anteprima AI e negli altri canali non c’è un membro Discord da menzionare, quindi il bot risponde senza menzione.

Ogni risposta viene generata da un modello linguistico e consuma la quota di messaggi AI del tuo piano. Un server molto attivo può esaurire rapidamente la quota gratuita; quando finisce, il bot lo segnala nel canale invece di rispondere. La quota si rinnova ogni mese.

La pagina Discord elenca sotto Server collegati tutti i server in cui il bot condiviso è attivo. Da qui puoi:

  • Cambiare il nome del bot anche in seguito. Inserisci fino a 32 caratteri in Nome del bot in questo server, poi fai clic su Applica. Svuota il campo e fai clic su Applica per ripristinare il nome condiviso Quickchat AI.
  • Usare Aggiungi a un altro server con la stessa procedura con un clic. Controlla Nome del bot nel nuovo server prima di autorizzare, così lo stesso AI Agent può avere un nome diverso in ogni server.
  • Rimuovere il bot da un server con Rimuovi. Lascia il server e smette di rispondere; puoi aggiungerlo di nuovo in qualsiasi momento.

Ogni server collegato dispone anche di Messaggi automatici, descritti più avanti in Messaggi automatici.

Con il bot con un clic, un server Discord può essere collegato a un solo AI Agent alla volta. Se vedi “This server already has an AI Agent” (o un messaggio che ne indica il nome), il bot condiviso è già collegato lì. Per mantenere entrambi gli AI Agent nel server, fai clic su Usa configurazione avanzata e segui Usare più AI Agent nello stesso server. Per spostare invece il bot condiviso su questo AI Agent, fai clic su Sposta qui e conferma nella schermata di Discord. Il bot resta nel server e risponde per questo AI Agent anziché per l’altro. Sposta qui compare quando puoi modificare l’AI Agent a cui è collegato il server; altrimenti, chiedi a chi può modificare quell’Agent di rimuoverne prima il bot.

Se Discord si collega ma non applica il nome del bot, usa Applica sul server collegato per riprovare. Se Discord segnala un problema di permessi, fai clic su Aggiungi a un altro server, scegli lo stesso server e autorizzalo nuovamente. Questo aggiorna i permessi del bot senza doverlo prima rimuovere.

Il bot con un clic usa sempre l’applicazione condivisa Quickchat AI e il suo avatar. Quickchat AI non offre un’impostazione per cambiarne l’avatar, e l’Avatar dell’agente AI configurato per la chat del sito non viene usato su Discord. Puoi modificare solo il nome del bot in ciascun server con Nome del bot in questo server e Applica (fino a 32 caratteri, come descritto sopra). Configura una tua app Discord (vedi sotto) se vuoi:

  • Un avatar personalizzato per il bot (vedi Impostare l’avatar del bot)
  • Messaggi diretti
  • Discord AI Actions. Il bot condiviso non espone il suo token come System Token {{discord_bot_token}}, necessario per queste Actions, quindi richiedono una tua app. Nella configurazione con un clic, il link Esplora le Azioni Discord sotto Vuoi che il tuo agente AI si occupi della moderazione o apra ticket? porta a queste Actions.
  • Più bot nello stesso server, per esempio uno per personaggio. Vedi Usare più AI Agent nello stesso server.

Il bot condiviso e il tuo possono funzionare contemporaneamente. La tua app subentra in un server solo quando rimuovi il bot condiviso da quel server.

Usare una tua app Discord (Configurazione avanzata)

Sezione intitolata “Usare una tua app Discord (Configurazione avanzata)”

Questa è la procedura avanzata e richiede circa 10 minuti. Nella dashboard, apri App esterne → Discord e accedi a La tua app Discord tramite il link Configurazione avanzata. Creerai una tua applicazione Discord, la aggiungerai al server e la collegherai a Quickchat AI con un token del bot.

Play

Per avviare l’integrazione ti serve un server Discord. Se non hai un account Discord, visita discord.com e creane uno. Una volta effettuato l’accesso, segui questa guida per creare il server Discord.

Accedi al tuo account Discord, vai su discord.com/developers/applications e crea una nuova applicazione.

Prima di aggiungere il bot al server, attiva Message Content Intent per l’applicazione. Questo consente al bot di leggere i messaggi inviati dagli utenti nel server.

Interfaccia Quickchat AI

Il bot con un clic mostra sempre l’avatar condiviso di Quickchat AI, e l’Avatar dell’agente AI configurato per la chat del sito non viene usato su Discord. Con una tua app Discord, il bot mostra l’avatar che gli assegni su Discord. Apri l’applicazione nel Developer Portal, vai a Bot, carica l’immagine da usare come icona del bot e salva le modifiche. L’icona in General Information è un’immagine separata: è l’icona pubblica dell’app, non quella che i membri vedono accanto ai messaggi del bot. Quickchat AI non modifica nessuna delle due.

Ora devi aggiungere il bot al server. Per farlo, componi un URL 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) deriva dalla richiesta dei seguenti permessi:

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

È l’insieme minimo di permessi necessario per il corretto funzionamento del bot. Puoi verificarlo su discord.com/developers/applications: seleziona l’applicazione, fai clic su Bot a sinistra e scorri verso il basso:

Permessi del bot Discord

Verifica i permessi Discord usando i permessi e la configurazione di pubblicazione che fornisci. La verifica usa i valori dichiarati senza accedere al tuo account Discord.

Dove trovare 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

Client ID

In questo caso il client ID è 1234567890123456789, quindi l’URL completo da aprire per aggiungere il bot al server è:

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

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

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

Reimpostare il token

  1. Nella dashboard Quickchat AI, apri App esterne → Discord, scegli La tua app Discord tramite Configurazione avanzata e incolla il token. Quickchat AI accende il bot e ne comunica lo stato durante l’avvio.

Una stessa app Discord può essere collegata a un solo AI Agent alla volta. Se vedi “This Discord app is already connected to another AI Agent.”, scollegala da quell’Agent prima di collegarla qui.

Incollare il token

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

Bot attivo

Per impostazione predefinita, quando viene @menzionato il bot risponde nello stesso canale. Puoi cambiare questo comportamento con Modalità di risposta nell’integrazione: Rispondi nel canale (impostazione predefinita) oppure Rispondi nei thread. Con Rispondi nei thread, il bot risponde in un thread e gli utenti possono proseguire lì senza menzionarlo di nuovo.

Conversazione in un thread

Ogni AI Agent collegato con un clic risponde tramite lo stesso bot condiviso Quickchat AI, che è un unico membro del server. Perciò un server può ospitare un solo AI Agent con un clic alla volta, e Quickchat rifiuta di collegarne un secondo.

Per usare più AI Agent nello stesso server, per esempio con un personaggio diverso per ciascuno, assegna a ogni AI Agent aggiuntivo una propria app Discord e collegala con Configurazione avanzata:

  1. Nel Developer Portal, crea un’applicazione per ogni AI Agent e assegna a ciascun bot il nome e l’avatar che i membri devono vedere.
  2. Per ciascuno, segui Usare una tua app Discord qui sopra: attiva Message Content Intent, aggiungi il bot al server e incolla il suo token in Configurazione avanzata del relativo AI Agent.

Un’app Discord si collega a un solo AI Agent, quindi ogni AI Agent ne richiede una propria. Un AI Agent già collegato con un clic può restare nel server: il bot condiviso continua a rispondere per lui, mentre ciascun bot di tua proprietà risponde per il proprio AI Agent.

Come i bot condividono il server:

  • Ogni bot risponde solo ai messaggi rivolti a lui: una sua @menzione, una risposta a un suo messaggio o un messaggio in un thread che ha aperto. Gli altri bot li ignorano; nei thread risponde solo il bot che li ha aperti.
  • I bot non rispondono mai agli altri bot, quindi i tuoi AI Agent non conversano tra loro.
  • Tutti possono usare gli stessi canali. Per escludere un bot da un canale, rimuovi lì il suo permesso View Channel.
  • Ogni AI Agent ha un proprio Modalità di risposta. Con Rispondi nei thread, ogni conversazione ha il suo thread e i bot restano separati anche nei canali molto attivi.
  • Assegna nomi ben distinti ai bot. Un bot risponde a qualsiasi messaggio contenente ”@” seguito dal suo nome, quindi un bot chiamato Luna risponde anche a una menzione di Luna Prime.

Un personaggio è un AI Agent con una propria personalità. Definiscila in Identità: chi è, come parla e cosa non dice mai vanno indicati nel Prompt principale e nelle Linee guida.

Ogni personaggio richiede un proprio AI Agent e un proprio bot. Un personaggio può usare il bot con un clic; per inserirne più di uno nello stesso server, vedi Usare più AI Agent nello stesso server. Per creare un personaggio a partire da uno esistente, duplica l’AI Agent: la copia conserva la personalità, ma non il collegamento Discord.

Ogni AI Agent ha un proprio piano. Il piano Free è riservato all’uso personale e non commerciale; vedi Piani e limiti.

Messaggi automatici pubblica un messaggio fisso, modificabile, dopo un evento Discord: l’arrivo di un membro, un nuovo thread o post del forum, oppure un nuovo canale. Non invoca l’AI Agent e non consuma crediti di conversazione; ogni regola resta disattivata finché non la attivi. Nessuna regola viene eseguita a un’ora prestabilita o con una frequenza ricorrente. Funziona con entrambe le configurazioni:

  • Con un clic: sotto Server collegati, seleziona Messaggi automatici sul server desiderato.
  • Con una tua app Discord: apri Configurazione avanzata, trova Messaggi automatici e seleziona Configura sul server desiderato. Perché il server compaia, il bot deve già esserne membro.

Le tre regole per i messaggi automatici di un server Discord collegato

Sono disponibili tre regole, ciascuna con un proprio interruttore:

  • Ingresso di un nuovo membro: scegli un Canale di benvenuto in cui il bot saluta ogni nuovo membro. L’ingresso di altri bot viene ignorato.
  • Nuovo thread o post nel forum: scegli un Canale principale (testuale, annunci, forum o media). Il bot pubblica in ogni nuovo thread pubblico al suo interno e ignora i thread privati.
  • Nuovo canale: il bot pubblica in ogni nuovo canale testuale. Per restringere l’ambito, cambia Qualsiasi categoria in Solo in questa categoria. Una configurazione comune consiste nell’abbinarla alla categoria Active Tickets di un bot per ticket.

Seleziona una regola per aprirla. Anche l’attivazione di una regola senza destinazione apre la sua configurazione, così puoi sceglierne una.

All’interno della regola, modifica Modello del messaggio e scegli un Ritardo: Nessun ritardo, oppure 2, 5, 10 o 30 secondi. Il ritardo predefinito di 2 secondi permette a un bot per ticket o onboarding di pubblicare per primo. Seleziona un segnaposto per inserirlo nella posizione del cursore:

  • {display_name}: il soprannome del membro nel server, in alternativa il nome visualizzato globale e infine il nome utente.
  • {username}: alias retrocompatibile di {display_name}, mantenuto affinché i modelli esistenti continuino a salutare le persone nello stesso modo. Nei nuovi modelli usa {display_name}.
  • {user_handle}: il nome utente Discord effettivo del membro, come marta.nebula.
  • {user_mention}: una menzione che invia una notifica al membro.
  • {user_id}: l’ID utente numerico Discord del membro.
  • {bot_name}: il nome visualizzato del bot nel server.
  • {server_name}: il nome del server.
  • {channel_name}: il nome del canale.

In un canale aperto da un altro bot, quando possibile la persona viene identificata da un unico permesso View Channel assegnato a un membro specifico. Se il richiedente non è identificabile in modo univoco, {display_name}, {username}, {user_handle} e {user_mention} diventano there, la menzione non notifica nessuno e {user_id} resta vuoto. Scrivi il messaggio in modo che risulti naturale in entrambi i casi.

Ogni regola si salva separatamente. Salva salva la regola e torna all’elenco, mentre gli interruttori nell’elenco si salvano appena li cambi. Uscire da una regola in qualsiasi altro modo annulla le modifiche apportate al suo interno.

Per il bot con un clic, una modifica salvata si applica subito. Un bot collegato tramite Configurazione avanzata aggiorna queste regole entro circa un minuto. Modificare Ingresso di un nuovo membro può anche riavviare quel bot per aggiornare Server Members Intent.

Il bot deve poter vedere e inviare messaggi in ogni destinazione selezionata. Se una categoria o un canale viene poi eliminato su Discord, salvando la regola che vi fa riferimento scoprirai quale selezione manca; le altre regole continuano a salvarsi normalmente.

Ingresso di un nuovo membro è l’unica regola che richiede un intervento nel Developer Portal di Discord, e solo se usi una tua app Discord. Discord considera l’informazione su chi entra nel server un intent privilegiato, disattivato per impostazione predefinita: senza di esso, il bot non rileva mai l’arrivo di un membro.

Quickchat AI lo controlla per te. Quando apri la regola, segnala se l’intent è disattivato e non mostra avvisi quando è attivo. Per attivarlo, apri l’applicazione nel Developer Portal, vai a Bot → Privileged Gateway Intents, attiva Server Members Intent, salva e poi salva di nuovo la regola in Quickchat AI. Nel frattempo il bot continua a rispondere normalmente; resta in attesa solo questa regola.

Se il tuo bot è presente in più di 100 server, Discord richiede la verifica dell’applicazione prima di concedere l’intent.

Le altre due regole non richiedono nulla in più, e il bot con un clic non richiede alcun intervento: l’applicazione condivisa Quickchat AI ha già l’intent attivo.

Dopo aver collegato la tua app Discord, apri Azioni e MCP, fai clic su + Aggiungi azione e scegli Discord Action. La galleria installa Actions complete per assistenza e moderazione:

  • Assistenza e ticket: seleziona un server e un canale testuale, poi, facoltativamente, un ruolo di assistenza menzionabile. Una sola installazione crea tre Actions modificabili che aprono un thread privato, aggiungono il richiedente e, se previsto, avvisano l’assistenza.
  • Moderazione: timeout, espulsione, ban, rimozione del ban, assegnazione di ruoli, attivazione della modalità lenta e invio di annunci. Ogni modello crea una Action modificabile.

Quickchat compila sul backend metodo, URL, header, corpo, parametri, descrizione, gestione della risposta e condizioni Esegui solo quando di ogni Action. Le Actions risultanti usano l’editor standard e rimangono interamente modificabili.

Ogni modello di moderazione parte da author_is_admin is true. Discord fornisce questo valore per l’autore del messaggio corrente e Quickchat lo verifica prima di chiamare l’Action. La chat pubblica e i metadati API non possono impostarlo. Mantieni questa condizione, a meno che tu non abbia progettato un altro controllo di autorizzazione affidabile. I modelli non aggiungono messaggi di conferma, protezione contro la ripetizione delle richieste, gestione dei tentativi successivi o una politica separata per permessi e gerarchia dei ruoli. Discord continua a verificare i permessi del bot e la posizione del suo ruolo.

Le Actions di moderazione non agiscono mai da sole. Timeout, espulsioni e ban vengono eseguiti solo quando un amministratore del server li richiede nella conversazione (le descrizioni delle Actions indicano all’Agent di agire su richiesta di un amministratore). Non contano le infrazioni né ricordano gli avvertimenti di conversazioni precedenti; non applicano sanzioni programmate o automatiche, non chiedono conferma prima di espellere o bannare e non verificano le prove: se un membro invia uno screenshot, l’Agent non può stabilire se sia autentico. Il bot condiviso con un clic non può eseguire Actions di moderazione.

Le Discord Actions richiedono il token del bot da Configurazione avanzata con una tua app Discord. Il solo bot condiviso con un clic non può fornirlo. Prova le Actions di moderazione nel server Discord con un account amministratore e uno non amministratore; Anteprima AI non fornisce un mittente Discord autorizzato.

Support Ticket usa Salva in memoria e Esegui solo quando invece di un motore di workflow dedicato. La prima Action salva l’ID del thread restituito da Discord come discord_ticket_thread_id. Le due successive leggono quel valore per aggiungere il richiedente e pubblicare la notifica. Descrivi lo stesso ordine nel prompt principale dell’Agent. Se un risultato è incerto, controlla Discord e il log dell’Action prima di riprovare. L’ID salvato non viene cancellato automaticamente, quindi la configurazione iniziale supporta un ticket per conversazione Quickchat. Avvia una nuova conversazione o un nuovo thread Discord per un altro ticket, oppure modifica le Actions per gestire il ciclo di vita della memoria secondo le tue esigenze.

Per Support Ticket, assegna al bot View Channels, Send Messages, Read Message History, Create Private Threads, Send Messages in Threads e Manage Threads nel canale dei ticket selezionato. La notifica a un ruolo è facoltativa. Se scegli un ruolo di assistenza, rendilo menzionabile e consenti ai suoi membri di accedere ai thread privati. Se non sono disponibili ruoli menzionabili, i ticket si aprono normalmente senza notificare un ruolo. Il selettore elenca canali testuali e ruoli menzionabili, ma non verifica tutte le impostazioni specifiche dei permessi dei canali.

Vedi Actions per la configurazione generata e i limiti dell’MVP.

Se Quickchat AI segnala un errore nella pagina dell’integrazione Discord, il relativo link porta direttamente alla sezione corrispondente qui sotto.

La procedura con un clic presenta raramente errori. Se il collegamento non viene completato:

  • “This server already has an AI Agent”: il bot condiviso è collegato a un altro Agent (il messaggio ne indica il nome se appartiene al tuo account). Fai clic su Usa configurazione avanzata per collegare il secondo Agent con una propria app Discord: vedi Usare più AI Agent nello stesso server. Per spostare invece il bot condiviso, fai clic su Sposta qui e conferma nella schermata di Discord. Il pulsante compare quando puoi modificare l’Agent a cui è collegato il server; altrimenti, chiedi a chi può modificare quell’Agent di rimuoverne prima il bot.
  • “That Discord link has already been used”: ogni link di autorizzazione funziona una volta sola, quindi tornare indietro o ricaricare dopo il ritorno da Discord porta a questo errore. Non è stato collegato nulla. Fai clic su Aggiungi al tuo server Discord in questa pagina per ricominciare.
  • “You do not have permission to connect Discord for this AI Agent”: collegare un canale è un’operazione riservata agli editor. Chiedi a un amministratore o editor dell’account di farlo e verifica di avere il permesso Manage Server sul server Discord scelto.
  • “Discord authorization was cancelled”: hai chiuso la schermata di autorizzazione Discord prima di terminare. Non è stato collegato nulla; fai clic su Aggiungi al tuo server Discord e riprova.

Quasi sempre significa che nessuno si è ancora rivolto a lui. Il bot risponde alle @menzioni, alle risposte ai suoi messaggi e ai messaggi nei thread che ha creato, ignorando il resto. Il bot con un clic risponde anche a /ask. @Menzionalo e verifica se risponde.

Se continua a non rispondere, controlla che il suo ruolo e le impostazioni specifiche dei permessi del canale consentano View Channel, Send Messages e Read Message History proprio in quel canale.

Se prima rispondeva e ora non lo fa più, controlla se la quota mensile di messaggi AI è esaurita.

Il bot non risponde in un thread o in un post nel forum

Sezione intitolata “Il bot non risponde in un thread o in un post nel forum”

È voluto, in entrambe le configurazioni. Il bot risponde ai messaggi in un thread solo se ha creato lui quel thread, quindi ignora i thread e i post nel forum creati dai membri, anche quando qualcuno lo @menziona lì. Rispondi nei thread non cambia questo comportamento: fa sì che il bot crei i propri thread, non che entri in quelli esistenti.

Chiedi invece ai membri di @menzionare il bot in un normale canale. Con Rispondi nel canale, risponde direttamente lì. Con Rispondi nei thread, crea un proprio thread da quel messaggio e la conversazione prosegue in quel thread. Per farlo, il bot ha bisogno di Create Public Threads e Send Messages in Threads nel canale, altrimenti resta in silenzio. Con il bot con un clic, /ask risponde anche a una singola domanda in un thread o in un post nel forum.

La regola Nuovo thread o post nel forum in Messaggi automatici pubblica il tuo messaggio fisso in ogni nuovo thread o post nel forum sotto il canale che scegli. Quel messaggio non è una risposta dell’AI, e nemmeno le risposte a quel messaggio ricevono una risposta dell’AI.

I post di Zapier, n8n o un altro bot non ricevono risposta

Sezione intitolata “I post di Zapier, n8n o un altro bot non ricevono risposta”

È il comportamento previsto. In entrambe le configurazioni, il bot ignora tutti i messaggi scritti da bot, app o webhook, quindi un’automazione non può avviare una conversazione pubblicando in un canale o @menzionando il bot. Solo i messaggi delle persone raggiungono l’AI Agent.

Il bot non può nemmeno pubblicare a orari programmati, quindi un post programmato deve provenire dallo strumento di automazione stesso. Per includere una risposta dell’AI Agent, lo strumento può richiederla tramite la Chat API, che richiede il piano Business.

Discord può impiegare fino a un’ora per distribuire i comandi a tutti i client dopo l’ingresso del bot. Riavviare il client Discord di solito li rende visibili prima. Nel frattempo, usa le @menzioni.

Se colleghi la tua app Discord mentre il bot condiviso Quickchat AI è ancora nello stesso server, il bot condiviso continua a rispondere e il tuo resta silenzioso. Entrambi possono stare nel server, ma risponde solo uno dei due e il bot condiviso ha la precedenza.

App esterne → Discord segnala questa situazione in entrambe le configurazioni. Per affidare un server al tuo bot, rimuovilo da Server collegati nella configurazione con un clic. Il tuo bot subentra subito, senza dover cambiare token o intent.

È possibile usarli entrambi intenzionalmente: lascia il bot condiviso nei server in cui vuoi che risponda e affida gli altri al tuo bot.

Quando una risposta che invii dall’Inbox non raggiunge Discord, accanto compare un’icona di avviso rossa. Passa il cursore sull’icona o fai clic su di essa per vedere il motivo e cosa fare.

Una risposta Discord non consegnata nell'Inbox, con la spiegazione aperta

Le spiegazioni più frequenti sono:

  • “Discord ha rifiutato questa risposta (403)”: Discord non ha permesso al bot di pubblicare in quella conversazione. Controlla che il bot sia ancora nel server e che il suo ruolo e le impostazioni specifiche dei permessi del canale consentano View Channel e Send Messages (Send Messages in Threads in un thread), poi invia di nuovo la risposta.
  • “Discord sta temporaneamente limitando i messaggi”: Discord sta limitando la frequenza dei messaggi del bot, quindi la risposta non è stata pubblicata. Aspetta un momento e controlla la conversazione in Discord prima di inviare di nuovo. Una risposta lunga viene pubblicata in più parti e alcune potrebbero essere già arrivate, quindi invia di nuovo solo il testo mancante.
  • “Quickchat non può verificare la destinazione di questa risposta su Discord”: Quickchat risponde solo in un canale, thread o messaggio diretto di Discord che ha verificato tramite i messaggi della persona al bot, e le conversazioni meno recenti potrebbero non averlo. Chiedi alla persona di scrivere di nuovo al bot nella stessa conversazione Discord, poi rispondi nella conversazione dell’Inbox che riceve il suo messaggio.

Le sezioni seguenti riguardano la procedura La tua app Discord.

PrivilegedIntentsRequired: il bot si è collegato, ma Message Content Intent è disattivato, quindi non può leggere i messaggi. Nel Developer Portal, apri l’applicazione, vai a Bot → Privileged Gateway Intents, attiva Message Content Intent e salva. Il bot si riavvia automaticamente; attendi circa un minuto.

Attivare Message Content Intent

InvalidToken: il token presente in Quickchat AI è errato o è stato rigenerato. Un token del bot viene mostrato una volta sola e reimpostarlo invalida quello precedente. Nel Developer Portal, apri l’applicazione, vai a Bot, fai clic su Reset Token, copia il nuovo token, poi fai clic su Ricollega in Quickchat AI e incollalo.

Reimpostare il token del bot

Se vedi “Integration requires code grant” mentre aggiungi il bot, nell’applicazione è attivo Require OAuth2 Code Grant, che blocca la semplice procedura di invito del bot. Nel Developer Portal, apri l’applicazione, vai a Bot, disattiva Require OAuth2 Code Grant, salva e apri di nuovo l’URL di invito.

La pagina di autorizzazione mostra una torta o un messaggio con “baked”

Sezione intitolata “La pagina di autorizzazione mostra una torta o un messaggio con “baked””

Quella schermata insolita è la pagina di conferma di Discord: il bot è stato aggiunto. Per verificare, apri Server Settings → Integrations → Bots and Apps del server e cerca il bot nell’elenco.

Il bot si riavvia ogni volta che cambi il token o le impostazioni, quindi attendi fino a un minuto dopo il salvataggio. Se ancora non risulta online o non risponde:

  1. Nella dashboard Quickchat AI, apri App esterne → Discord e controlla lo stato della connessione. Eventuali token non validi o intent mancanti vengono segnalati lì, con un link alla soluzione specifica.
  2. Verifica che Message Content Intent sia attivo (vedi sopra) e che il token sia aggiornato (usa Reset Token in caso di dubbio).
  3. @Menziona il bot in un canale a cui ha accesso e verifica che i permessi del ruolo e del canale includano Send Messages, Create Public Threads, Send Messages in Threads e Read Message History.
  4. Scegli se deve rispondere nel canale o in un thread con Modalità di risposta sotto App esterne → Discord.

La pagina dell’integrazione Discord nella dashboard Quickchat AI mostra Server collegati per il bot con un clic, il selettore Modalità di risposta (Rispondi nel canale o Rispondi nei thread) in Impostazioni per entrambe le configurazioni e, sotto Configurazione avanzata, il campo Bot Token della tua app e un link alla nostra community Discord per ricevere aiuto.


Unisciti al nostro server Discord per scoprire come sfruttare al meglio Quickchat AI 👉 discord.gg/KqkHwvPRNH

Ultimo aggiornamento: