En anteckning till app-utvecklare
App-utvecklare är en stor del av det som får Discord att fungera. Du bygger bottar, spelintegrationer, välkomstflöden och hjälpmedel som serverägare är beroende av varje dag. Miljontals människor har bättre upplevelser på Discord på grund av det du har byggt.
I dag meddelar vi ändringar i hur Discord-appar får åtkomst till Privileged Intents (Guildmedlemmar, Närvaro och Meddelandeinnehåll): en nya användarbaserad tröskel för när åtkomst kräver granskning och en årlig process för att ansöka på nytt för fortsatt åtkomst.
Om din app är tillgänglig för färre än 10 000 användare påverkar dessa ändringar inte din app.
Vad är Privilegierade Intents?
Varför vi gör denna förändring nu
Discords bot-ekosystem har vuxit enormt. Det finns fler bottar på plattformen i dag än någonsin tidigare, vilket innebär att fler utvecklare gör kreativt, användbart arbete, men också mer yta för att komma åt användardata.
Att ändra till en användarantal-tröskel återspeglar hur appar nu skalar över Discord i takt med att vårt ekosystem har utvecklats. Om din app är under 10 000 användare gäller inte dessa ändringar för dig, medan appar med större räckvidd är skyldiga att skicka in en ansökan om granskning av deras åtkomst.
Den årliga granskningsprocessen kommer från ett liknande ställe. Bottar utvecklas över tiden. En bot med åtkomst från för ett år sedan kan tjäna ett helt annat syfte idag. Periodiska incheckningar hjälper till att minska åtkomst som inte är avsedd, nödvändig eller acceptabel enligt våra policyer, vilket är bättre för användare och i slutändan bättre för utvecklarförtroende i hela ekosystemet.
Vad förändras?
1. Granskningströskeln är nu baserad på antal användare, inte antal servrar.
Tidigare kunde appar i färre än 100 servrar komma åt Privileged Intents genom att aktivera dem i Utvecklarportalen, och appar i 100+ servrar var tvungna att ansöka om åtkomst.
Från och med i dag är tröskeln baserad på antalet användare din app kan komma åt i alla servrar den tillhör. Om din app har färre än 10 000 användare kan du fortsätta att komma åt Privileged Intents genom att aktivera dem i Utvecklarportalen. När din app når 10 000 användare måste du ansöka om åtkomst till Privileged Intent.
Hur vi räknar användare för din app: Vi räknar antalet unika användare som har åtkomst till din app i alla servrar den är installerad i. När din app når tröskeln på 10 000 användare kommer appen eller teamägaren att få en avisering via e-post och/eller via system-DM. Du kommer också att se ett meddelande i Utvecklarportalen som låter dig veta att det är dags att ansöka. Du kommer att ha 90 dagar på dig från datumet för meddelandet att skicka in din Applikation. Om du inte ansöker inom detta fönster kommer din apps åtkomst till privilegierade avsikter att tas bort. Du kan fortfarande ansöka när som helst för att begära åtkomst igen.
2. Appar måste nu ansöka årligen för fortsatt åtkomst.
Appar med åtkomst till Privileged Intent som beviljats från en tidigare granskning kommer att behöva ansöka på nytt för att bekräfta sin fortsatta åtkomst en gång per år i Utvecklarportalen.
Tidslinje för årlig granskning: Om du redan har åtkomst till Privileged Intents som beviljats från en tidigare granskning bör du räkna med att få en avisering om att ansöka på nytt någon gång mellan nu och slutet av detta år. Efter att du har fått det meddelandet kommer du att ha 90 dagar på dig att ansöka på nytt för fortsatt åtkomst till dina intents. Om du behåller åtkomst kommer du att få ett meddelande före din nästa årliga granskningscykel.
I båda scenarierna ovan ber inlämningsformuläret dig att tillhandahålla och bekräfta Information Om din apps nuvarande funktionalitet, användningsfall för varje begärd Privileged Intent och datapraxis, som kommer att användas för den granskning som görs av din apps åtkomst. Om du skickar in din ansökan under 90-dagarsperioden kommer din app att behålla sin nuvarande åtkomst till intents medan din ansökan är under granskning.
Notera: Om din app inte behöver åtkomst till Privileged Intents behöver du inte vidta någon Funktion.
3. Appar kan fortsätta att växa under granskning av Privileged Intent.
Tidigare, när en app nådde 100 Servrar och var tvungen att ansöka om fortsatt åtkomst till sina Privileged Intents, blockerades den från att ansluta till nya servrar tills granskning var klar.
Det är inte längre fallet. Under den nya användarbaserade tröskeln kan appar fortsätta att ansluta till Servrar och nå nya Användare medan deras inlämning är under granskning.
Vad detta innebär för dig
Om din app är under 10 000 Användare:
Dessa ändringar gller inte för din app. Du kan fortsätta att aktivera Privilegierade Avsikter i Utvecklarportalen. Om din app senare växer över 10 000 Användare kommer du att meddelas om att du kan ansöka.
Om din app för närvarande har åtkomst till privilegierade avsikter som beviljats från en tidigare granskning:
Din åtkomst förblir aktiv. Du kommer att behöva ansöka på nytt årligen för fortsatt åtkomst. Inget agerande krävs förrän du får ett meddelande via E-post Eller direktmeddelanden från systemetnär ditt återansöksdatum närmar sig.
Om din app får åtkomst till Privilegierade Intents via självbetjäningsväxeln i Utvecklarportalen och är tillgänglig för 10 000+ användare:
Under det nya tröskelvärdet kräver din app nu granskning för fortsatt åtkomst till Privilegierade Intents. Du kommer att få ett meddelande via e-post och/eller system-DM. Det kommer också att finnas en varning när du visar din applikation i Utvecklarportalen. nya guild-installationer är inte blockerade medan din app är i denna status. Du har 90 dagar från datumet för meddelandet att skicka in din applikation. Om du inte ansöker inom detta fönster kommer din app:s åtkomst till Privileged Intents att tas bort; Du kan dock fortfarande ansöka vid vilken tidpunkt som helst för att begära ansökan om åtkomst igen.
Ändrar detta vilka data Privilegerade Intents ger?
Nej. De data som är tillgängliga via varje intent är desamma. Dessa ändringar uppdaterar tröskeln för när åtkomst till Privilegierad Intent kräver granskning och lägger till en årlig omansökningsprocess.
Behöver du faktiskt Privilegierade Intents?
Innan du ansöker, vänligen granska om din apps nuvarande funktionalitet kräver Privileged Intents, eller om nyare API-funktioner täcker ditt användningsfall. Vi har satt ihop en guide för att hjälpa dig att utvärdera varje Intent och dess alternativ.
Till Exempel kan appar som tidigare förlitade sig på prefix-kommandon för att läsa meddelandeinnehåll nu använda applikationskommandon istället, vilket tar bort behovet av avsikten för meddelandeinnehåll helt.
Om du har bekräftat att din app behöver privilegierade avsikter och att användningsfallet uppfyller våra riktlinjer är processen för applikationen enkel att slutföra i Utvecklare-portalen.
- Guide: Komma igång med granskning av Privileged Intent
- Guide: Du kanske inte behöver en Privileged Intent
Att se framåt
I takt med att vårt app-ekosystem fortsätter att växa letar vi alltid efter fler sätt att hjälpa användare och plattformen att växa med det på ett ansvarsfullt sätt. När människor känner sig mer självsäkra med apparna på sin server är de mer villiga att installera nya, engagera sig i dem och stanna kvar. Det gynnar alla som bygger på Discord.
Vi fortsätter att investera i verktyg, infrastruktur och support som gör Discord till det bästa stället att bygga och köra appar. Om du stöter på problem under denna övergång, kontakta oss.
Vårt utvecklarsupportteam är tillgängligt i vårt utvecklarsupportcenter, och Discords utvecklarserver är ett bra ställe att ställa frågor och dela med dig av det du lär dig.
Vanliga frågor
Var kan jag se min apps användarantal?
Vi visar inte din apps användarantal i Utvecklarportalen. När din app växer bortom tröskeln på 10 000 användare och utlöser åtkomstgranskningen för Privileged Intents kommer du att se en varning i Utvecklarportalen och få ett meddelande via E-post Eller system-DM.
Vad händer om jag når tröskelvärdet? Slutar min app att fungera?
Nej. Din app fortsätter att fungera och ta emot Event från Privileged Intents. Guild-installationer är inte heller blockerade medan du är under granskning. Användare kan fortfarande gå med i servrar där din app redan är installerad, och användarinstallationer förblir opåverkade. Du har 90 dagar från meddelandet att skicka in din applikation före dina Privileged Intents tas bort.
Vad händer om min ansökan nekas?
Du kommer att få ett meddelande. I vissa fall kommer du att få ytterligare tid för att åtgärda vissa problem med din inlämning och skicka in den på nytt eller göra nödvändiga ändringar utan att förlora åtkomst under den perioden. I andra fall (t.ex. att användningsfallet inte följer våra policyer) kommer din åtkomst att tas bort, men du kommer fortfarande att kunna skicka in en ansökan om ny åtkomst när som helst.
Ändrar detta vilka data Privilegerade Intents ger?
Nej. De data som är tillgängliga via varje intent är desamma. Dessa ändringar gäller när åtkomst till Privileged Intent kräver att man granskar.
För fler frågor, vänligen kontakta Discords utvecklarsupportteam.