⚠️ Обов’язково прочитайте перед використанням
Автоматизація операцій з особистим акаунтом (self-bot) за допомогою програм порушує Умови надання послуг Discord, і існує ризик блокування акаунта. Це є невід’ємною передумовою цього сервісу: ви надаєте облікові дані власного акаунта та самостійно берете на себе ризики. Наполегливо рекомендується використовувати спеціально створений додатковий акаунт, а не ваш основний акаунт.Розгортання сервісу
Перейдіть до Консоль → Застосунки, знайдіть Discord Agent Proxy та створіть застосунок. Після створення спочатку активуйте підписку, а потім перейдіть на сторінку конфігурації, введіть облікові дані вашого Discord-акаунта та виконайте розгортання. Ресурси інстансу автоматично налаштовуються платформою, вибирати конфігурацію не потрібно. Після надсилання розгортання ви перейдете на сторінку керування застосунком із таким самим макетом «Огляд / Журнали / Документація», як для розгортання Telegram і WeChat. «Огляд» відображає стан інстансу та підписки, а також підтверджує, чи підключено Discord, через запит до акаунта; нормальна робота контейнера не обов’язково означає, що акаунт підключений. Картка Discord-акаунта в «Огляді» надає два пункти інформації для підключення:Перегляд і тестування інтерфейсів у консолі
Відкрийте вкладку «Документація» цього застосунку, щоб переглянути параметри запитів, структури відповідей для всіх 14 REST-операцій, а також приклади для Shell, Python, JavaScript та інших мов. Адреса інстансу й токен доступу буде заповнено автоматично; токен за замовчуванням приховано. ВиберітьGET /api/whoami і натисніть «Тест», щоб підтвердити акаунт, підключений проксі. Операції надсилання, редагування або видалення повідомлень впливають на реальний Discord-акаунт, тому перед тестуванням підтвердьте вміст запиту.
«Завантажити OpenAPI (JSON)» дозволяє експортувати повне визначення інтерфейсу. Файл містить адресу інстансу, але не містить токена доступу. Якщо потрібно змінити облікові дані Discord-акаунта, виберіть «Повторне розгортання» в «Огляді», введіть нові облікові дані та надішліть їх.
Як отримати облікові дані Discord-акаунта
- Увійдіть у Discord у браузері на комп’ютері (discord.com/app)
- Натисніть
F12, щоб відкрити інструменти розробника, і перейдіть на панель Network (Мережа) - Довільно натисніть будь-який канал у Discord і перегляньте список запитів
- Відкрийте будь-який запит, надісланий до
discord.com/api, і знайдіть полеauthorizationу Request Headers (Заголовки запиту) - Скопіюйте його значення
Спосіб автентифікації
Усі інтерфейси, крім/health і /readyz, вимагають передавання токена доступу в заголовку запиту:
Увага: цей сервіс приймає автентифікацію лише через заголовок запиту та не підтримує спосіб додавання токена після URL, як-от?token=xxx. Безпосереднє відкриття адреси інтерфейсу в браузері поверне401 unauthorized, це нормальне явище й не означає збою розгортання. Щоб підтвердити, що процес активний, перейдіть до/health; щоб підтвердити, що Discord-з’єднання здатне обробляти запити, перейдіть до/readyz. Обидві ці перевірки не потребують автентифікації. Якщо токен доступу проксі не налаштовано, захищені інтерфейси повертають503і не відкриваються анонімно.
Перевірка стану сервісу
/health лише означає, що HTTP-процес активний:
/readyz означає, чи доступний Discord Gateway. За нормального з’єднання повертається HTTP 200:
Використання в ШІ-клієнті (MCP)
На прикладі Claude Code:claude_desktop_config.json; якщо наразі потрібен статичний Bearer-заголовок, використовуйте Claude Code або клієнт, який явно підтримує цю можливість.
Після завершення налаштування можна безпосередньо керувати Discord через ШІ природною мовою, наприклад:
Перевір, чи є нові повідомлення в моєму каналі «Обговорення проєкту», і якщо хтось запитував про дату випуску, допоможи мені відповісти, що це буде цієї п’ятниці.
Доступні інструменти
Використання в програмі (REST API)
Усі REST-інтерфейси розміщені під/api, тіло відповіді уніфіковано як {"data": ...}, а у разі помилки — {"error": "..."}.
Перегляд поточного облікового запису
Надсилання повідомлення
Idempotency-Key, процес поверне перший результат без повторного надсилання. Перезапуск екземпляра очистить до 5 000 записів дедуплікації в пам’яті, тому викликачеві все одно потрібно самостійно відстежувати довгостроковий статус доставки.
Необов’язковий параметр reply_to використовується для відповіді на вказане повідомлення:
Читання повідомлень
Повний список інтерфейсів
Як отримати ID каналу та ID користувача
У клієнті Discord послідовно відкрийте Налаштування користувача → Розширені налаштування, увімкніть Режим розробника. Після цього клацніть правою кнопкою миші на будь-якому каналі або користувачі — у меню з’явиться «Копіювати ID». Також можна безпосередньо викликатиGET /api/guilds і GET /api/guilds/{guild_id}/channels для переліку.
Поширені запитання
Повертається401 unauthorized
Токен доступу неправильний або його передано способом ?token=. Переконайтеся, що токен передається через заголовок запиту Authorization: Bearer <令牌> і збігається з тим, що відображається в консолі.
Повертається 503
З’єднання з Discord ще не встановлено. Спершу перейдіть до /readyz, щоб переглянути gateway_ready. Якщо протягом тривалого часу відображається false, імовірно, облікові дані акаунта стали недійсними — отримайте їх повторно та виконайте повторне розгортання.
Повертається 403 або 404
Сам акаунт не має відповідних дозволів (наприклад, він не перебуває на цьому сервері або не має права писати в цьому каналі), або ID вказано неправильно. Такі помилки надходять від Discord, а не від проксі-сервісу.
Повертається 429
Спрацювало обмеження частоти Discord. Поле retry_after у відповіді містить рекомендовану кількість секунд очікування. Зменште частоту викликів.
Обліковий запис заблоковано після надсилання повідомлення
Як зазначалося раніше, автоматизація операцій з особистим обліковим записом порушує Умови використання Discord. Використовуйте окремий додатковий обліковий запис і контролюйте частоту операцій, уникаючи масового розсилання та інших чутливих дій.
