Если канал после создания ботом видят посторонние, откройте полученный 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. Для каждой роли проверяйте отдельно видимость, чтение истории, отправку сообщения, вложение и создание треда. Владелец сервера и администратор не подходят как отрицательный тест.
- Создать канал с уникальным correlation ID и сохранить request/response без bot token.
- Получить канал повторно и сравнить нормализованный список overwrites.
- Рассчитать expected effective permissions для каждого тестового участника.
- Проверить доступ через клиент или разрешённый API-сценарий.
- Изменить роль участника и подтвердить, что старый member overwrite не оставил доступ.
Откат удаляет доступ, не скрывая причину
Если бот уже создал каналы с лишним доступом, сначала остановите автоматическое создание, выгрузите channel IDs и текущие overwrites, затем исправляйте небольшими пакетами. Не удаляйте каналы и историю ради прав: обновление overwrites обратимо, а массовое удаление лишит команду доказательств и контента.
Результат готов, когда эталонная матрица совпадает с effective permissions и повторный запуск идемпотентен. Для диагностики подготовьте guild ID, channel ID, role IDs, обезличенный payload и список ожидаемых действий по ролям. Bot token, invite с административными правами и персональные сообщения к задаче не прикладывают.