Reakcje: podstawy
Jak nauczyć bota odpowiadać na komendę, kliknięcie przycisku lub inne zdarzenie. Tworzenie reakcji, kolejność sprawdzania i przejścia między reakcjami.
Na tej stronie
Reakcja określa jedną regułę działania bota. Na przykład: „Gdy ktoś napisze /price, wyślij cennik” albo „Po opłaceniu zamówienia nadaj etykietę «Zapłacił» i przyznaj dostęp”.
Zdarzenie, dodatkowe warunki i działania ustawisz w sekcji Reakcje. Bot sprawdza reguły od góry listy i wykonuje pierwszą pasującą. Dlatego reguły szczegółowe zwykle umieszcza się nad ogólną odpowiedzią na każdą wiadomość.
Z czego składa się reakcja
Aby wysłać cennik, wystarczy wybrać komendę /price i dodać wiadomość z cenami. Pozostałe ustawienia są potrzebne, gdy reguła ma działać tylko dla określonych osób lub czatów. Edytor ma cztery zakładki:
| Zakładka | Na jakie pytanie odpowiada | Przykład |
|---|---|---|
| Wyzwalacz | Kiedy uruchomić: tekst, komenda, plik, przycisk, zdarzenie lub harmonogram | Ktoś napisał /price |
| W czatach | Gdzie działa reakcja: rozmowa prywatna, wzmianka w grupie, wybrane czaty; uwzględnia stan użytkownika | Tylko w rozmowie prywatnej |
| Warunki | Co dodatkowo sprawdzić: etykiety, parametry, czas, liczba wiadomości | Osoba ma etykietę „Zapłacił” |
| Akcje | Co zrobić: wysłać wiadomość, zmienić etykiety, zapisać dane, wywołać AI | Wysłać cennik |
Tworzenie i edycja
Kliknij Utwórz reakcję albo otwórz już istniejącą. U góry edytora ustaw wymaganą nazwę, numer #N, opis i przełącznik Aktywna. Po lewej wybierasz Wyzwalacz / W czatach / Warunki / Akcje, w środku wypełniasz formularz. Po prawej widać podgląd wiadomości w Telegramie wraz z blokami, przyciskami i menu. Kliknij Zapisz.
Dla zapisanej reakcji edytor pokazuje statystyki: liczbę uruchomień, wykres i ostatnie zdarzenia.
Historia zmian i przywracanie
W zapisanej reakcji otwórz Change history (historię zmian). Zobaczysz 20 ostatnich zmian, czas, autora, źródło edycji oraz różnice „Before / After”. Możesz przywrócić stan sprzed wybranej zmiany: najpierw obejrzyj różnice, potem potwierdź przywrócenie.
Przywrócenie zastępuje niezapisane zmiany i samo trafia do historii. Odtwarza ustawienia reakcji, ale nie cofa wysłanych wiadomości ani zmian danych. Jeśli w międzyczasie inna osoba edytowała reakcję, odśwież widok różnic.
Instrukcja krok po kroku i ćwiczenie.
Kolejność i priorytet
Na liście możesz przeciągać reakcje w kolejności ręcznej, gdy wyszukiwanie i filtry są wyłączone i nie wybrano folderu. Kolejność określa priorytet: dla jednego zdarzenia uruchamia się pierwsza pasująca reakcja, a dalsze sprawdzanie się kończy. Aby kontynuować sprawdzanie i uruchomić kolejne pasujące reakcje, dodaj akcję Następna reakcja (goto_next).
Wyszukiwanie, filtry i grupowanie
Nad listą jest wyszukiwarka po nazwie i numerze oraz filtry:
- Stan: wszystkie, tylko aktywne albo tylko nieaktywne reakcje.
- Utworzono od / do: dni kalendarzowe w Twojej strefie czasowej, oba końce przedziału włącznie.
- Kolejność: ręczna (tak sprawdza bot), od najnowszych albo od najstarszych.
- Grupowanie: według dni lub miesięcy utworzenia. Działa tylko przy sortowaniu według daty. Jeśli włączysz grupowanie przy kolejności ręcznej, lista przełączy się na Najpierw najnowsze. Wybrane wcześniej sortowanie według daty pozostanie bez zmian. Powrót do kolejności ręcznej wyłącza grupowanie.
Filtry obejmują wszystkie reakcje, nie tylko aktualną stronę listy, i można je łączyć z wyszukiwaniem i folderami. Licznik pokazuje, ile reakcji znaleziono. Ustawienia filtrów zapisują się w adresie strony: możesz odświeżyć stronę, udostępnić link albo wrócić do wyników przyciskiem „Wstecz”. Wyczyść filtry usuwa wyszukiwanie, filtry, sortowanie i grupowanie, ale pozostawia wybrany folder.
Filtry i sortowanie zmieniają tylko widok listy. Nie zmieniają kolejności, w której bot sprawdza reakcje.
Włączanie i wyłączanie
Przełącznik w wierszu listy albo Aktywna w edytorze włącza i wyłącza reakcję bez jej usuwania. Bot pomija wyłączone reakcje.
Duplikowanie i usuwanie
W wierszu listy znajdziesz Duplikuj (tworzy kopię) i Usuń. Duplikowanie ułatwia utworzenie podobnej reakcji z kilkoma zmianami.
Import i eksport
Reakcję można pobrać jako JSON przyciskiem Eksport w edytorze i wczytać przez Import na liście. Dzięki temu przeniesiesz ją między botami albo zachowasz wersje poza platformą.
Wysyłka reakcji
Przycisk Wyślij… w wierszu reakcji, z ikoną wysyłania, uruchamia ją dla wszystkich aktywnych subskrybentów bota. Możesz zawęzić grupę odbiorców według etykiet. Zobacz Wysyłki.
Łańcuchy i dialogi
Na przykład pierwsza reakcja pokazuje katalog, przycisk uruchamia drugą z kartą produktu, a ta pyta o adres dostawy. Przejścia między reakcjami można ustawić na kilka sposobów:
- Reakcja łańcuchowa (
chain): akcja uruchamiająca inną reakcję podczas wykonywania obecnej. - Następna reakcja (
goto_next): przekazuje sterowanie kolejnej pasującej reakcji na liście. - Kroki dialogu: blok wiadomości może czekać na odpowiedź użytkownika i sprawdzać jej format, wstrzymując scenariusz. Zobacz Wiadomości i przyciski.
- Gałąź „w przeciwnym razie”: jeśli warunki reakcji nie są spełnione, można uruchomić inną reakcję w ustawieniach Warunki.
- Wybierz następny krok (
branch_result): obsłuż pusty, pojedynczy, wieloelementowy lub niepełny wynik wyszukiwania. - Wybierz krok według wartości (
branch_value): na przykład przyupdatedpotwierdź zgłoszenie, a przyconflictpoproś o ponowne odczytanie jego stanu. - Wynik akcji: przejdź do osobnej reakcji po sukcesie, konflikcie, braku rekordu lub błędzie, jeśli akcja udostępnia taki wynik. Zobacz Jak wybierać gałęzie.
- Wywołaj blok (
call_block): przekaż dane wejściowe do wspólnych obliczeń i odbierz określone dane wyjściowe w bieżącej reakcji. Zobacz Biblioteka bloków i wersje.
W pracy z danymi możesz połączyć Przeszukaj kolekcję → Wybierz następny krok → przyciski → Znajdź powiązane rekordy. Dla listy z usługi zewnętrznej użyj Przetwórz listę → Grupy i podsumowania. Nadaj wynikowi każdej akcji nazwę, a następnie wybierz go w kolejnej akcji.
Ćwiczenia z nowymi akcjami pokazują oba łańcuchy na przykładach zajęć i zgłoszeń.
Podczas konfiguracji wybieraj dane z poprzednich kroków, zamiast zapamiętywać ścieżki ręcznie. Przed zapisaniem sprawdź bieżący szkic na danych przykładowych: porównaj gałęzie i planowane wiadomości. Po zapisaniu osobno przejdź ścieżkę użytkownika przez podłączonego bota i kanał, gdzie akcje zostaną naprawdę wykonane.
Co dalej
- Wyzwalacze: wszystkie sposoby uruchamiania.
- Warunki i czaty: filtry i zakres działania.
- Akcje: pełna lista akcji.
- Wiadomości i przyciski: tworzenie odpowiedzi.