Если канал после создания ботом видят посторонние, откройте полученный channel object и сравните permission_overwrites с тем, что бот отправил в Create Guild Channel. Для приватного текстового канала обычно нужен явный deny VIEW_CHANNEL роли @everyone и allow только тем ролям или участникам, которым доступ действительно положен.

Не пытайтесь исправить результат перестановкой ролей наугад. Discord сначала считает guild-level permissions, затем применяет channel overwrites; ADMINISTRATOR обходит эти ограничения. Поэтому проверка должна включать обычного участника без Administrator и учитывать все его роли, а не только роль, которую создаёт бот.

Allow, deny и отсутствие значения — разные состояния

Состояние битаЧто означаетТипичная ошибка бота
allowразрешить на уровне каналабот разрешает лишние права вместе с VIEW_CHANNEL
denyзапретить на уровне каналазапрет для @everyone отсутствует или назначен не тому ID
unsetне переопределять guild permissionразработчик считает unset равным deny
ADMINISTRATOR у ролиобход channel overwritesтестовый админ видит канал и создаёт ложную тревогу
member overwriteпоследний точечный слойстарое исключение участника остаётся после смены роли

Поля allow и deny — bit sets, сериализованные строками. Не храните их как обычный JavaScript Number: документация Discord рекомендует Big Integer для долгосрочной устойчивости. Имя роли тоже не является идентификатором; @everyone имеет ID, равный guild ID.

Payload описывает минимальную модель доступа

Соберите payload из констант разрешений библиотеки, а не из скопированного большого числа. Для закрытого канала не выдавайте MANAGE_CHANNELS или MANAGE_ROLES только потому, что бот сам ими обладает. Роль бота нужна для выполнения API-запроса, но она не должна автоматически попадать в список зрителей.

{
  "name": "ticket-1042",
  "type": 0,
  "parent_id": "CATEGORY_ID",
  "permission_overwrites": [
    {"id": "GUILD_ID", "type": 0, "allow": "0", "deny": "1024"},
    {"id": "SUPPORT_ROLE_ID", "type": 0, "allow": "3072", "deny": "0"},
    {"id": "REQUESTER_USER_ID", "type": 1, "allow": "3072", "deny": "0"}
  ]
}

Числа в примере иллюстрируют VIEW_CHANNEL и SEND_MESSAGES по текущей таблице Discord, но в рабочем коде их следует получить из именованных flags SDK и сериализовать строками. После создания выполните GET канала и сравните фактические overwrites: это обнаружит преобразование типов, пропущенный элемент массива и последующее изменение другой задачей.

Итог вычисляется по всем ролям участника

Официальный порядок Discord начинается с @everyone на уровне guild, добавляет разрешения ролей и отдельно обрабатывает ADMINISTRATOR. На уровне канала применяются deny/allow @everyone, затем объединённые deny/allow всех ролей и в конце member-specific overwrite. Конфликт двух role overwrites нельзя проверять по одной роли отдельно.

  • Deny VIEW_CHANNEL для @everyone скрывает канал от обычных участников.
  • Allow VIEW_CHANNEL для одной из ролей может вернуть доступ участнику с несколькими ролями.
  • Member-specific deny или allow применяется после role overwrites.
  • Без VIEW_CHANNEL остальные права канала фактически не дают пользоваться каналом.
  • Права категории синхронизируются только пока child channel остаётся synced.

Категория — частый источник неожиданности. Созданный канал с собственным набором overwrites может стать несинхронизированным и не получить дальнейшее изменение категории. Решите заранее: бот копирует политику категории и сохраняет sync или создаёт изолированную policy, которую обновляет сам.

Тестовая матрица лучше проверки под владельцем

Создайте тестовые аккаунты или разрешённые impersonation-проверки для ролей: обычный участник, заявитель, сотрудник поддержки, модератор без Administrator. Для каждой роли проверяйте отдельно видимость, чтение истории, отправку сообщения, вложение и создание треда. Владелец сервера и администратор не подходят как отрицательный тест.

  1. Создать канал с уникальным correlation ID и сохранить request/response без bot token.
  2. Получить канал повторно и сравнить нормализованный список overwrites.
  3. Рассчитать expected effective permissions для каждого тестового участника.
  4. Проверить доступ через клиент или разрешённый API-сценарий.
  5. Изменить роль участника и подтвердить, что старый member overwrite не оставил доступ.

Откат удаляет доступ, не скрывая причину

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

Результат готов, когда эталонная матрица совпадает с effective permissions и повторный запуск идемпотентен. Для диагностики подготовьте guild ID, channel ID, role IDs, обезличенный payload и список ожидаемых действий по ролям. Bot token, invite с административными правами и персональные сообщения к задаче не прикладывают.

Проверенные источники