Динамические кнопки и параметры
Как показать товары кнопками, запомнить выбор человека и передать его следующей реакции. Примеры Carry, срока действия и постоянных параметров.
На этой странице
Бот показывает три товара с одинаковой кнопкой «Купить». Человек выбирает платье. Следующая реакция должна получить именно платье, даже если после него бот показывал другие товары.
Для этого нужны две настройки: динамические кнопки создают кнопки по списку товаров, а Carry запоминает, какой товар относится к каждой кнопке. Они находятся в блоке сообщения действия «Отправить сообщение».
| Что видит покупатель | Какие данные запоминает кнопка |
|---|---|
| Пальто, 12 000 ₽ · Купить | product_id=101, price=12000 |
| Платье, 8 000 ₽ · Купить | product_id=102, price=8000 |
| Кроссовки, 6 000 ₽ · Купить | product_id=103, price=6000 |
Нажатие второй кнопки передаст сценарию product_id=102. Боту не придётся определять товар по надписи «Купить».
Динамические кнопки из списка
Вместо добавления каждого товара вручную получите список из коллекции или внешнего сервиса. Блок «Динамические кнопки из списка» создаст по кнопке на каждый элемент. Список хранится во временных данных реакции, которые в настройках называются контекстом (ctx). Настройте четыре поля:
| Поле | Что указать | Что получится |
|---|---|---|
Список (over) | ctx.products | Бот возьмёт товары из временных данных. Список заранее готовят «Запрос к источнику», «Веб-запрос» или «Вычисление» |
Псевдоним элемента (as) | item, значение по умолчанию | {{item.name}} означает название одного товара из списка |
Кнопок в ряд (columns) | 1, значение по умолчанию | Каждый товар будет на отдельной строке |
| Шаблон кнопки | {{item.name}} · {{item.price}} ₽ | Для каждого товара бот подставит его название и цену в текст и другие поля кнопки |
При отправке бот подставит данные каждого товара в шаблон. Из списка с тремя товарами получатся три кнопки. Тем же способом можно показать свободные занятия, заказы или пункты меню.
Пример
В ctx.products лежит список товаров с полями id, name, price.
- Укажите список
ctx.products, псевдонимitemи одну кнопку в ряд. - В тексте шаблона напишите
{{item.name}} · {{item.price}} ₽. - Выберите тип кнопки «Вызов реакции» и реакцию оформления заказа.
- В Carry добавьте ключ
product_idсо значением{{item.id}}. - В реакции оформления используйте
{{ctx.product_id}}, чтобы получить выбранный товар.
Нажмите вторую кнопку, затем первую. Каждый раз реакция должна получать ID нажатого товара.
Параметры в нажатии (Carry)
Carry означает «данные, которые кнопка передаст при нажатии». Представьте бирку на товаре: у каждой кнопки своя бирка, даже если все кнопки называются «Купить» и запускают одну реакцию.
В редакторе настройка называется «Данные при нажатии». Значения запоминаются при отправке сообщения. При нажатии бот читает их и помещает в ctx, временные данные нового запуска реакции.
- Ключ: имя сохранённого значения. Для ключа
product_idчитайте результат как{{ctx.product_id}}. - Значение: что запомнить. Можно написать число или подстановку:
{{item.id}},{{param.order_id}},{{ctx.x}}. Подстановка вычисляется при отправке сообщения. - Одноразовая (
single_use): после первого нажатия сохранённые данные удаляются. Повторно использовать их нельзя. - Срок действия данных кнопки (
ttl_seconds, также называется TTL): сколько секунд хранить данные. Например,3600означает один час.0выбирает срок по умолчанию, сейчас это 30 дней; это не бессрочное хранение.
После истечения срока прежние данные недоступны. Дайте человеку возможность заново открыть каталог. У каждой отправленной кнопки свой набор значений, даже если её текст и целевая реакция совпадают с другими. В технических описаниях это свойство называется per-invocation.
Установка параметров кнопкой (set_params)
Иногда выбор нужно помнить и после завершения реакции. Например, человек выбрал город доставки, и бот должен использовать его при следующем заказе. Для этого у кнопки есть поле «Параметры» (set_params): оно сохраняет значение в карточку подписчика при нажатии. Дальше город доступен как {{param.city}}.
Carry передаёт временные значения в текущий запуск ({{ctx.ключ}}), а set_params сохраняет их между запусками ({{param.ключ}}). Поле set_params есть и у блока сообщения, но там значение записывается уже при отправке, даже если человек ничего не нажал.
Кнопка при нажатии также может ставить и снимать метки: теми же полями, что и блок сообщения.
Чем отличаются три механизма
| Что нужно сделать | Что выбрать | Где прочитать результат |
|---|---|---|
| Передать выбранный товар следующей реакции | Carry | {{ctx.product_id}} |
| Запомнить город после выбора человека | set_params на кнопке | {{param.city}} |
| Сохранить значение сразу при отправке сообщения | set_params на блоке | {{param.ключ}} |
Что дальше
- Сообщения и кнопки: блоки сообщения, типы кнопок и поведение при нажатии.
- Подстановки и формулы: переменные
{{item.*}},{{ctx.*}},{{param.*}}в шаблонах. - Связи реакций: куда ведут кнопки и как увидеть граф переходов.
- Коллекции и данные: откуда брать списки для динамических кнопок.