Una nota per gli sviluppatori di app
Gli sviluppatori di app rappresentano una parte enorme del funzionamento di Discord. Crei bot, integrazioni di giochi, flussi di benvenuto e utility da cui i proprietari dei server dipendono ogni giorno. Milioni di persone hanno esperienze migliori su Discord grazie a ciò che hai creato.
Oggi annunciamo modifiche al modo in cui le app di Discord accedono agli intenti privilegiati (Membri della gilda, Presenza e Contenuti dei messaggi): una nuova soglia basata sull'utente per quando l'accesso richiede un'analisi e un processo annuale per richiedere nuovamente l'accesso continuato.
Se la tua app è accessibile a meno di 10.000 Utenti, queste modifiche non hanno alcun impatto su di essa.
Cosa sono gli intenti privilegiati?
Perché stiamo apportando questa modifica ora
L'ecosistema dei bot di Discord è cresciuto enormemente. Oggi sulla piattaforma ci sono più bot che mai, il che significa che un numero maggiore di sviluppatori svolge un lavoro di creatività e utile, ma anche una maggiore area di superficie in cui accedere ai dati degli utenti.
Il passaggio a una soglia di conteggio degli utenti riflette il modo in cui le app ora scalano su Discord man mano che il nostro ecosistema si è evoluto. Se la tua app ha meno di 10.000 utenti, queste modifiche non si applicano a te, mentre le app con una portata maggiore devono inviare una richiesta di analisi del proprio accesso.
Il processo di analisi annuale nasce da un intento simile. I bot si evolvono nel tempo. Un bot con accesso di un anno fa può avere uno scopo molto diverso oggi. I controlli periodici aiutano a ridurre l'accesso non intenzionale, non necessario o non accettabile ai sensi delle nostre politiche, il che è migliore per gli utenti e, in definitiva, migliore per la fiducia degli sviluppatori in tutto l'ecosistema.
Che cosa cambia?
1. La soglia di analisi è ora basata sul conteggio degli utenti e non sul conteggio dei server.
In precedenza, le app in meno di 100 server potevano accedere agli intenti privilegiati attivandoli nel portale degli sviluppatori e le app in oltre 100 server dovevano richiedere l'accesso.
A partire da oggi, la soglia si basa sul numero di utenti a cui la tua app può accedere su tutti i server a cui appartiene. Se la tua app ha meno di 10.000 utenti, puoi continuare ad accedere agli intenti privilegiati attivandoli nel Portale degli sviluppatori. Una volta che la tua app raggiunge i 10.000 utenti, dovrai richiedere l'accesso agli Intenti Privilegiati.
Come effettuiamo il conteggio degli utenti per la tua app: contiamo il numero di utenti unici che hanno accesso alla tua app su tutti i server in cui è installato. Quando la tua app raggiunge la soglia di 10.000 utenti, il proprietario dell'app oppure del team riceverà una notifica tramite e-mail e/o MD di sistema. Vedrai anche un messaggio nel Portale degli sviluppatori che ti informa che è il momento di inviare la richiesta. Avrai 90 giorni di tempo dalla data della notifica per inviare la tua richiesta. Se non richiedi entro questa finestra, l'accesso della tua app agli intenti privilegiati verrà rimosso. Puoi comunque effettuare la richiesta in qualsiasi momento per richiedere nuovamente l'accesso.
2. Le app devono ora candidarsi di nuovo ogni anno per continuare ad avere l'accesso.
Le app con accesso con intento privilegiato concesso in seguito a una precedente analisi dovranno candidarsi di nuovo per confermare la continuità dell'accesso una volta all'anno nel Portale degli sviluppatori.
Calendario dell'analisi annuale: se hai già effettuato l'accesso agli intenti privilegiati concessi da una precedente analisi, dovresti aspettarti di ricevere una notifica per candidarti di nuovo tra ora e la fine di quest'anno. Dopo aver ricevuto questa notifica, avrai 90 giorni di tempo per candidarti di nuovo per l'accesso continuato ai tuoi intenti. Se mantieni l'accesso, riceverai una notifica prima del prossimo ciclo di analisi annuale.
In entrambi gli scenari di cui sopra, il modulo di invio ti chiede di fornire e confermare le informazioni sulle funzionalità attuali della tua app, sul caso d'uso per ogni intento privilegiato richiesto e sulle pratiche in materia di dati, che verranno utilizzate per l'analisi dell'accesso della tua app. Se invii la tua richiesta durante la finestra di 90 giorni, la tua app manterrà il suo attuale accesso agli intenti mentre il tuo invio è in fase di analisi.
Nota: se la tua app non richiede l'accesso agli intenti privilegiati, non è necessario intraprendere alcuna azione.
3. Le App possono continuare a crescere durante l'analisi dell'intento privilegiato.
In precedenza, quando un'app raggiungeva 100 server e doveva richiedere l'accesso continuativo ai suoi intenti privilegiati, le veniva bloccata l'unione a nuovi server fino al completamento dell'analisi.
Non è più il caso. In base alla nuova soglia basata sugli utenti, le app possono continuare a unirsi ai server e raggiungere nuovi utenti mentre il loro invio è in fase di analisi.
Cosa significa per te
Se la tua app ha meno di 10.000 utenti:
Queste modifiche non si applicano alla tua app. Puoi continuare ad attivare gli intenti privilegiati nel Portale degli sviluppatori. Se in seguito la tua app cresce oltre i 10.000 utenti, riceverai una notifica per fare domanda.
Se la tua app include attualmente l'Accesso agli intenti privilegiati concessi da una precedente analisi:
Il tuo accesso rimane attivo. Dovrai candidarti di nuovo ogni anno per continuare ad avere l'accesso. Non è necessaria alcuna azione finché non ricevi una notifica tramite e-mail e/o messaggi diretti di sistema quando la data della tua nuova candidatura si avvicina.
Se la tua app accede agli intenti privilegiati tramite l'interruttore self-service nel portale degli sviluppatori ed è accessibile a oltre 10.000 utenti:
In base alla nuova soglia, la tua app ora richiede un'analisi per continuare ad avere accesso agli intenti privilegiati. Riceverai una notifica tramite e-mail e/o MD di sistema. Ci sarà anche un avviso quando si visualizza la richiesta nel Portale degli sviluppatori. Le nuove installazioni di gilda non vengono bloccate mentre la tua app si trova in questo stato. Avrai 90 giorni di tempo dalla data della notifica per inviare la tua richiesta. Se non ti candidi entro questa finestra, l'accesso della tua app agli intenti privilegiati verrà rimosso; tuttavia, puoi comunque presentare domanda in qualsiasi momento per richiedere nuovamente l'accesso.
Ciò cambia i dati forniti dalle intenzioni privilegiate?
No. I dati disponibili tramite ciascun intento rimangono gli stessi. Queste modifiche aggiornano la soglia in cui l'accesso con intento privilegiato richiede un'analisi e aggiungono un processo di rinnovo della domanda annuale.
Hai davvero bisogno degli intenti privilegiati?
Prima di presentare domanda, verifica se la funzionalità attuale della tua app richiede intenti privilegiati oppure se le funzionalità API più recenti coprono il tuo caso di utilizzo. Abbiamo redatto una guida per aiutarti a valutare ogni intento e le relative alternative.
Ad esempio, le app che in precedenza si basavano sui comandi dei prefissi per leggere il contenuto dei messaggi possono ora utilizzare i comandi delle applicazioni, eliminando completamente la necessità dell'intento del contenuto del messaggio.
Se hai confermato che la tua app ha bisogno di intenti privilegiati e il caso d'uso è conforme alle nostre linee guida, il processo di domanda è facile da completare nel Portale degli sviluppatori.
- Guida: iniziare l'analisi degli intenti privilegiati
- Guida: potresti non avere bisogno di un intento privilegiato
Guardando avanti
Mentre il nostro ecosistema di app continua a crescere, cerchiamo sempre nuovi modi per aiutare gli sviluppatori, gli utenti e la piattaforma stessa a crescere in modo responsabile. Quando le persone si sentono più sicure delle app nel proprio server, sono più disposte a installarne di nuove, interagire con esse e rimanere attive. Ne traggono vantaggio tutti coloro che si affidano a Discord.
Continuiamo a investire negli strumenti, nelle infrastrutture e nell'aAssistenza che rendono Discord il luogo migliore in cui creare e gestire le app. Se riscontri problemi durante questa transizione, contattaci.
Il nostro team di Assistenza per gli sviluppatori è disponibile nel nostro centro di Assistenza per gli sviluppatori e il Server degli sviluppatori di Discord è un luogo ideale per porre domande e condividere ciò che stai imparando.
Domande comuni
Dove posso vedere il conteggio degli utenti della mia app?
Non mostriamo il conteggio degli utenti della tua app nel portale sviluppatori. Quando la tua app supera la soglia dei 10.000 utenti e attiva l'analisi dell'accesso con intenti privilegiati, vedrai un avviso nel Portale degli sviluppatori e riceverai una notifica tramite e-mail e/o MD di sistema.
Cosa succede se raggiungo la soglia? La mia app smette di funzionare?
No. La tua app continua a funzionare e a ricevere eventi dagli intenti privilegiati. Anche le installazioni delle gilde non vengono bloccate mentre sei in fase di analisi. Gli utenti possono comunque unirsi ai server in cui la tua app è già installata e le installazioni degli utenti rimangono inalterate. Hai 90 giorni di tempo dalla notifica per inviare la tua richiesta prima che i tuoi Intenti Privilegiati vengano rimossi.
Cosa succede se la mia richiesta viene negata?
Riceverai una notifica. In alcuni casi, ti verrà concesso più tempo per risolvere determinati problemi relativi alla tua richiesta e per inviarla nuovamente o apportare le modifiche necessarie senza perdere l'accesso durante tale periodo. In altri casi (ad esempio, se il caso di utilizzo non è conforme alle nostre politiche), il tuo accesso verrà rimosso, ma potrai comunque inviare una richiesta di nuovo accesso in qualsiasi momento.
Ciò cambia i dati forniti dalle intenzioni privilegiate?
No. I dati disponibili tramite ciascun intento rimangono gli stessi. Queste modifiche si applicano nei casi in cui l'accesso tramite Intento privilegiato richieda un'analisi.
Per ulteriori domande, contatta il team di assistenza per gli sviluppatori di Discord.