Integracja chatbota z Telegram Bot
Niniejsza instrukcja przeprowadzi Cię przez proces integracji naszego chatbota z Telegram Bot API. Po wykonaniu wszystkich kroków, Twoi użytkownicy będą mogli komunikować się z chatbotem bezpośrednio przez aplikację Telegram. Instrukcja obejmuje również konfigurację komend specjalnych dla bota.
Spis treści
Wybierz swój punkt startowy
Zaczynam od zera
Nie mam jeszcze bota w Telegram i potrzebuję przejść przez cały proces integracji
Mam już bota Telegram
Mam już utworzonego bota i potrzebuję skonfigurować go z chatbotem AI
Mam skonfigurowanego chatbota
Chatbot działa i chcę dodać specjalne komendy lub zoptymalizować ustawienia
Przegląd procesu integracji
Integracja chatbota z Telegram Bot to proces, który składa się z kilku głównych etapów:
- Utworzenie bota w Telegram - stworzenie nowego bota za pomocą BotFather i uzyskanie tokenu dostępu.
- Konfiguracja chatbota na platformie - utworzenie nowego chatbota z funkcjonalnością Telegram Bot, wprowadzenie tokenu i automatyczna konfiguracja webhooka.
- Zarządzanie komendami - konfiguracja specjalnych komend dla bota, które będą dostępne w menu Telegram.
- Testowanie i optymalizacja - sprawdzenie działania bota i dostosowanie ustawień.
- Aplikacji Telegram na telefonie lub komputerze
- Konta na platformie ChatbotAssistant z aktywną subskrypcją
- Podstawowej wiedzy o tym, jak działa Telegram (opcjonalnie)
Utworzenie bota w Telegram przez BotFather
Pierwszym krokiem jest utworzenie nowego bota w Telegram przez oficjalnego BotFather. BotFather to specjalny bot Telegram, który służy do zarządzania wszystkimi botami na platformie.
Oficjalny bot do zarządzania botami Telegram
Szczegółowa instrukcja:
- Otwórz aplikację Telegram na telefonie lub komputerze.
- Wyszukaj BotFather - w polu wyszukiwania wprowadź @BotFather i wybierz oficjalny bot (będzie miał niebieską ikonę weryfikacji).
- Rozpocznij rozmowę z BotFather klikając przycisk "Start" lub wysyłając komendę /start.
- Utwórz nowego bota wysyłając komendę:
/newbotKomenda do tworzenia nowego bota
- Podaj nazwę bota - BotFather poprosi Cię o podanie nazwy dla bota. Nazwa może zawierać spacje i znaki specjalne. Przykłady:
Przykłady nazw: - Asystent Sklepu - Restauracja Smaki Świata Bot - Centrum Obsługi Klienta
- Podaj username bota - następnie musisz podać unikalny username dla bota. Username musi:
- Kończyć się słowem "bot" (np. mojsklepbot lub my_restaurant_bot)
- Być unikalny w całym systemie Telegram
- Zawierać tylko litery, cyfry i podkreślenia
- Mieć długość od 5 do 32 znaków
Przykłady username: - mojsklepbot - restauracja_smaki_bot - obslugatech_assistant_bot - Skopiuj token bota - Po pomyślnym utworzeniu bota, BotFather wyśle Ci wiadomość zawierającą token dostępu. Token wygląda podobnie do tego:
1234567890:AAEhDOM50CUBO9QIugrsgHP2g61FE15LAVwbdbIx
Często napotykane problemy na tym etapie:
Jeśli wprowadzony username jest już zajęty, spróbuj następujących rozwiązań:
- Dodaj cyfry na końcu (np. mojsklepbot2024)
- Dodaj dodatkowe słowo opisujące branżę (np. mojsklepmebelbot)
- Użyj podkreśleń do oddzielenia słów (np. moj_sklep_bot)
- Dodaj lokalizację (np. mojsklepwarshawabot)
Jeśli BotFather nie reaguje na Twoje komendy:
- Upewnij się, że piszesz do oficjalnego @BotFather (z niebieską ikoną weryfikacji)
- Sprawdź, czy komenda zaczyna się od znaku / (ukośnik)
- Spróbuj wysłać komendę /start aby zrestartować rozmowę
- Sprawdź połączenie internetowe i spróbuj ponownie
Konfiguracja chatbota na platformie ChatbotAssistant
Teraz skonfiguruj chatbota w naszym systemie, aby połączyć go z Twoim botem Telegram i nadać mu inteligencję AI.
Szczegółowa instrukcja konfiguracji:
- Przejdź do formularza chatbota - Zaloguj się do swojego konta na platformie ChatbotAssistant i przejdź do dashboardu.
- Rozpocznij tworzenie nowego chatbota - Kliknij przycisk "Utwórz nowego chatbota".
- Wybierz funkcjonalność Telegram Bot - W sekcji "Wybierz funkcjonalności chatbota" zaznacz opcję "Telegram Bot".

