Reakcje: podstawy

Reakcja to główny element bota: reguła opisująca kiedy zadziałać, przy jakich warunkach i co zrobić. Bot to uporządkowana lista reakcji; na każde przychodzące zdarzenie platforma przechodzi listę od góry do dołu i stosuje pierwszą pasującą reakcję. Sekcja dostępna w menu po lewej: Reakcje.

Z czego składa się reakcja

Reakcja ma cztery części (zakładki edytora):

  • Wyzwalacz — zdarzenie, na które reakcja odpowiada: tekst, komenda, media, kliknięcie przycisku, zdarzenie systemowe, harmonogram itd. Zob. Wyzwalacze.
  • W czatach — gdzie reakcja działa: czat prywatny, grupy przy odwołaniu do bota, konkretne czaty; plus filtry według stanu użytkownika.
  • Warunki — dodatkowe filtry (etykiety, parametry, czas, liczba wiadomości itd.). Zob. Warunki i czaty.
  • Akcje — co bot robi po wyzwoleniu: wysyła wiadomość, ustawia etykiety, zapisuje do kolekcji, wywołuje AI itd. Zob. Akcje.

Tworzenie i edytowanie

Kliknij Utwórz reakcję (lub otwórz istniejącą). W nagłówku edytora: nazwa (wymagana), numer #N, opis i przełącznik Aktywna. Po lewej — nawigacja po sekcjach Wyzwalacz / W czatach / Warunki / Akcje, w środku — formularz, po prawej — podgląd Telegram pokazujący, jak wiadomość będzie wyglądać z blokami, klawiaturą i menu. Zapisz przyciskiem Zapisz.

Dla zapisanej reakcji edytor wyświetla panel statystyk: liczbę wyzwoleń, wykres i ostatnie zdarzenia.

Kolejność i priorytet

Reakcje na liście można przeciągać — kolejność określa priorytet. Na zdarzenie wyzwala się pierwsza pasująca reakcja, po czym przeglądanie zostaje zatrzymane. Aby kontynuować przeglądanie i pozwolić zadziałać kolejnym pasującym reakcjom, dodaj akcję Następna reakcja (goto_next).

Włączanie i wyłączanie

Przełącznik w wierszu listy (lub Aktywna w edytorze) włącza i wyłącza reakcję bez jej usuwania. Wyłączone reakcje są pomijane podczas przeglądania.

Duplikowanie i usuwanie

W wierszu listy dostępne są przyciski Duplikuj (tworzy kopię) i Usuń. Duplikowanie jest przydatne, gdy trzeba utworzyć podobną reakcję z niewielkimi różnicami.

Import i eksport

Reakcję można wyeksportować do JSON (przycisk Eksportuj w edytorze) i zaimportować z powrotem (Importuj na liście). Pozwala to przenosić reakcje między botami i przechowywać wersje poza platformą.

Wysyłka masowa reakcji

Przycisk Wysyłka masowa w wierszu reakcji (ikona „wyślij") roześle tę reakcję do wszystkich aktywnych subskrybentów bota — przydatne do ogłoszeń i powiadomień. Grupę odbiorców można zawęzić za pomocą etykiet. Szczegóły — Wysyłki masowe.

Łańcuchy i dialogi

Z kilku reakcji można budować scenariusze:

  • Reakcja łańcuchowa (chain) — akcja, która uruchamia inną reakcję w trakcie wykonywania.
  • Następna reakcja (goto_next) — przekazuje sterowanie do następnej pasującej reakcji na liście.
  • Kroki dialogu — blok wiadomości może czekać na odpowiedź użytkownika (z weryfikacją formatu), wstrzymując scenariusz. Zob. Wiadomości i przyciski.
  • Gałąź „inaczej" — jeśli warunki reakcji nie zostały spełnione, można uruchomić inną reakcję (pole w sekcji „Warunki").

Co dalej