База знань GetMyBot

Реакції: основи

Як навчити бота відповідати на команду, натискання кнопки чи іншу подію. Створення реакцій, порядок перевірки та переходи між ними.

На цій сторінці

Реакція задає одне правило поведінки бота. Наприклад: «Коли людина напише /price, надіслати прайс» або «Після оплати замовлення додати мітку “Оплатив” і надати доступ».

Налаштуйте подію, додаткові умови й дії в розділі Реакції. Бот перевіряє правила згори донизу та виконує перше відповідне. Тому конкретні правила зазвичай розміщують вище за загальну відповідь на будь-яке повідомлення.

З чого складається реакція

Щоб надіслати прайс, досить вибрати команду /price і додати повідомлення з цінами. Інші налаштування потрібні, якщо правило має працювати лише для певних людей або чатів. У редакторі є чотири вкладки:

ВкладкаНа яке запитання відповідаєПриклад
ТригерКоли запускати: текст, команда, медіа, кнопка, подія чи розкладЛюдина написала /price
У чатахДе діє реакція: особисте листування, звернення в групі, певні чати; враховує стан користувачаЛише в особистому чаті
УмовиЩо додатково перевірити: мітки, параметри, час, кількість повідомленьЛюдина має мітку «Оплатив»
ДіїЩо зробити: надіслати повідомлення, змінити мітки, записати дані, викликати ШІНадіслати прайс

Створення та редагування

Натисніть Створити реакцію або відкрийте наявну. Угорі редактора вкажіть обов’язкову назву, номер #N, опис і перемикач Активна. Ліворуч вибирають Тригер / У чатах / Умови / Дії, посередині заповнюють форму. Праворуч показано попередній перегляд повідомлення в Telegram із блоками, кнопками та меню. Натисніть Зберегти.

Для збереженої реакції редактор показує статистику: кількість спрацьовувань, графік і останні події.

Історія змін і відновлення

Для збереженої реакції відкрийте Change history (історію змін). Там видно останні 20 змін, час, автора, джерело правки й відмінності «Before / After». Можна повернути стан до вибраної зміни: спочатку перегляньте відмінності, потім підтвердьте відновлення.

Відновлення замінює незбережені правки й саме записується в історію. Воно повертає налаштування реакції, але не скасовує вже надіслані повідомлення чи зміни даних. Якщо під час перегляду інший учасник змінив реакцію, оновіть порівняння.

Покроковий розбір і вправа.

Порядок і пріоритет

У списку реакції можна перетягувати в ручному порядку, коли пошук і фільтри вимкнені та не вибрано папку. Порядок визначає пріоритет: для однієї події виконується перша відповідна реакція, після чого перевірка припиняється. Щоб продовжити перевірку й запустити наступні відповідні реакції, додайте дію Наступна реакція (goto_next).

Пошук, фільтри та групування

Над списком є пошук за назвою й номером та фільтри:

  • Стан: усі, лише активні або лише неактивні реакції.
  • Створено від / до: календарні дні у вашому часовому поясі, обидві дати включно.
  • Порядок: ручний (саме так перевіряє бот), спочатку нові або спочатку старі.
  • Групування: за днями чи місяцями створення. Працює лише за сортуванням за датою. Якщо ввімкнути групування за ручного порядку, список перемкнеться на «Спочатку нові». Уже вибраний порядок за датою збережеться. Повернення до ручного порядку вимикає групування.

Фільтри застосовуються до всіх реакцій, а не лише до відкритої сторінки, і поєднуються з пошуком та папками. Лічильник показує кількість знайдених реакцій. Налаштування фільтрів зберігаються в адресі сторінки: її можна оновити, надіслати посилання або повернутися кнопкою «Назад». Скинути фільтри очищає пошук, фільтри, порядок і групування, але залишає вибрану папку.

Фільтри й сортування змінюють лише вигляд списку. Порядок перевірки реакцій ботом залишається тим самим.

Увімкнення та вимкнення

Перемикач у рядку списку або Активна в редакторі вмикає та вимикає реакцію, не видаляючи її. Вимкнені реакції бот пропускає.

Дублювання та видалення

У рядку списку є кнопки Дублювати (створює копію) і Видалити. Дублювання зручне, коли потрібна схожа реакція з невеликими відмінностями.

Імпорт та експорт

Реакцію можна завантажити у форматі JSON кнопкою Експорт у редакторі й завантажити назад через Імпорт у списку. Це дає змогу переносити її між ботами та зберігати версії поза платформою.

Розсилка реакції

Кнопка Надіслати… в рядку реакції, з іконкою надсилання, запускає її для всіх активних підписників бота. Аудиторію можна обмежити за мітками. Докладніше: Розсилки.

Ланцюжки та діалоги

Наприклад, перша реакція показує каталог, кнопка запускає другу з карткою товару, а та запитує адресу доставки. Переходи між реакціями можна налаштувати кількома способами:

  • Ланцюгова реакція (chain): дія запускає іншу реакцію під час виконання поточної.
  • Наступна реакція (goto_next): передає керування наступній відповідній реакції зі списку.
  • Кроки діалогу: блок повідомлення може чекати на відповідь користувача та перевіряти її формат, призупиняючи сценарій. Див. Повідомлення та кнопки.
  • Гілка «інакше»: якщо умови реакції не виконалися, можна запустити іншу реакцію в налаштуваннях Умови.
  • Вибрати наступний крок (branch_result): обробити порожній, одиничний, множинний або неповний результат пошуку.
  • Вибрати крок за значенням (branch_value): наприклад, за updated підтвердити заявку, а за conflict запропонувати перечитати її стан.
  • Результат дії: перейти до окремої реакції після успіху, конфлікту, відсутності запису або помилки, якщо дія підтримує такий результат. Див. Як вибирати гілки.
  • Call block (викликати блок) (call_block): передати вхідні дані до спільного обчислення й отримати визначені вихідні дані в поточній реакції. Див. Бібліотека блоків і версії.

Для роботи з даними можна скласти ланцюжок Пошук у колекції → Вибрати наступний крок → кнопки → Знайти пов’язані записи. Якщо список надійшов із зовнішнього сервісу, використовуйте Обробити список → Групи та підсумки. Задайте назву результату кожної дії, а потім виберіть її в наступній.

Практичні уроки з нових дій показують обидва ланцюжки на прикладах занять і заявок.

Під час налаштування вибирайте дані попередніх кроків, щоб не запам’ятовувати шляхи вручну. Перед збереженням перевірте поточну чернетку на навчальних даних: порівняйте гілки та заплановані повідомлення. Після збереження окремо пройдіть шлях користувача через підключеного бота й канал, де дії виконуються насправді.

Що далі