Блоки в конструкторе
Что это
Для автоматизации продаж в визуальном конструкторе сценариев предусмотрены специализированные блоки и действия. С их помощью вы можете собирать витрины, корзины покупок, проверять наличие на складе, создавать заказы, принимать платежи и подключать ИИ-консультантов.
Основные блоки для e-commerce
| Блок | Назначение |
|---|---|
База данных (database) |
Программное чтение и запись товаров каталога, создание и редактирование заказов, добавление позиций в корзину |
ИИ-диалог (ai_dialog) |
Интеллектуальный поиск товаров, консультация по характеристикам, продажа через свободный диалог |
Платежи (payment) |
Выставление счета на оплату через Telegram Payments, ЮKassa, Robokassa, Stripe и др. |
Сбор данных (input / form) |
Запрос контактного телефона, имени и адреса доставки покупателя |
Условие (condition) |
Проверка остатка товара, валидация минимальной суммы заказа или проверка статуса оплаты |
Блок «База данных»: действия для товаров и заказов
В блоке «База данных» выберите источник данных: Товары или Заказы.
1. Действия с товарами
- Получить товар: загружает все свойства товара по его ID в переменную (по умолчанию
shop).- Доступна кнопка «Тест»: мгновенный просмотр реальных данных товара и автоматическое сохранение свойств (
{{shop.name}},{{shop.price}},{{shop.image}}и др.) в подсказки переменных. - Все ссылки на изображения и видео возвращаются в виде абсолютных URL (
https://...).
- Доступна кнопка «Тест»: мгновенный просмотр реальных данных товара и автоматическое сохранение свойств (
- Получить товары: возвращает список всех активных товаров бота.
- Получить товары по категории: фильтрует каталог по ID категории.
- Создать товар: программное добавление товара в каталог прямо из сценария.
Свойства товара в переменных:
{{shop.id}}— ID товара{{shop.name}}— Наименование{{shop.price}}— Актуальная цена{{shop.old_price}}— Старая цена (до скидки){{shop.amount}}— Остаток на складе{{shop.description}}— Описание{{shop.image}}— Абсолютная ссылка на фото{{shop.video}}— Абсолютная ссылка на видео{{shop.video_thumb}}— Ссылка на обложку видео{{shop.sku}}— Артикул
2. Действия с заказами (order)
Все действия с заказами работают напрямую с таблицей заказов и связанными позициями:
| Действие | Описание |
|---|---|
| Получить заказ по ID | Загружает заказ с полным массивом позиций goods в переменную order. Доступна кнопка «Тест» для отладки структуры |
| Получить заказы пользователя | Загружает историю заказов покупателя по его ID пользователя ({{USER_ID}}) с умным fallback на Telegram chat_id. Включает кнопку «Тест» |
| Создать заказ | Создает новый заказ со статусом «Новый», автоматически заполняет позиции в базе, рассчитывает налоги, скидки и итоговую сумму summa |
| Обновить заказ | Обновляет поля заказа и при необходимости перезаписывает состав позиций |
| Добавить товар в заказ | Добавляет товар в корзину заказа. Если позиция уже есть, суммирует количество и автоматически пересчитывает сумму заказа |
| Удалить товар из заказа | Удаляет позицию по ID товара или ID строки и пересчитывает итоговую сумму |
| Изменить количество товара в заказе | Задает новое количество. При qty <= 0 позиция автоматически удаляется |
| Удалить заказ | Полностью удаляет заказ и все связанные с ним позиции |
Обращение к позициям заказа в переменных:
{{order.id}}— Номер заказа{{order.summa}}— Общая сумма к оплате{{order.status}}— Статус заказа{{order.goods.0.product_name}}— Название первой позиции{{order.goods.0.price}}— Цена единицы товара{{order.goods.0.quantity}}— Количество{{order.goods.0.summa}}— Сумма по позиции{{order.goods.0.product_image}}— Прямой URL на фото товара
Кнопки «Тест» для быстрой разработки
В каждом действии получения данных встроена кнопка «Тест»:
- Нажмите «Тест» прямо во время сборки сценария.
- Система выполнит тестовый запрос к реальной базе бота (с умным fallback на последнюю существующую запись, если ID еще не передан).
- Результат запроса отобразится в окне предпросмотра.
- Все доступные поля автоматически сохранятся в список автодополнения переменных конструктора.
Связка с ИИ-диалогом
Чтобы сделать умного консультанта по каталогу:
- Добавьте блок «ИИ-диалог».
- В системном промпте укажите роль продавца-консультанта.
- Передайте список товаров или подключите поиск по каталогу.
- При согласии клиента на покупку ИИ формирует параметры и передает управление блоку «База данных → Добавить заказ», после чего клиенту выставляется ссылка на оплату.