- Wypełnij konfigurację podstawową:
- Nazwa chatbota - wprowadź nazwę, która będzie używana wewnętrznie na naszej platformie (np. "Bot Telegram - Sklep Odzieżowy")
- Krótki opis - opcjonalnie dodaj krótki opis chatbota, który pomoże Ci go zidentyfikować
- Wprowadź informacje o firmie: Jest to najważniejsza część konfiguracji - im więcej szczegółowych informacji podasz, tym lepiej chatbot będzie odpowiadał na pytania użytkowników.
- Nazwa firmy - pełna nazwa Twojej firmy
- Lokalizacja - adres firmy, godziny otwarcia, informacje o parkingu itp.
- Oferta produktów/usług - szczegółowy opis tego, co oferujesz wraz z cenami
- Opis działalności - informacje o firmie, specjalnościach, warunkach dostawy, formach płatności, gwarancjach

- Konfiguracja Telegram Bot:
- Token bota Telegram - wklej token otrzymany od BotFather w poprzednim kroku
- Zapisz chatbota - Po wypełnieniu wszystkich pól, kliknij przycisk "Utwórz Chatbota".

Automatyczna konfiguracja webhooka:
Po wprowadzeniu prawidłowego tokena bota i zapisaniu konfiguracji, nasz system automatycznie skonfiguruje webhook, który umożliwi komunikację między Telegram a Twoim chatbotem AI.
Co dzieje się automatycznie po zapisaniu chatbota:
- 🔗 Konfiguracja URL webhooka - system automatycznie ustawi właściwy adres webhook w Telegram API
- 🔐 Generowanie sekretu bezpieczeństwa - automatyczne generowanie i konfiguracja bezpiecznego tokenu uwierzytelniającego
- ⚙️ Optymalizacja ustawień - konfiguracja tylko niezbędnych typów aktualizacji (wiadomości tekstowe)
- 🧹 Czyszczenie kolejki - usunięcie nieprzetworowanych aktualizacji z poprzednich konfiguracji
Zarządzanie komendami Telegram
Komendy Telegram to specjalne instrukcje, które użytkownicy mogą wysyłać do bota. Pozwalają na szybki dostęp do określonych funkcji i informacji. Nasza platforma umożliwia łatwe zarządzanie komendami przez interfejs webowy.
Dostęp do zarządzania komendami:
- W dashboardu znajdź swojego chatbota Telegram i kliknij Opcje a następnie "Komendy Telegram".
- Zostaniesz przekierowany do panelu zarządzania komendami.

Dodawanie nowej komendy:
- W panelu komend kliknij przycisk "Dodaj komendę".
- Wypełnij formularz dodawania komendy:

