Intent privilegiati Discord: presenza, membri e contenuto dei messaggi
Gli intent privilegiati sono i tre intent del gateway che espongono dati sensibili: aggiornamenti di presenza, l'elenco dei membri del server e il contenuto dei messaggi. Un bot deve attivarne ciascuno nel Portale per sviluppatori e, quando supera i 100 server, deve anche essere verificato e approvato da Discord per continuare a usarli.
I tre intent
- Presenza: se i membri sono online, inattivi o offline, più la loro attività.
- Membri del server: eventi di ingresso e uscita dei membri e l'elenco completo dei membri. Servono per messaggi di benvenuto, verifica e ruoli automatici.
- Contenuto dei messaggi: il testo effettivo, gli embed e gli allegati dei messaggi. Serve per leggere i comandi con prefisso e per qualsiasi cosa che analizzi il testo.
Senza il contenuto dei messaggi, un bot riceve ancora i messaggi che lo menzionano, i messaggi diretti, i propri messaggi e le interazioni come i comandi slash. Per questo i bot moderni si affidano ai comandi slash.
Come funziona l'approvazione
Per un bot in meno di 100 server, basta spuntare l'interruttore nella pagina del bot nel Portale per sviluppatori. Quando un bot raggiunge 100 server, Discord richiede la verifica del bot, e gli intent privilegiati vanno poi approvati con una motivazione dichiarata. Senza approvazione, il bot li perde. Discord decide caso per caso, quindi aiuta una spiegazione chiara della funzione che richiede quei dati.
Se un bot si connette chiedendo un intent privilegiato che non ha attivato, Discord chiude la connessione con l'errore 4014. È una causa frequente per cui un bot va offline subito dopo la configurazione. Vedi la spiegazione del 4014.
Perché interessa ai proprietari dei server
Questi intent sono la parte di un bot che tocca i dati dei tuoi membri. Il contenuto dei messaggi è quello da valutare con attenzione: un bot che legge i messaggi può filtrare spam e link, ma vede anche tutto ciò che viene detto dove ha accesso. Puoi limitarlo negando al bot il permesso Visualizza canale nelle aree private.
Influisce anche sull'affidabilità. Un bot che perde un intent approvato può smettere in silenzio di dare il benvenuto ai membri o far rispettare le regole.
Noxyr e gli intent privilegiati
Per un bot personalizzato di Noxyr che usa una tua applicazione, la configurazione richiede di attivare Intent Membri del server e Intent Contenuto dei messaggi nel Portale per sviluppatori Discord. Le funzioni di Noxyr che li usano includono i messaggi di benvenuto, la verifica e l'anti-spam. Leggi la guida completa agli intent privilegiati del gateway, e l'idea più ampia negli intent del gateway.
Controlla prima di installare un bot
Chiedi quali intent privilegiati usa un bot e per cosa. Un bot musicale raramente ha bisogno dei dati di presenza, e un bot per sondaggi raramente ha bisogno di leggere tutti i messaggi. Se la risposta è vaga, scegli un altro bot.
Domande frequenti
Quali intent sono privilegiati?
Presenza, membri del server e contenuto dei messaggi.
Perché il mio bot si disconnette con l'errore 4014?
Ha richiesto un intent privilegiato non attivo nel Portale per sviluppatori. Attivalo e riavvia il bot.
Quali intent servono a un bot personalizzato di Noxyr?
Intent Membri del server e Intent Contenuto dei messaggi devono essere attivi per la tua applicazione.