Projekty i kanały
Jak utworzyć projekt, podłączyć bota i sprawdzić jego stan. Wiele kanałów, zmiana tokenu, wstrzymanie i przywracanie po zamrożeniu.
Na tej stronie
Projekt łączy ustawienia, reakcje i dane jednego bota lub usługi. Kanał łączy go z konkretnym miejscem rozmowy: botem Telegram, czatem na stronie albo innym komunikatorem. Na przykład szkoła może mieć jeden projekt z dwoma kanałami, Telegramem i stroną internetową.
Utwórz projekt w sekcji Projekty, a następnie dodaj kanał. Do Telegrama potrzebny będzie token od @BotFather, który pozwala zarządzać botem. Między projektami możesz przełączać się u góry panelu.
Bot nie ogranicza się do Telegrama: możesz podłączyć WhatsApp i VK i obsługiwać wszystkie komunikatory tymi samymi reakcjami. Przegląd znajdziesz w Kanałach, a instrukcję podłączenia w artykule WhatsApp.
Podłączanie bota
- Jeśli nie masz jeszcze projektu, otwórz Projekty i kliknij Dodaj projekt. W jego karcie kliknij Dodaj kanał i wybierz Telegram. Pierwszego bota możesz również podłączyć za pomocą kreatora przy pierwszym logowaniu.
- Wklej token od @BotFather i kliknij Sprawdź. GetMyBot pokaże znaleziony
@username, żeby można było sprawdzić, czy token należy do właściwego bota. - Kliknij Podłącz. Token jest przechowywany w postaci zaszyfrowanej, a odbieranie aktualizacji rozpoczyna się od razu.
Po podłączeniu Telegram pojawi się w karcie projektu obok innych kanałów. Karta pokazuje nazwę projektu, @username bota, liczbę użytkowników, aktywne reakcje i dzisiejsze zapytania. Saldo zapytań sprawdzisz w Abonamencie lub Statystykach.
Wiele botów
Jedno konto może prowadzić kilka projektów i botów jednocześnie. Ich liczba zależy od planu, w pozycji „maksymalna liczba botów”. Projekt zmienisz u góry panelu lub na stronie Projekty. Sekcje Reakcje, Czaty i Statystyki pokazują dane wybranego projektu.
Jak bot odbiera wiadomości
Po podłączeniu GetMyBot sam odbiera zdarzenia Telegrama: wiadomości, naciśnięcia przycisków, dołączenia do czatu i płatności. Nie musisz osobno konfigurować odbioru, wystarczy ważny token. Zależnie od ustawień serwera Telegram przesyła zdarzenia na adres platformy (webhook) albo platforma regularnie pobiera je z Telegrama (long polling).
Włączanie i wyłączanie
Każdy bot ma stan włączony lub wyłączony, ustawiany w karcie Stan bota w Ustawieniach. Wyłączony bot nie reaguje na wiadomości. Zmiana działa od razu, bez ponownego podłączania.
Stan projektu i dostępność kanału
Na liście Projekty projekt ma osobny stan: Aktywny, Wstrzymany albo Zamrożony. Nie jest to test dostarczania wiadomości Telegrama. Każdy kanał ma własną etykietę: Online, Brak sygnału, Skonfigurowany, Wyłączony lub Projekt nieaktywny. Dzięki temu aktywny projekt z czatem na stronie, ale bez Telegrama, nie wygląda na zatrzymany.
Jeśli aktywny projekt ma dokładnie jeden włączony kanał Telegram, etykieta Online oznacza świeży sygnał od obsługującego go procesu. Bez niego widać Brak sygnału. Przy kilku włączonych kanałach Telegram pojawia się Skonfigurowany: wspólnego sygnału projektu nie da się wiarygodnie przypisać do jednego kanału. W przypadku innych włączonych platform Skonfigurowany oznacza podłączony kanał, a nie gwarancję dostarczenia każdej wiadomości.
Platforma działa w kilku równorzędnych procesach. Każdy z nich co 30 sekund zgłasza, że obsługuje bota. Sygnał uważa się za świeży przez półtorej minuty, więc jeden pominięty sygnał nie powinien powodować migania statusu.
W praktyce:
- Etykieta pojawia się z opóźnieniem. Po podłączeniu lub ponownym uruchomieniu platformy Online może pojawić się dopiero w tym przedziale czasu.
- Jeśli Brak sygnału utrzymuje się dłużej niż parę minut przy włączonym Telegramie, sprawdź token i kartę Bot health w Ustawieniach. Projekt pozostaje aktywny, dopóki go nie wstrzymasz lub platforma nie zamrozi go z powodu planu.
- Sygnał jest wspólny dla procesów: nie zależy od serwera, który odpowiedział na Twoje żądanie. Przy kilku kanałach Telegram nie potwierdza działania każdego z osobna.
Co się dzieje, gdy bot jest offline
Co minutę platforma sprawdza sygnały. Jeśli włączony bot nie ma żadnego świeżego sygnału, otwiera incydent: ustala przyczynę i próbuje przywrócić działanie.
W karcie Bot health w Ustawieniach widać jedną z czterech przyczyn:
- webhook: Telegram nie dostarcza aktualizacji na adres platformy, więc platforma rejestruje webhook ponownie;
- token unieważniony:
getMezwraca 401. Taki incydent nie powoduje ponownych uruchomień: trzeba zmienić token w @BotFather i wprowadzić go przez Zmień token; - brak serwera obsługującego bota: nikt nie przetwarza aktualizacji, więc platforma ponownie uruchamia bota;
- nieustalona przyczyna: Telegram nie odpowiedział na sprawdzenie.
Ponowne uruchomienie robi to samo co przycisk Synchronizuj: sprawdza token przez getMe i ponownie rejestruje webhook. Kolejne próby następują po coraz dłuższych przerwach. Każda trafia do dziennika ponownych uruchomień incydentu wraz z czasem, wynikiem i ewentualnym błędem. W karcie widać też czas następnej próby.
Jeśli bot nie daje sygnału dłużej niż próg określony w karcie Bot health (domyślnie 5 minut), właściciel dostaje powiadomienie „Bot offline” w dzwonku panelu i przez email. Czaty wybrane jako odbiorcy powiadomień dostają wiadomość od bota. Na jeden incydent przypada jedno takie powiadomienie. Gdy sygnały wrócą, pojawi się „Bot znów online” z czasem przerwy. Historia incydentów, ich czas trwania i przyczyny pozostają w tej samej karcie.
Zamrożenie z powodu planu
Oprócz stanu włączony lub wyłączony bot może być zamrożony. Zamraża go platforma, gdy aktualny plan nie obejmuje już wszystkich podłączonych botów. Są dokładnie dwie przyczyny:
- przekroczony limit botów: zmieniono plan na taki, który dopuszcza mniej botów niż obecnie podłączonych;
- abonament nie został przedłużony: płatny plan się skończył i obowiązuje limit bezpłatnego.
Zamrożony bot nie odbiera wiadomości: odbiór aktualizacji jest wyłączany, nie tylko oznaczany etykietą. Dane, reakcje i subskrybenci pozostają nienaruszeni; zamrożenie można cofnąć.
Jak odmrozić bota. Aktywuj plan obejmujący potrzebną liczbę botów. Po aktywacji opłaconego planu platforma przywraca boty automatycznie, zaczynając od najstarszych, aż do osiągnięcia limitu. Nie można wybrać, które wrócą do pracy. Jeśli potrzebujesz innych, usuń najpierw zbędne podłączenia, a dopiero potem opłać plan.
Osobno może zostać zamrożone całe konto. Wtedy wszystkie boty i wysyłki są wstrzymane, a w panelu widać komunikat „Konto zamrożone”. Takie zamrożenie usuwa tylko pomoc techniczna. Zobacz Płatności i saldo.
Profil i synchronizacja
Przycisk Synchronizuj w Ustawieniach aktualizuje nazwę bota z Telegrama, jeśli zmieniono ją w @BotFather. Zdjęcie profilowe bota jest pobierane automatycznie.
Zmiana tokenu
Jeśli odświeżyłeś token w @BotFather (Bot Settings → Revoke / New token), zaktualizuj go w Ustawienia → Kanały → Telegram 🔑. Nowy token musi należeć do tego samego bota (zgodny wewnętrzny ID Telegram) — w ten sposób zachowane zostaną wszystkie reakcje, subskrybenci i dane. Jeśli kanał Telegram nie jest widoczny, wybierz «Zmień token» w tym samym oknie.
Przekazanie bota innemu kontu
Ustawienia → Zmień właściciela wysyła na adres email zaproszenie do przejęcia projektu przez inne konto GetMyBot. Zaproszenie jest ważne przez 72 godziny. Dopóki odbiorca go nie przyjmie, projekt pozostaje u Ciebie i możesz anulować przekazanie. Po przyjęciu zaproszenia zmienia się właściciel, a Ty tracisz dostęp do projektu. Użyj tej funkcji, gdy przekazujesz projekt klientowi lub współpracownikowi.
Szablony botów
Szablon zapisuje ustawienia bota i wszystkie jego reakcje jako kopię, którą można zastosować do innego bota:
- Utwórz szablon w Ustawieniach zapisuje obecnego bota jako nazwany szablon.
- Zastosuj szablon zastępuje ustawienia wybranego bota ustawieniami z szablonu i dodaje reakcje z szablonu do obecnych.
To sposób na powielenie typowego bota w kilku projektach.
Instalacja gotowego rozwiązania z katalogu
Do instalacji gotowych rozwiązań z katalogu służy kreator. Wprowadź parametry, sprawdź zgodność i wymagane połączenia, a następnie przejrzyj listę zasobów, które zostaną utworzone. Po instalacji wykonaj pozostałe kroki i przetestuj scenariusz na próbnej wiadomości.
Kreator różni się od zastosowania kopii bota opisanej wyżej. Kontrola przed instalacją wskazuje brakujące parametry lub funkcje. Oznaczenie kroku jako wykonanego nie potwierdza działania usługi zewnętrznej.
Wskaźniki gotowego rozwiązania
Wybierz okres, za który chcesz ocenić zainstalowane rozwiązanie. Do porównania wybierz dostępny tryb i sprawdź wielkość próby oraz dane diagnostyczne. Za mało danych lub brak porównania to coś innego niż wynik równy zeru.
Co dalej
- Ustawienia, zespół i dostęp: zachowanie bota, role, szablony i tokeny API.
- Reakcje: podstawy: zbuduj zachowanie bota.
- Import z sambot: przenieś gotowego bota.
- Płatności i saldo: plany i limit liczby botów.