Изменения в доступе к Privileged Intents для приложений Discord

Примечание для разработчиков приложений

Разработчики приложений играют огромную роль в обеспечении работы Discord. Вы создаете ботов, интеграции с играми, сценарии приветствия и утилиты, на которые владельцы серверов полагаются каждый день. У миллионов людей улучшаются возможности использования Discord благодаря тому, что вы создали.

Сегодня мы сообщаем об изменениях в том, как приложения Discord получают доступ к Privileged Intents (участники гильдии, присутствие и содержание сообщений): о новом пороговом значении для пользователей, когда такой доступ требует проверки, и о ежегодном процессе подачи повторной заявки для сохранения доступа.

Если ваш бот доступен менее 10 тысячам пользователей, эти изменения не затронут ваше приложение.

Что такое Privileged Intents (привилегированные намерения)?

Почему мы делаем это изменение сейчас

Экосистема ботов Discord значительно выросла. Сегодня на платформе больше приложений, чем когда-либо до этого, а это означает, что больше разработчиков занимаются творчеством и полезной работой, а также что существует больше возможностей получить доступ к данным пользователей.

Переход к пороговому значению количества пользователей отражает то, как приложения теперь масштабируются в Discord по мере развития нашей экосистемы. Если у вашего бота менее 10 тысяч пользователей, эти изменения на вас не распространяются, в то время как приложения с большим охватом должны отправлять заявку на проверку своего доступа.

Процесс ежегодной проверки основан на тех же принципах. Боты со временем совершенствуются. Бот, у которого есть доступ, полученный год назад, сегодня может служить совершенно другим целям. Периодические проверки помогают ограничить доступ, который не является целесообразным, необходимым или допустимым в соответствии с нашими правилами, что благоприятно сказывается на пользователях и, в конечном итоге, повышает доверие разработчиков во всей экосистеме.

Что изменилось

1. Порог проверки теперь отталкивается от количества пользователей, а не от количества серверов.

Ранее приложения на менее чем 100 серверах могли получить доступ к Privileged Intents, просто включив их на портале разработчиков, а приложениям на более чем 100 серверах требовалось подать заявку на такой доступ.

С сегодняшнего дня порог определяется в зависимости от количества пользователей, к которым имеет доступ ваш бот на всех серверах, к которым он принадлежит. Если ваш бот имеет менее 10 тысяч пользователей, вы можете продолжить получать доступ к Privileged Intents, включив их на портале разработчиков. Как только ваш бот достигнет 10 тысяч пользователей, вам потребуется отправить заявку на доступ к Privileged Intent.

Как мы подсчитываем количество пользователей для вашего приложения: мы подсчитываем число уникальных пользователей, имеющих доступ к вашему боту на всех серверах, на которых он установлен. Когда ваш бот достигнет порога в 10 тысяч пользователей, владелец приложения или команды получит уведомление по электронной почте и/или через личное сообщение в системе. Вы также увидите сообщение на портале разработчиков, уведомляющее вас о том, что пришло время отправить заявку. У вас будет 90 дней с даты уведомления, чтобы отправить заявку. Если вы не сможете отправить заявку в течение этого периода, доступ вашего приложения к Privileged Intents будет удалён. Вы можете в любой момент подать заявку, чтобы повторно запросить доступ.

2. Теперь для сохранения доступа приложения должны ежегодно подавать такую заявку.

Приложения, которым доступ к привилегированным намерениям был предоставлен на основе предыдущей проверки, должны будут раз в год подавать заявку на портале разработчиков повторно, чтобы подтвердить свой доступ.

График ежегодной проверки: если у вас уже есть доступ к Privileged Intents, предоставленный по результатам предыдущей проверки, в период с настоящего момента до конца года вам следует ожидать получения уведомления о необходимости подать повторную заявку. После того как вы получите это уведомление, у вас будет 90 дней на повторную подачу заявки на доступ к намерениям. Если у вас останется доступ, вы получите уведомление до начала следующего ежегодного цикла проверки.

В обоих вышеуказанных сценариях в форме подачи заявки вам предлагается указать и подтвердить информацию о текущих функциональных возможностях вашего приложения, о случаях использования для каждого запрашиваемого привилегированного намерения и о методах обработки данных, что будет использоваться при рассмотрении заявки на доступ для вашего приложения. Если вы отправите заявку в течение 90-дневного периода, ваш бот сохранит текущий доступ к намерениям на время рассмотрения вашего обращения.

Примечание: если ваш бот не нуждается в доступе к Privileged Intents, вам не нужно предпринимать никаких действий.

3. Приложения могут продолжать развиваться во время проверки для предоставления доступа к намерениям.

Раньше, когда бот достигал отметки в 100 серверов и должен был отправить заявку на сохранение доступа к Privileged Intents, ему блокировали возможность присоединяться к новым серверам до завершения проверки.