Konfiguracja komendy - szczegóły pól:
Format: Wprowadź nazwę bez znaku "/" (ukośnik zostanie dodany automatycznie)
Zasady:
- Tylko litery, cyfry i podkreślenia
- Długość od 1 do 32 znaków
- Bez spacji i znaków specjalnych
Przykłady prawidłowych nazw:
Opcjonalny opis wyświetlany w liście komend w aplikacji Telegram. Pomaga użytkownikom zrozumieć, do czego służy komenda.
Przykłady opisów:
Treść wiadomości, którą bot wyśle w odpowiedzi na komendę. Możesz używać zmiennych do personalizacji odpowiedzi.
Dostępne zmienne:
- {user_name} - Imię i nazwisko użytkownika
- {user_id} - ID użytkownika Telegram
- {username} - Nazwa użytkownika (@username)
- {chat_id} - ID czatu
Przykład odpowiedzi z użyciem zmiennych:
Przykłady przydatnych komend:
Zarządzanie istniejącymi komendami:
W panelu komend możesz:
- Edytować komendy - Kliknij na komendę, aby zmienić jej nazwę, opis lub odpowiedź
- Usuwać komendy - Usuń nieużywane lub niepotrzebne komendy
- Monitorować użycie - Zobacz statystyki, które komendy są najczęściej używane
Testowanie integracji
Po skonfigurowaniu wszystkich niezbędnych elementów, czas na przetestowanie integracji i upewnienie się, że chatbot działa zgodnie z oczekiwaniami.
Szczegółowa instrukcja testowania:
- Znajdź swojego bota w Telegram:
- Otwórz aplikację Telegram
- W polu wyszukiwania wprowadź username swojego bota (np. @mojsklepbot)
- Kliknij na bota z listy wyników
- Rozpocznij komunikację z botem:
- Kliknij przycisk "Start" lub wyślij komendę /start
- Bot powinien odpowiedzieć wiadomością powitalną skonfigurowaną w ustawieniach
- Testowanie komunikacji AI:
- Wyślij prostą wiadomość testową, np. "Cześć" lub "Witaj"
- Bot powinien odpowiedzieć zgodnie z konfiguracją AI i informacjami o firmie
- Zadaj pytanie związane z Twoją działalnością, aby sprawdzić, czy bot udziela trafnych odpowiedzi
- Testowanie komend specjalnych:
- Wyślij komendę /help lub /pomoc (jeśli została skonfigurowana)
- Przetestuj wszystkie komendy, które dodałeś w poprzednim kroku
- Sprawdź, czy odpowiedzi zawierają poprawnie podstawione zmienne (np. imię użytkownika)
- Test menu komend:
- Kliknij ikonę menu (/) w polu wprowadzania wiadomości
- Sprawdź, czy Twoje komendy są widoczne na liście
- Kliknij na komendę z menu, aby upewnić się, że działa poprawnie
Testowanie zaawansowane:
Przetestuj bota różnymi typami pytań:
- Pytania o produkty/usługi: "Jakie macie produkty?", "Ile kosztuje..."
- Pytania o godziny: "Kiedy jesteście otwarci?", "Jakie są godziny pracy?"
- Pytania o lokalizację: "Gdzie się znajdujecie?", "Jaki jest adres?"
- Pytania o kontakt: "Jak mogę się z wami skontaktować?"
- Pytania niezrozumiałe: Sprawdź, jak bot reaguje na pytania spoza zakresu
Sprawdź, jak bot radzi sobie z intensywną komunikacją:
- Wyślij kilka wiadomości szybko po sobie
- Przetestuj długie wiadomości (kilkaset znaków)
- Sprawdź response time przy różnych godzinach
- Zweryfikuj działanie rate limitingu (jeśli zostanie osiągnięty limit, bot poinformuje o konieczności odczekania)
Sprawdź działanie bota na różnych platformach:
- Aplikacja mobilna: Telegram na Android/iOS
- Aplikacja desktopowa: Telegram na Windows/Mac/Linux
- Wersja webowa: Telegram Web (web.telegram.org)
Bot powinien działać identycznie na wszystkich platformach.
Monitorowanie i analiza działania chatbota:
Po uruchomieniu chatbota, ważne jest monitorowanie jego działania i analizowanie interakcji z użytkownikami:
Nasza platforma oferuje rozbudowane narzędzia analityczne:
- Statystyki ogólne: Całkowita liczba zapytań i sesji, średnia długość konwersacji, średni czas odpowiedzi
- Aktywność użytkowników: Interaktywne wykresy z rozkładem ruchu według dni tygodnia i godzin
- Zachowanie użytkowników: Długość sesji i współczynnik powrotu
- Analiza popularnych tematów: Top 5 najczęściej poruszanych zagadnień
- Statystyki komend: Które komendy są najczęściej używane
- Sugestie optymalizacyjne: Automatycznie generowane rekomendacje
- Zaloguj się do panelu administracyjnego chatbota
- Przejdź do sekcji "Dashboard"
- Wybierz swojego bota Telegram i kliknij przycisk "Analityka"
- Przeglądaj szczegółowe dane i statystyki użytkowania
Zaawansowane ustawienia bota (opcjonalne)
Po podstawowej konfiguracji możesz dodatkowo dostosować swojego bota Telegram, korzystając z dodatkowych funkcji dostępnych w BotFather.
Opcjonalne ustawienia w BotFather:
Aby ustawić opis bota i zdjęcie profilowe:
- Otwórz rozmowę z @BotFather
- Użyj komendy /setdescription aby ustawić opis bota
- Wybierz swojego bota z listy
- Wprowadź opis, który będzie widoczny w profilu bota
Aby dodać zdjęcie profilowe:
- Użyj komendy /setuserpic
- Wybierz swojego bota
- Prześlij zdjęcie, które ma być awatarem bota
Możesz ustawić lista komend w menu Telegram:
- Użyj komendy /setcommands w BotFather
- Wybierz swojego bota
- Wprowadź listę komend w formacie:
Ważne: Komendy ustawione w BotFather będą widoczne w menu, ale ich funkcjonalność jest kontrolowana przez komendy skonfigurowane na naszej platformie.
Możesz skonfigurować ustawienia prywatności bota:
- Użyj komendy /setprivacy w BotFather
- Wybierz swojego bota
- Wybierz odpowiednie ustawienie:
- Disable: Bot będzie otrzymywał wszystkie wiadomości w grupach
- Enable: Bot będzie otrzymywał tylko wiadomości zaczynające się od "/" lub bezpośrednio skierowane do niego
Możesz przypisać własną domenę do swojego bota:
- Użyj komendy /setdomain w BotFather
- Wybierz swojego bota
- Wprowadź domenę w formacie: example.com
Po ustawieniu domeny, użytkownicy będą mogli znajdować Twojego bota pod adresem: https://t.me/example.com
Rate Limiting
Rate limiting to mechanizm ograniczający liczbę wiadomości, które użytkownik może wysłać do chatbota w określonym czasie. Chroni to system przed nadmiernym obciążeniem i zapewnia sprawiedliwe wykorzystanie zasobów.
Jak działa Rate Limiting:
- Limit per użytkownik: Każdy użytkownik ma swój własny limit (nie dzielony z innymi)
- Okno czasowe: 60 sekund
- Reset automatyczny: Licznik resetuje się co minutę
- Konfigurowalny limit: Każdy użytkownik może mieć różny limit ustawiony przez administratora
Co to oznacza dla użytkowników:
Gdy użytkownik osiągnie swój limit wiadomości w ciągu minuty, chatbot wyświetli mu komunikat informujący o konieczności odczekania przed wysłaniem kolejnej wiadomości. Po upływie minuty od pierwszej wiadomości w danym oknie czasowym, licznik automatycznie się resetuje.
Zwiększenie limitów rate limitingu:
Jeśli standardowe limity rate limitingu nie są wystarczające dla Twojego przypadku użycia (np. w przypadku chatbotów o bardzo wysokim ruchu lub specjalistycznych zastosowań), możesz poprosić o ich zwiększenie.
Rozwiązywanie problemów
Mimo starannego wykonania wszystkich kroków integracji, czasami mogą pojawić się problemy z działaniem chatbota. W tej sekcji przedstawiamy rozwiązania najczęściej występujących problemów.
Typowe problemy i ich rozwiązania:
Możliwe przyczyny:
- Token bota jest nieprawidłowy lub wygasł
- Webhook nie jest poprawnie skonfigurowany
- Bot jest już używany przez inny system
- Problemy z subskrypcją na platformie
- Czasowe problemy z siecią
Rozwiązanie:
- Sprawdź token bota - upewnij się, że został skopiowany prawidłowo z BotFather
- Zweryfikuj status subskrypcji na platformie ChatbotAssistant
- Sprawdź komunikaty o błędach w panelu administracyjnym chatbota
- Spróbuj wygenerować nowy token w BotFather i zaktualizować go w konfiguracji
- Upewnij się, że bot nie jest używany przez inne systemy
Możliwe przyczyny:
- Token bota jest nieprawidłowy
- Bot został usunięty z BotFather
- Problemy z automatyczną konfiguracją webhooka
Rozwiązanie:
- Sprawdź, czy bot nadal istnieje - wyszukaj go w Telegram
- Upewnij się, że token nie został zmieniony lub zresetowany
- Wejdź do konfiguracji chatbota i zapisz go ponownie, aby uruchomić ponowną konfigurację webhooka
- Jeśli problem się powtarza, usuń chatbota i utwórz go od nowa
Możliwe przyczyny:
- Niewystarczające lub nieprecyzyjne informacje o firmie
- Brak kontekstu dla specyficznych pytań branżowych
- Problemy z rozumieniem języka polskiego przez AI
Rozwiązanie:
- Rozszerz i doprecyzuj informacje o firmie w konfiguracji chatbota
- Dodaj więcej szczegółów o produktach, usługach i procesach firmowych
- Dodaj często zadawane pytania wraz z odpowiedziami do opisu firmy
- Stwórz dedykowane komendy dla najważniejszych informacji
- Monitoruj rozmowy i systematycznie poprawiaj konfigurację na podstawie rzeczywistych pytań użytkowników
Możliwe przyczyny:
- Komendy nie zostały poprawnie skonfigurowane na platformie
- Menu komend w BotFather nie zostało ustawione lub jest niezgodne
- Błędy w składni nazw komend
Rozwiązanie:
- Sprawdź konfigurację komend w panelu ChatbotAssistant
- Upewnij się, że nazwy komend zawierają tylko dozwolone znaki
- Zsynchronizuj menu komend w BotFather z komendami na platformie
- Przetestuj komendy, wpisując je ręcznie (np. /pomoc)
- Sprawdź, czy komendy mają poprawnie skonfigurowane odpowiedzi
Możliwe przyczyny:
- Wysokie obciążenie systemu AI
- Kompleksowe pytania wymagające dłuższego przetwarzania
- Osiągnięcie limitów rate limitingu
- Problemy z połączeniem sieciowym
Rozwiązanie:
- Sprawdź, czy nie osiągnąłeś limitów rate limitingu
- Poczekaj chwilę i spróbuj ponownie - czasowe opóźnienia są normalne
- Jeśli problem się powtarza, skontaktuj się z naszym wsparciem
- Rozważ optymalizację pytań - krótsze, bardziej konkretne pytania są szybciej przetwarzane
Możesz samodzielnie sprawdzić stan konfiguracji webhooka swojego bota:
Zamień TWÓJ_TOKEN_BOTA na rzeczywisty token swojego bota. Polecenie to zwróci informacje o aktualnej konfiguracji webhooka, w tym:
- URL webhooka
- Status połączenia
- Ostatnie błędy (jeśli wystąpiły)
- Liczbę oczekujących aktualizacji