Telegram verbinden: Schritt-für-Schritt-Anleitung
Sendet über Ihren eigenen Bot Benachrichtigungen bei Fehlschlägen (eine pro Test mit NEXUS_TELEGRAM_NOTIFY=true) sowie die Berichte und Dateien, die Sie teilen möchten. Es gibt keinen gemeinsam genutzten Bot. Diese Anleitung führt Sie von den ersten Schritten bis zur überprüften Verbindung und listet mögliche Fehler mit ihren Ursachen und Lösungen auf.
Zuletzt aktualisiert:
Halten Sie Ihre Zugangsdaten geheim. Fügen Sie niemals ein Token, einen Schlüssel, ein Passwort oder eine Webhook-URL in einen Chat ein. Geben Sie diese ausschließlich unter Studio → Einstellungen → Integrationen ein. Dort werden sie in der .env-Datei Ihres Arbeitsbereichs gespeichert und als Punkte angezeigt. Das gilt auch für KI-Assistenten: Sie können Sie durch diese Anleitung führen, benötigen aber niemals Ihr Token.
Was Sie benötigen
- Ein Telegram-Konto.
- Ein eigener Bot, den Sie einmalig mit @BotFather erstellen, und dessen Token.
- Ein Smartphone oder eine Telegram-App zum Scannen des QR-Codes für die Kopplung.
- Vor dem Aktivieren: Telegram kann Dateien wie Berichte und PDFs empfangen, die dabei auf die Server von Telegram gelangen. Fragen Sie in einem regulierten Umfeld zuerst Ihr Compliance-Team.
Zugangsdaten beschaffen
- Öffnen Sie in Telegram https://t.me/BotFather und senden Sie /newbot. Geben Sie dem Bot einen Namen und einen Benutzernamen.
- BotFather antwortet mit dem Bot-Token (zum Beispiel 123456:ABC…). Kopieren Sie es.
- Behalten Sie es in der Zwischenablage. Fügen Sie es ausschließlich im Studio ein (nächster Schritt).
Im Studio verbinden
- Öffnen Sie im Studio Einstellungen → Integrationen → Telegram verbinden.
- Fügen Sie das Bot-Token ein und speichern Sie. Der QR-Code für die Kopplung wird angezeigt.
- Scannen Sie den QR-Code mit Ihrem Smartphone und tippen Sie in Telegram auf Start. Innerhalb weniger Sekunden zeigt das Studio "Benachrichtigungen gehen an Chat …" an und der Bot meldet "Mit Nexus StudioQA verbunden."
- Aktivieren Sie
TELEGRAM_ENABLED. Für eine Benachrichtigung pro fehlgeschlagenem Test aktivieren Sie zusätzlichNEXUS_TELEGRAM_NOTIFY.
Funktion überprüfen
- Nach dem Scannen sendet der Bot "Mit Nexus StudioQA verbunden. Fehlgeschlagene Tests werden hier gemeldet." an Ihren Chat.
- Das Studio zeigt "Benachrichtigungen gehen an Chat" mit maskierter Chat-Kennung an.
Häufige Fehler
| Was Sie sehen | Ursache | Lösung |
|---|---|---|
| "Telegram ist deaktiviert" | TELEGRAM_ENABLED ist false, muss für die Kopplung aber aktiviert sein. | Aktivieren Sie TELEGRAM_ENABLED und klicken Sie erneut auf Telegram verbinden. |
| "Kein Bot-Token" | TELEGRAM_TOKEN ist leer. | Fügen Sie das Token von BotFather unter Einstellungen → Integrationen ein und speichern Sie es. |
| "Telegram: Nicht autorisiert" (oder "Nicht gefunden") | Das Bot-Token ist falsch, wurde in BotFather widerrufen oder beim Kopieren abgeschnitten. | Senden Sie /token an BotFather, um das Token erneut abzurufen (oder erstellen Sie einen neuen Bot), und speichern Sie es. |
| "Der QR-Code ist vor dem Scannen abgelaufen" | Der QR-Code ist nur wenige Minuten gültig. | Klicken Sie auf Telegram verbinden, um einen neuen zu erstellen, und scannen Sie ihn sofort. |
| Der QR-Code wurde gescannt, aber Studio wartet weiterhin | Beim Scannen wurde der Chat geöffnet, aber Start wurde nicht angetippt, oder das Studio-Fenster wurde geschlossen. | Tippen Sie im Chat des Bots auf Start. Wenn Studio weiterhin wartet, erstellen Sie einen neuen QR-Code. |
| "Telegram konnte nicht erreicht werden (ENOTFOUND)" oder "keine Antwort innerhalb von 20 s" | Dieser PC kann api.telegram.org nicht erreichen: wegen eines VPNs, einer Firewall oder eines Proxys oder einer fehlenden Netzwerkverbindung. | Prüfen Sie die Netzwerkverbindung auf demselben PC und versuchen Sie es erneut. |
| Nach einem Fehler trifft keine Benachrichtigung ein | TELEGRAM_ENABLED ist auf false gesetzt, es ist kein Chat gekoppelt oder die Benachrichtigungen pro Test sind ausgeschaltet (NEXUS_TELEGRAM_NOTIFY). | Koppeln Sie einen Chat und aktivieren Sie beide Schalter. |
Konfigurationsschlüssel
| Schlüssel | Funktionsumfang | Gültiger Wert | So prüfen Sie ihn |
|---|---|---|---|
TELEGRAM_ENABLED | Benachrichtigungen an Telegram senden | true oder false | Für den Kopplungs-QR-Code muss dies aktiviert sein. |
TELEGRAM_TOKEN | Zugangscode für den Telegram-Bot (geheim, nur auf diesem Computer gespeichert) | Das Bot-Token von BotFather, etwa 123456:ABC…, in einer Zeile | Der QR-Code erscheint nur, wenn Telegram es akzeptiert. |
TELEGRAM_CHAT_ID | Telegram-Chat für Benachrichtigungen | Wird durch die QR-Kopplung ausgefüllt; nicht manuell eingeben | Studio zeigt "Benachrichtigungen gehen an Chat …" an. |
NEXUS_TELEGRAM_NOTIFY | Telegram-Benachrichtigung pro Fehler | true oder false | Pro fehlgeschlagenem Test trifft eine Benachrichtigung ein. |
Mehr: alle Integrationen, der Leitfaden zu den Einstellungen, Fehlerbehebung. Weitere Leitfäden: Jira Cloud, Azure Boards, Slack, Microsoft Teams, GitHub Issues.
Kommen Sie nicht weiter? Schreiben Sie an [email protected] und geben Sie die genaue Fehlerzeile an, die das Studio anzeigt. Senden Sie kein Token mit.