Параметри ноди «Повідомлення з кнопками»
Нода Повідомлення з кнопками (MessageKeyboard, send-message-keyboard) відправляє повідомлення з текстом та кнопками клієнту. Після відправки сценарій очікує відповідь (натискання кнопки або текст). Типово використовується для меню вибору, запиту категорії звернення, переходу до різних гілок діалогу. У Node Inspector (панель справа) доступні такі секції:
Основні налаштування
- Текст повідомлення — текст, який побачить клієнт перед кнопками.
- Змінна для збереження (Output Variable) — куди записати відповідь клієнта (натискання кнопки або введений текст).
Вкладення (Attachments)
- Тип вкладення — зображення, відео, файл.
- Джерело — Файл (завантаження з комп'ютера) або Посилання (введення URL).
- Значення — шлях до завантаженого файлу або URL медіа.
Вкладення відображаються разом із текстом повідомлення.
Месенджери (Messengers)
- Підтримувані канали — обмеження, на яких месенджерах показувати це повідомлення (Telegram, Viber, WhatsApp, Widget, Facebook тощо).
- Якщо список порожній — повідомлення показується на всіх каналах.
Кнопки (Buttons)
- Тип клавіатури — inline (під повідомленням) або reply (звичайна клавіатура).
- Список кнопок — текст кнопки, значення (payload), тип (callback, url, phone).
- Кожна кнопка може вести до окремої гілки сценарію (edge з підписом значення).
- Для досвідчених інтеграторів: у кожної кнопки є JSON-поля (
jsonFields) для додаткових параметрів месенджерів.
Валідація (Validation)
Перевірка введення клієнта (якщо він пише текст замість натискання кнопки):
- Тип — none (без перевірки), email, phone, integer (ціле число), image, regexp, custom.
- Повідомлення про помилку — текст, який побачить клієнт при невалідному вводі.
- Обмеження — min/max символи, min/max значення (для integer).
- Regexp / Custom — власний regex-патерн.
Якщо type: none — бот приймає будь-яку відповідь без перевірки.
Додаткові налаштування (Advanced)
- Показувати індикатор набору (sendTyping) — показувати «друкує…» перед повідомленням.
- Затримка відправки (slowMode) — затримка перед відправкою повідомлення. При увімкненні доступне поле Секунд затримки (1–60).
- Дозволити переривання (allowInterrupt) — клієнт може надіслати повідомлення до завершення відправки.
- Зберегти в Custom Data — запис відповіді в модуль Custom Data (модель та поле).
- Статистика — вибір воронки та позиції для відстеження виконання ноди.
- Facebook Ads — генератор JSON для інтеграції з Facebook Ads (для досвідчених інтеграторів).
JSON-дані
Для досвідчених інтеграторів — ручне редагування jsonData та messageJsonData для специфічних налаштувань месенджерів.