Leitfaden zur Verwendung des Telegram-Konto-Proxys

Dies ist kein Bot der Telegram Bot API. Bitte nicht für Spam-Nachrichten, massenhafte Kaltakquise oder zur Umgehung von Telegram-Beschränkungen verwenden. Bevor Inhalte an Dritte gesendet, bearbeitet oder gelöscht werden, sollte dein Agent eine ausdrückliche Bestätigung einholen.

​

Bereitstellung und Anmeldung

1. Erstelle unter Konsole → Anwendungen einen Telegram-Konto-Proxy, klicke nach Abschluss des Abonnements auf Bereitstellen. Die Instanzressourcen werden automatisch von der Plattform konfiguriert.
2. Klicke nach der Bereitschaft der Instanz auf „Anmelde-QR-Code generieren“. Der QR-Code ist nur kurzzeitig gültig und kann nach Ablauf erneut generiert werden.
3. Öffne in Telegram Einstellungen → Geräte → Desktop-Gerät verknüpfen und scanne den QR-Code.
4. Wenn der Status zu password_required wird, gib in der Konsole dein Telegram-Passwort für die Zwei-Schritt-Verifizierung ein. Das Passwort wird nur an deine Mandanteninstanz übermittelt und nicht in der Plattformkonfiguration gespeichert.
5. Sobald der Status zu authenticated wird, zeigt die Konsole das aktuelle Konto, die MCP-Adresse und das Bearer-Zugriffstoken an.

​

Authentifizierung und Zustandsprüfung

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-Client verbinden

​

Claude Code

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

​

Cursor und andere Clients, die statische Request-Header unterstützen

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

​

MCP-Tools

​

REST API

​

Beispiele

# 当前账号
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"}'

​

Vollständige Schnittstellen

​

Häufige Fragen

• 401：Bearer-Token fehlt oder ist falsch. Bestätigen Sie, dass der Token im Request-Header und nicht als URL-Abfrageparameter platziert ist.
• 503：Proxy-Zugriffstoken ist nicht konfiguriert oder der Telegram-Client ist noch nicht bereit. Prüfen Sie zuerst /readyz; wenn der Proxy-Zugriffstoken nicht konfiguriert ist, geben auch geschützte Schnittstellen 503 zurück.
• 400：Parameter oder JSON ungültig; für die Suche muss q angegeben werden, und limit muss eine ganze Zahl größer oder gleich 1 sein.
• 403 / 404：Das aktuelle Konto hat keine Berechtigung, oder die target- / message-ID existiert nicht.
• 429：Telegram-Ratenlimit wurde ausgelöst. Lesen Sie retry_after und warten Sie, nicht parallel erneut versuchen.
• QR-Code wird weiterhin nicht abgeschlossen：Generieren Sie den QR-Code erneut und bestätigen Sie, dass der Scan-Einstieg „Desktop-Gerät verknüpfen“ von Telegram verwendet wird.
• Nach einem Neustart wird eine erneute Anmeldung verlangt：Prüfen Sie, ob das persistente Volume der Instanz ordnungsgemäß funktioniert; nach einer aktiven Abmeldung, dem Widerrufen der Sitzung in der Telegram-Geräteliste oder dem Ablauf der Sitzung muss erneut gescannt werden.

​

Validierungsumfang