Przewodnik korzystania z proxy konta Telegram

To nie jest bot Telegram Bot API. Nie używaj go do spamu, masowego wysyłania zimnych wiadomości ani obchodzenia ograniczeń Telegrama. Przed wysłaniem, edycją lub usunięciem treści do stron trzecich Twój Agent powinien uzyskać wyraźne potwierdzenie.

​

Wdrażanie i logowanie

1. Utwórz proxy konta Telegram w Konsola → Aplikacje, po aktywowaniu subskrypcji kliknij wdrożenie. Zasoby instancji są konfigurowane automatycznie przez platformę.
2. Gdy instancja będzie gotowa, kliknij „Wygeneruj kod QR logowania”. Kod QR jest ważny przez krótki czas i można go wygenerować ponownie po wygaśnięciu.
3. W Telegramie otwórz Ustawienia → Urządzenia → Połącz urządzenie desktopowe i zeskanuj kod QR.
4. Jeśli status zmieni się na password_required, wprowadź w konsoli hasło weryfikacji dwuetapowej Telegrama. Hasło jest przesyłane wyłącznie do instancji Twojego dzierżawcy i nie zostanie zapisane w konfiguracji platformy.
5. Gdy status zmieni się na authenticated, konsola wyświetli bieżące konto, adres MCP i token dostępu Bearer.

​

Uwierzytelnianie i kontrola kondycji

Authorization: Bearer <token dostępu>

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"}

​

Łączenie klienta MCP

​

Claude Code

claude mcp add \
  --transport http \
  --header "Authorization: Bearer <token dostępu>" \
  telegram \
  https://telegram-bot-xxxxxxxxxxxx.app.acedata.cloud/mcp

​

Cursor i inni klienci obsługujący statyczne nagłówki żądań

{
  "mcpServers": {
    "telegram": {
      "type": "http",
      "url": "https://telegram-bot-xxxxxxxxxxxx.app.acedata.cloud/mcp",
      "headers": {"Authorization": "Bearer <token dostępu>"}
    }
  }
}

​

Narzędzia MCP

​

REST API

​

Przykłady

# Bieżące konto
curl https://telegram-bot-xxxxxxxxxxxx.app.acedata.cloud/api/whoami \
  -H "Authorization: Bearer $PROXY_ACCESS_TOKEN"

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

# Wyślij testową wiadomość do 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"}'

​

Pełny interfejs

​

Często zadawane pytania

• 401：Brak lub błąd tokenu Bearer. Upewnij się, że token znajduje się w nagłówku żądania, a nie w parametrze zapytania URL.
• 503：Token dostępu proxy nie jest skonfigurowany lub klient Telegrama nie jest jeszcze gotowy. Najpierw sprawdź /readyz; jeśli token dostępu proxy nie jest skonfigurowany, chronione interfejsy również zwrócą 503.
• 400：Parametry lub JSON są nieprawidłowe; wyszukiwanie musi podawać q, a limit musi być liczbą całkowitą większą lub równą 1.
• 403 / 404：Bieżące konto nie ma uprawnień lub target / ID wiadomości nie istnieje.
• 429：Uruchomiono limit częstotliwości Telegrama. Odczytaj retry_after i zaczekaj, nie ponawiaj prób równolegle.
• Kod QR ciągle nie zostaje ukończony：Wygeneruj ponownie kod QR i upewnij się, że używasz wejścia skanowania Telegrama „Połącz urządzenie desktopowe”.
• Po ponownym uruchomieniu wymagane jest ponowne logowanie：Sprawdź, czy trwały wolumin instancji działa prawidłowo; po aktywnym wylogowaniu, unieważnieniu sesji na liście urządzeń Telegrama lub wygaśnięciu sesji konieczne jest ponowne zeskanowanie kodu.

​

Zakres weryfikacji