Połącz z Telegram: przewodnik krok po kroku
Wysyła alerty o niepowodzeniach (jeden na test przy NEXUS_TELEGRAM_NOTIFY=true) oraz raporty i pliki wybrane do udostępnienia za pośrednictwem własnego bota. Nie ma wspólnego bota. Ten przewodnik prowadzi od zera do sprawdzonego połączenia i przedstawia możliwe błędy wraz z ich przyczynami i sposobami naprawy.
Ostatnia aktualizacja:
Chroń swoje dane uwierzytelniające. Nigdy nie wklejaj tokenu, klucza, hasła ani adresu URL webhooka na czacie. Wprowadzaj je wyłącznie w Studio → Ustawienia → Integracje, gdzie są zapisywane w pliku .env obszaru roboczego i wyświetlane jako kropki. Dotyczy to również asystenta AI: może przeprowadzić Cię przez ten przewodnik, ale nigdy nie potrzebuje Twojego tokenu.
Czego potrzebujesz
- Konto w Telegram.
- Własny bot, utworzony jednorazowo za pomocą @BotFather, oraz jego token.
- Telefon lub aplikacja Telegram do zeskanowania kodu QR parowania.
- Zanim włączysz tę funkcję: Telegram może odbierać pliki, takie jak raporty i pliki PDF, które trafiają na serwery Telegram. W środowisku podlegającym regulacjom najpierw skonsultuj się z zespołem ds. zgodności.
Uzyskaj dane uwierzytelniające
- W Telegram otwórz https://t.me/BotFather i wyślij /newbot. Nadaj botowi nazwę i nazwę użytkownika.
- BotFather odpowie tokenem bota (na przykład 123456:ABC…). Skopiuj go.
- Zachowaj go w schowku. Nie wklejaj go nigdzie poza Studio (następny krok).
Połącz w Studio
- W Studio otwórz Ustawienia → Integracje → Połącz z Telegram.
- Wklej token bota i zapisz. Pojawi się kod QR parowania.
- Zeskanuj kod QR telefonem i dotknij Start w Telegram. W ciągu kilku sekund Studio wyświetli "alerty trafiają na czat …", a bot napisze "Połączono z Nexus StudioQA."
- Włącz
TELEGRAM_ENABLED. Aby otrzymywać jeden alert dla każdego nieudanego testu, włącz teżNEXUS_TELEGRAM_NOTIFY.
Sprawdź, czy działa
- Po zeskanowaniu bot wyśle na Twój czat wiadomość "Połączono z Nexus StudioQA. Tutaj będą zgłaszane nieudane testy."
- Studio wyświetla "alerty trafiają na czat" z zamaskowanymi danymi czatu.
Typowe błędy
| Co widzisz | Przyczyna | Rozwiązanie |
|---|---|---|
| "Telegram jest wyłączony" | TELEGRAM_ENABLED ma wartość false, a parowanie wymaga włączenia tej opcji. | Włącz TELEGRAM_ENABLED i ponownie naciśnij Połącz z Telegram. |
| "Brak tokena bota" | Pole TELEGRAM_TOKEN jest puste. | Wklej token z BotFather w Ustawienia → Integracje i zapisz. |
| "Telegram: Brak autoryzacji" (lub "Nie znaleziono") | Token bota jest nieprawidłowy, został unieważniony w BotFather lub nie został skopiowany w całości. | Wyślij /token do BotFather, aby ponownie uzyskać token (lub utwórz nowego bota), i zapisz go. |
| "Kod QR wygasł przed zeskanowaniem" | Kod QR jest ważny tylko przez kilka minut. | Naciśnij Połącz z Telegram, aby wygenerować nowy kod, i od razu go zeskanuj. |
| Kod QR został zeskanowany, ale Studio nadal czeka | Zeskanowanie kodu otworzyło czat, ale nie naciśnięto Start lub zamknięto okno Studio. | Naciśnij Start na czacie z botem. Jeśli Studio nadal czeka, wygeneruj nowy kod QR. |
| "nie można połączyć się z Telegram (ENOTFOUND)" lub "brak odpowiedzi w ciągu 20 s" | Ten komputer nie może połączyć się z api.telegram.org: przyczyną jest VPN, zapora sieciowa, serwer proxy lub brak sieci. | Sprawdź połączenie sieciowe na tym samym komputerze i spróbuj ponownie. |
| Po niepowodzeniu nie przychodzi żadne powiadomienie | TELEGRAM_ENABLED ma wartość false, nie sparowano czatu lub powiadomienia dla poszczególnych testów są wyłączone (NEXUS_TELEGRAM_NOTIFY). | Sparuj czat i włącz oba przełączniki. |
Klucze ustawień
| Klucz | Co robi | Prawidłowa wartość | Jak sprawdzić |
|---|---|---|---|
TELEGRAM_ENABLED | Wysyłaj powiadomienia do Telegram | true lub false | Ta opcja musi być włączona, aby wyświetlić kod QR do parowania. |
TELEGRAM_TOKEN | Kod dostępu bota Telegram (tajny, zapisywany tylko na tym komputerze) | Token bota z BotFather, np. 123456:ABC…, w jednym wierszu | Kod QR pojawi się tylko wtedy, gdy Telegram zaakceptuje token. |
TELEGRAM_CHAT_ID | Czat Telegram do powiadomień | Uzupełniane podczas parowania kodem QR; nie wpisuj ręcznie | Studio wyświetla "powiadomienia trafiają na czat …". |
NEXUS_TELEGRAM_NOTIFY | Powiadomienie w Telegram o każdym niepowodzeniu | true lub false | Otrzymasz jedno powiadomienie na każdy nieudany test. |
Więcej: wszystkie integracje, przewodnik po ustawieniach, rozwiązywanie problemów. Inne przewodniki: Jira Cloud, Azure Boards, Slack, Microsoft Teams, GitHub Issues.
Nadal masz problem? Napisz na [email protected] i podaj dokładny komunikat błędu wyświetlany w Studio. Nie dołączaj tokena.