Jak dodać integrację z Telegramem w KSeFGPT?
Podaj token bota i identyfikator czatu, wyślij wiadomość testową, a następnie zapisz aktywne połączenie dla wybranej firmy.
- Moduł
- Integracje
- Czas czytania
- 4 min
- Poziom trudności
- Z łatwością wykonasz opisane kroki samodzielnie
- Opublikowano
- 26 sierpnia 2026
- Autor
- Rafał Zeidler
- Format
- Tekst i nagranie
Procedura pisemna
Co zrobisz
Dodasz połączenie Telegram do wybranej firmy w KSeFGPT. Przed zapisem zweryfikujesz bota i wyślesz jedną wiadomość testową. Na końcu zobaczysz kartę integracji ze statusem Aktywna.
Token pozwala sterować botem, dlatego traktuj go jak hasło. Nie pokazuj go w zrzutach ekranu, dokumentach ani zgłoszeniach do pomocy technicznej.
Wymagania
Zanim zaczniesz
Przygotuj bota utworzonego przez @BotFather i docelowy czat. Dodaj bota do tego czatu przed testem, ponieważ KSeFGPT wyśle do niego prawdziwą wiadomość.
| Element | Opis |
|---|---|
| Dostęp | Właściciel firmy albo członek organizacji z zakresem integrations:manage. |
| Plan | Plan KSeFGPT z włączonym modułem Automatyzacja i Integracje. |
| Dane Telegram | Token bota od @BotFather oraz ID grupy, kanału albo użytkownika, na przykład -1001234567890. |
| Punkt startowy | Po zalogowaniu otwórz Automatyzacja, a następnie Integracje. |
| Czas wykonania | Około 3 minut. |
| Skutek testu | Kliknięcie Testuj połączenie od razu wysyła jedną wiadomość na wskazany czat Telegram. |
Nagranie procesu
Nagranie pokazuje wybór Telegrama, wpisanie tokenu bota i ID czatu, test wiadomości oraz zapis aktywnej integracji.
Otwórz integracje
W bocznym menu wybierz Automatyzacja, a następnie Integracje. Kliknij Dodaj pierwszą integrację albo Dodaj integrację, jeśli na liście są już inne połączenia.
Powinno otworzyć się okno z dostępnymi typami integracji.
Wybierz Telegram
W oknie Dodaj integrację wybierz Telegram. Karta jest opisana jako połączenie do wysyłania powiadomień przez bota Telegram.
Po wyborze zobaczysz formularz Konfiguruj Telegram.
Wpisz dane bota i czatu
W polu Nazwa wpisz rozpoznawalną nazwę integracji. W polu Token bota wklej wartość otrzymaną od @BotFather, a w polu ID czatu wpisz identyfikator odbiorcy wiadomości.
Token powinien mieć postać `123456:ABC-DEF...`. Identyfikator grupy lub kanału zwykle zaczyna się od znaku minus.
Przetestuj połączenie
Kliknij Testuj połączenie. KSeFGPT najpierw zweryfikuje token, a następnie wyśle wiadomość testową do podanego czatu.
Poczekaj na zielone potwierdzenia Połączono z botem oraz Testowa wiadomość wysłana na czat. Sprawdź też, czy wiadomość dotarła do właściwego odbiorcy w Telegramie.
Zapisz integrację
Kliknij Zapisz. Po zapisaniu okno zostanie zamknięte, a lista integracji odświeży się automatycznie.
Nowa karta powinna pokazywać podaną nazwę, typ Telegram i status Aktywna. Z jej poziomu możesz ponownie wykonać test, edytować dane albo usunąć połączenie.
Stan końcowy
Sprawdź rezultat
Integracja jest gotowa, gdy wiadomość testowa znajduje się we wskazanym czacie Telegram, a karta połączenia w KSeFGPT ma status Aktywna.
Jeżeli token został ujawniony, unieważnij go u @BotFather i zapisz nowy token w edycji integracji.
Diagnostyka
Jeśli coś nie działa
Porównaj widoczny objaw z poniższą tabelą.
| Objaw | Prawdopodobna przyczyna | Co zrobić |
|---|---|---|
| Testuj połączenie jest nieaktywne | Pole Token bota jest puste. | Wklej pełny token otrzymany od @BotFather. |
| Zapisz jest nieaktywne | Brakuje nazwy integracji, tokenu bota albo ID czatu. | Uzupełnij wszystkie trzy wymagane pola. |
| Nieprawidłowy format tokenu bota | Token nie ma części liczbowej, dwukropka i tajnego ciągu znaków. | Skopiuj token ponownie z rozmowy z @BotFather. |
| Nie udało się zweryfikować bota | Token jest błędny, wygasł albo został unieważniony. | Sprawdź token lub wygeneruj nowy u @BotFather i powtórz test. |
| Bot istnieje, ale nie może wysłać wiadomości | ID czatu jest błędne albo bot nie został dodany do wskazanego czatu. | Sprawdź ID czatu, dodaj bota i ponów test. |
| Nie możesz zapisać integracji | Brakuje zakresu integrations:manage albo zapis zakończył się błędem. | Poproś właściciela organizacji o właściwe uprawnienie i spróbuj ponownie. |
Co dalej
W edytorze automatyzacji dodaj blok powiadomienia Telegram i wybierz zapisaną integrację.
Po zmianie tokenu albo ID czatu ponownie przetestuj połączenie przed uruchomieniem produkcyjnego przepływu.
Dodaj integrację z Telegramem
Zaloguj się, przetestuj bota i zapisz połączenie dla wybranej firmy.
Powiązane instrukcje
Jak dodać integrację ze Slackiem w KSeFGPT?
Podaj adres incoming webhooka i opcjonalny kanał, wyślij wiadomość testową, a następnie zapisz aktywne połączenie dla wybranej firmy.
Jak pobrać faktury z Fakturownia.pl i wysłać je bezpośrednio do KSeF?
Pobierz faktury sprzedaży przez zapisaną integrację, wybierz właściwe dokumenty i prześlij je do KSeF bez pobierania oraz ręcznego wgrywania plików XML.
Jak dodać integrację z Fakturownia.pl?
Połącz konto Fakturownia.pl z wybraną firmą w KSeFGPT, sprawdź dane dostępowe i zapisz aktywną integrację. Potrzebujesz subdomeny konta oraz tokenu API z Fakturowni.