Теперь всё изменилось. В соответствии с новым пороговым значением для количества пользователей приложения могут продолжать присоединение к серверам и охватывать новых пользователей, пока их заявка находится в стадии рассмотрения.

Что это значит для вас

Если у вашего приложения менее 10 тысяч пользователей:

Эти изменения не касаются вашего бота. Вы можете как и ранее включать Privileged Intents на портале разработчиков. Если в дальнейшем число пользователей вашего бота превысит 10 тысяч, вы получите уведомление об отправке заявки.

Если ваш бот в настоящее время имеет доступ к Privileged Intents, полученным после предыдущей проверки:

Ваш доступ остается активным. Для сохранения доступа вам потребуется каждый год повторно подавать заявку. Никаких действий до получения уведомления по электронной почте и/или личных сообщений в системе о приближении даты повторной подачи заявки не требуется.

Если ваш бот получает доступ к Privileged Intents при помощи переключателя самостоятельного обслуживания на портале разработчиков и доступен более 10 тысячам пользователей:

В соответствии с новым пороговым значением вашему приложению теперь требуется проходить проверку для сохранения доступа к Privileged Intents. Вы получите уведомление по электронной почте и/или ЛС в системе. При просмотре вашего приложения на портале разработчиков также будет отображаться предупреждение. Пока ваш бот находится в таком состоянии, установки новых гильдий не блокируются. У вас есть 90 дней с даты уведомления, чтобы отправить заявку. Если вы не подадите заявку в течение этого времени, доступ вашего приложения к Privileged Intents будет удалён; однако вы всё равно можете отправить заявку в любой момент, чтобы снова запросить доступ.

Изменится ли в связи с этим характер данных, которые предоставляет функция Privileged Intents?

Нет. Данные, доступные для каждого намерения, остаются теми же самыми. Эти изменения обновляют порог, когда для получения доступа к Privileged Intents необходима проверка, и добавляют процедуру повторной подачи заявки на ежегодной основе.

Нужны ли вам Privileged Intents?

Перед подачей заявки просмотрите, требует ли текущая функциональность вашего приложения Privileged Intents или же ваши задачи можно решить с помощью новых функций API. Мы составили руководство, которое поможет вам оценить каждое намерение и его альтернативы.

Например, приложения, которые ранее использовали команды с префиксами для чтения содержимого сообщения, теперь могут использовать команды приложения, что полностью устраняет необходимость в намерении «Содержимое сообщения».

Если вы убедились, что вашему боту действительно нужны привилегированные намерения, а сценарий использования соответствует нашим правилам, процесс подачи заявки можно легко осуществить на портале разработчиков.

Заглядывая в будущее

По мере того как экосистема наших ботов продолжает расти, мы постоянно ищем новые способы помочь пользователям, разработчикам и самой платформе развиваться вместе с ней ответственным образом. Когда люди чувствуют себя более уверенно в своих приложениях на своем сервере, они с большей готовностью устанавливают новые, взаимодействуют с ними и продолжают ими пользоваться. От этого выигрывают все, кто создает продукты на Discord.

Мы продолжаем инвестировать в инструменты, инфраструктуру и поддержку, которые делают Discord лучшим местом, где можно создавать и запускать приложения. Если у вас возникнут проблемы в течение этого переходного периода, свяжитесь с нами.

Наша служба поддержки разработчиков доступна в центре поддержки разработчиков, а сервер Discord Developers — это отличное место, где можно задавать вопросы и делиться своими знаниями.

Общие вопросы

Где можно посмотреть число пользователей моего приложения?

Мы не отображаем число пользователей вашего приложения на портале для разработчиков. Когда ваш бот превысит порог в 10 тысяч пользователей и это инициирует проверку доступа к привилегированным намерениям (Privileged Intents), вы увидите предупреждение на портале разработчиков и получите уведомление по электронной почте и/или ЛС в системе.

Что произойдет, если я достигну порога? Мой бот перестанет работать?

Нет. Ваш бот продолжит функционировать и получать события от Privileged Intents. Установки гильдий также не блокируются на время рассмотрения заявки. Пользователи могут присоединяться к серверам, на которых уже установлен ваш бот, и установки пользователя останутся неизменными. У вас есть 90 днейс момента получения уведомления, чтобы подать заявку, после чего ваши Privileged Intents будут удалены.

Что произойдет, если моя заявка будет отклонена?

Вы получите уведомление. В некоторых случаях вам будет предоставлено дополнительное время для устранения определенных проблем с вашей заявкой и повторной подачи или для внесения необходимых изменений, не теряя при этом доступ в течение этого периода. В других случаях (например, использование не соответствует нашей политике) ваш доступ будет удалён, но вы всё равно сможете отправить заявку на получение нового доступа в любое время.