Zum Inhalt springen
SupaCloud Docs
Farbschema wählenSprache wählen

Einen Telegram-Bot verbinden

Der Telegram-Bot bietet dieselbe Steuerungsoberfläche wie das Web-Terminal — Tasks starten, Live-Ausgabe verfolgen, Schedules verwalten — und das von jedem Telegram-Client aus. Er startet nur, wenn TELEGRAM_BOT_TOKEN gesetzt ist; das Token allein genügt, um Befehle entgegenzunehmen.

Voraussetzungen

Abschnitt betitelt „Voraussetzungen“
  • Ein über @BotFather erstellter Telegram-Bot und sein Token.
  • Eine laufende SupaCloud-Instanz mit Netzwerkzugriff auf api.telegram.org.
  • Ein eigenes SupaCloud-Konto (damit du in den Einstellungen ein Link-Token erzeugen kannst).

Schritte

Abschnitt betitelt „Schritte“

  1. Bot-Token setzen.

    Füge TELEGRAM_BOT_TOKEN der Serverumgebung deiner SupaCloud-Instanz hinzu, bevor du den Server startest (oder neustartest). Der Bot startet nicht, wenn diese Variable fehlt.

    TELEGRAM_BOT_TOKEN=<your-bot-token>

    Bei erfolgreicher Verbindung erscheint im Server-Log:

    Telegram bot started: @<your-bot-username>

  2. Link-Token in SupaCloud erzeugen.

    Öffne Einstellungen in der Web-Oberfläche und wechsle zum Tab Telegram. Ein einmalig verwendbares Link-Token wird automatisch angezeigt (mit Aktualisieren lässt sich ein neues erzeugen). Kopiere das Token — es läuft nach kurzer Zeit ab.

    Alternativ kannst du die API direkt aufrufen:

    POST /api/settings/telegram-link-token
    Authorization: Bearer <session-token>

    Die Antwort enthält token und expires_at.

  3. Telegram-Konto verknüpfen.

    Sende in einem Telegram-Chat mit deinem Bot:

    /link <token>

    wobei <token> der Wert aus dem vorherigen Schritt ist. Der Bot antwortet bei Erfolg mit einer Bestätigungsnachricht. Das Token ist einmalig: Nach der Verwendung kann es nicht erneut genutzt werden.

  4. Verknüpfung prüfen.

    Sende /status an deinen Bot. Er sollte mit deinen aktiven Tasks antworten (oder einer leeren Liste) — nicht mit einem Hinweis, dass kein Konto verknüpft ist. Siehst du diese Meldung trotzdem, wird deine Chat-ID angezeigt — nutze sie zur Diagnose etwaiger Allowlist-Probleme.

Verbindung prüfen

Abschnitt betitelt „Verbindung prüfen“
Befehl Beschreibung
/status Aktive Tasks — sendet eine Liste mit Inline-Buttons; tippe auf einen Task für Logs / Abbrechen / Folgen.

Nach /follow <id> wechselt der Bot in den Live-Modus und gibt die Task-Ausgabe als einzelne bearbeitete Nachricht aus; sende /unfollow oder Klartext als Intervention. /run startet einen Task im Hintergrund und antwortet mit dessen ID — mit /follow <id> kannst du die Live-Ausgabe verfolgen. Die vollständige Befehlsreferenz und Details zum Live-Modus findest du unter Telegram-Befehle.

Siehe auch

Abschnitt betitelt „Siehe auch“