Повідомлення та кнопки

Дія «Надіслати повідомлення» збирає відповідь бота з блоків і постачає її inline-кнопками, головним меню та кроками діалогу. Це найбагатша дія конструктора — тут же підключаються підстановки і реферальні параметри кнопок.

Блоки повідомлення

Повідомлення — це послідовність блоків (кнопка Додати блок):

  • Текст — форматований текст (до 4096 символів) з підстановками та кнопками.
  • Фото — зображення з підписом.
  • Файл — документ з підписом.
  • Затримка — пауза в секундах перед наступним блоком.
  • ШІ — відповідь, згенерована моделлю за промптом.
  • Реакція — виклик іншої реакції (опціонально з очікуванням її обробки).

Блоки перетягуються. Режим показу блоків — «По порядку» або «Випадково» (для варіативних відповідей). Головне меню бота можна залишити без змін, задати нове або приховати.

Опції блоку

У текстових і медіа-блоках є прапорці: закріпити, без звуку, захист від пересилання, спойлер, без прев'ю посилань, автовидалення через N секунд.

Inline-кнопки

У блоці налаштовуються кнопки (Текст кнопки + Тип):

  • Текст (callback) — кнопка з обробкою натискання на стороні бота.
  • Посилання — відкриває URL.
  • Вебзастосунок — відкриває Telegram Mini App. Див. Mini App.
  • Виклик реакції — натискання запускає іншу реакцію.
  • Приймання платежу та Сповіщення — позначені як «незабаром».

Стиль кнопки — звичайний, синій (Primary), зелений (Success) або червоний (Danger). Прапорець «Одноразова» спалює кнопку після натискання.

Поведінка при натисканні

Для callback-кнопок налаштовується, що відбувається при натисканні: замінити текст кнопки, замінити повідомлення (текстом або вмістом прив'язаної реакції), видалити повідомлення, пропустити answerCallbackQuery. Натискання також може ставити мітки та задавати параметри.

Параметри в кнопці (Carry)

Блок «Carry — знімок даних у натискання кнопки» прикріплює до кнопки набір значень, зафіксованих у момент відправки. При натисканні ці значення потрапляють у контекст — так кожна кнопка несе свої параметри (per-invocation), навіть якщо кнопок багато. Задається час життя payload у секундах. Це основа сценаріїв «обери товар → оформи саме його».

Динамічні кнопки

Блок «Динамічні кнопки зі списку» розгортає масив із ctx у кнопки — по одній на елемент. Налаштовуються: ключ списку в ctx, псевдонім елемента, кількість кнопок у ряд і шаблон кнопки (підтримує {{alias.поле}}). Так будуються каталоги, списки записів і меню з даних колекції. Докладніше — Динамічні кнопки та параметри.

Очікувана відповідь (кроки діалогу)

Текстовий блок може чекати відповідь користувача — це перетворює повідомлення на крок діалогу і ставить сценарій на паузу до відповіді. Кілька кроків підряд утворюють анкету або майстер прямо в чаті.

Тип очікуваного вмісту

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

Перевірка тексту

Для текстової відповіді можна ввімкнути перевірку формату: телефон, e-mail, посилання, дата, час або відповідність формулі (регулярний вираз). Відповідь, що не пройшла перевірку, відхиляється, і бот показує повідомлення про помилку.

Збереження відповіді

Відповідь користувача можна зберегти в параметр — після чого вона доступна в підстановках як {{param.ключ}} і в умовах. Так кроки діалогу наповнюють міні-профіль клієнта.

Помилки, нагадування та таймаут

  • Повідомлення при помилці перевірки — що показати, якщо відповідь не пройшла валідацію.
  • Нагадування — що надіслати, якщо користувач мовчить.
  • Знімання очікування за таймаутом — через скільки перестати чекати; при таймауті можна запустити реакцію (наприклад, м'яко завершити анкету). Ця реакція видна в зв'язках як «Таймаут очікування», а реакція на саму відповідь — як «Очікувана відповідь».

Підстановки

Кнопка «Підстановки» вставляє змінні: дані відправника ({{first_name}}, {{username}}, {{user_id}}), події ({{text}}, {{chat_id}}, {{datetime}}) і параметри ({{param.ключ}}). Повний список і формули — Підстановки та формули.

Що далі