⚠️ Обов’язково прочитайте перед використанням
Автоматизація операцій з особистим акаунтом (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. Будь ласка, використовуйте спеціальний додатковий обліковий запис і контролюйте частоту операцій, уникаючи чутливих дій, як-от масове надсилання повідомлень.