Змінні й токени
Змінна — це значення, яке бот запам'ятовує під іменем і потім використовує в розмові.
Види змінних
Назва змінної починається з префікса, який каже, кому вона належить і як довго живе.
| Змінна | Що це |
|---|---|
user.* |
Належать кожному відвідувачу окремо і зберігаються назавжди. Коли людина відповідає на питання, натискає кнопку або проходить ланку, ці значення змінюються тільки в неї. |
session.* |
Живуть, поки триває розмова. Сюди скрипти кладуть проміжні результати: суму кошика, вибраний день. |
app.* |
Спільні для всіх відвідувачів. Це може бути каталог товарів, розклад або лічильник замовлень. Їх бачать усі ланки і всі відвідувачі. |
platform.* |
Дані Telegram про людину і повідомлення, яке зараз обробляється: ім'я, мова, текст. Їх можна лише читати. |
initiator.* |
У ланці, яку запустило «Сповіщення» чи «Анонс», — людина, яка його спричинила. |
Скрипти мають ще один вид змінних, temp.*. Про нього розповідає сторінка Скрипти.
Де працюють змінні
- У повідомленнях вони підставляються через токени.
- В умовах бот перевіряє їхні значення і вирішує, яку гілку розмови показати людині.
- У скриптах їх можна читати й змінювати.
- У фільтрах аудиторій за ними відбираються відвідувачі для розсилок.
Відповіді людини кроки зберігають самі: «Задати питання» та інші кроки «Запитати…» / «Попросити…», «Опитування», «Набір кнопок» і «Web App» записують вибране у змінну user.*, яку ви вкажете.
У полі «Зберегти в» можна розгорнути змінну-об'єкт і вибрати ключ усередині неї, наприклад access.note. Тоді відповідь запишеться в цей ключ, а решта ключів об'єкта залишиться як була. Новий ключ можна вписати в пошук: user.access.note.
Токени
Токен — це чип із назвою змінної, який ви вставляєте в текст. Відвідувач бачить замість нього значення.
Щоб вставити токен, наберіть «/» у тексті або натисніть значок токена на панелі над текстом повідомлення і виберіть змінну. Список поділено за видами змінних, а пошук знаходить змінну за назвою. Якщо такої змінної ще немає, її можна створити просто звідти: натисніть «+» у рядку user чи app, допишіть назву й задайте початкове значення.
- Токени працюють у тексті повідомлень, у тексті кнопок і в адресах посилань і картинок.
- Токен показує значення як є, без обчислень і форматування. Щоб показати суму чи дату в потрібному вигляді, порахуйте її заздалегідь у скрипті.
- Якщо змінна порожня, на місці токена нічого не буде.
Сторінка «Змінні»
Сторінка «Змінні» відкривається пунктом «Дані» в меню бота. На ній ви задаєте стартові значення: те, з чим починає кожен новий відвідувач, і спільні дані бота. Поточні значення конкретної людини можна побачити на її сторінці в розділі «Відвідувачі».