Посібник із використання проксі акаунта Telegram

Це не бот Telegram Bot API. Будь ласка, не використовуйте його для спаму, масових холодних розсилок або обходу обмежень Telegram. Перед надсиланням, редагуванням або видаленням вмісту третім особам ваш Agent повинен отримати явне підтвердження.

​

Розгортання та вхід

1. У консолі → застосунки створіть проксі акаунта Telegram, після оформлення підписки натисніть розгорнути. Ресурси екземпляра автоматично налаштовуються платформою.
2. Після готовності екземпляра натисніть «Згенерувати QR-код для входу». QR-код дійсний протягом короткого часу, після завершення строку дії його можна згенерувати повторно.
3. У Telegram відкрийте Налаштування → Пристрої → Підключити пристрій для комп’ютера та відскануйте QR-код.
4. Якщо статус зміниться на password_required, введіть у консолі пароль двоетапної перевірки Telegram. Пароль надсилається лише до екземпляра вашого тенанта й не записується в конфігурацію платформи.
5. Після зміни статусу на authenticated консоль відобразить поточний акаунт, MCP-адресу та Bearer токен доступу.

​

Автентифікація та перевірка стану

Authorization: Bearer <访问令牌>

curl https://telegram-bot-xxxxxxxxxxxx.app.acedata.cloud/health
curl https://telegram-bot-xxxxxxxxxxxx.app.acedata.cloud/readyz

{"status":"ok"}

{"status":"ready","gateway_connected":true,"login_state":"login_required"}

​

Підключення MCP-клієнта

​

Claude Code

claude mcp add \
  --transport http \
  --header "Authorization: Bearer <访问令牌>" \
  telegram \
  https://telegram-bot-xxxxxxxxxxxx.app.acedata.cloud/mcp

​

Cursor та інші клієнти, що підтримують статичні заголовки запитів

{
  "mcpServers": {
    "telegram": {
      "type": "http",
      "url": "https://telegram-bot-xxxxxxxxxxxx.app.acedata.cloud/mcp",
      "headers": {"Authorization": "Bearer <访问令牌>"}
    }
  }
}

​

Інструменти MCP

​

REST API

​

Приклади

# 当前账号
curl https://telegram-bot-xxxxxxxxxxxx.app.acedata.cloud/api/whoami \
  -H "Authorization: Bearer $PROXY_ACCESS_TOKEN"

# 最近会话
curl "https://telegram-bot-xxxxxxxxxxxx.app.acedata.cloud/api/chats?limit=20&unread_only=false" \
  -H "Authorization: Bearer $PROXY_ACCESS_TOKEN"

# 给 Saved Messages 发一条测试消息
curl -X POST https://telegram-bot-xxxxxxxxxxxx.app.acedata.cloud/api/messages \
  -H "Authorization: Bearer $PROXY_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"target":"me","text":"Hello from my Telegram proxy"}'

​

Повний список інтерфейсів

​

Поширені запитання

• 401: Bearer токен відсутній або неправильний. Переконайтеся, що токен розміщено в заголовку запиту, а не в параметрах URL-запиту.
• 503: Токен доступу проксі не налаштовано, або клієнт Telegram ще не готовий. Спочатку перевірте /readyz; якщо токен доступу проксі не налаштовано, захищені інтерфейси також повертатимуть 503.
• 400: Параметри або JSON недійсні; для пошуку обов’язково потрібно надати q, limit має бути цілим числом, більшим або рівним 1.
• 403 / 404: Поточний акаунт не має дозволу, або target / message ID не існує.
• 429: Спрацьовує обмеження частоти Telegram. Прочитайте retry_after і зачекайте, не виконуйте повторних спроб паралельно.
• QR-код постійно не завершено: Згенеруйте QR-код повторно та переконайтеся, що використовується точка входу сканування Telegram «Підключити пристрій для комп’ютера».
• Після перезапуску потрібно знову увійти: Перевірте, чи нормально працює постійний том інстансу; після активного виходу, відкликання сеансу в списку пристроїв Telegram або втрати чинності сеансу потрібно повторно сканувати код.

​

Обсяг перевірки