Перейти к содержанию

События магазина MiniApp

Обработка событий Телеграм бота, которые произошли в MiniApp магазине

Создание обработчика событий MiniApp

Информация

Прежде чем перейти к созданию обработчика события, сначала создайте новый сценарий, который будет запускаться по этому событию.

Чтобы настроить отслеживание события MiniApp, перейдите в раздел "События мессенджеров и приложений", откройте вкладку MiniApp.

miniapp события

Вкладка Mini App

Нажмите на кнопку «Создать» и выберите нужное событие. Подробнее обо всех событиях — см. раздел Список событий Mini App

мини-приложения события

Выбор события

В форме создания события заполните название, выберите сценарий и активируйте событие.

miniapps в телеграм

Страница настроек обработчика событий

Список событий MiniApp

Название событияОписание событияДоступные в сценарии переменные
Запуск магазина по кнопкеПользователь запустил магазин по кнопке-
Запуск магазина по ссылкеПользователь запустил магазин по ссылке-
Переход на страницу оформления заказаПользователь перешел на страницу оформления заказа

  • miniapp_cart_json – JOSN переменная, со списком товаров корзины
  • miniapp_cart_text – содержимое корзины в текстовом формате
  • miniapp_products_quantity – общее количество всех товаров
  • miniapp_cart_price – общая стоимость всех товаров в валюте магазина
  • miniapp_currency – валюта
Создание заказа (заказ оформлен)Пользователь оформил заказ

  • miniapp_cart_json – JOSN переменная, со списком товаров корзины
  • miniapp_order_number – переменная с номером заказа
  • miniapp_cart_text – содержимое корзины в текстовом формате
  • miniapp_products_quantity – общее количество всех товаров
  • miniapp_cart_price – общая стоимость всех товаров в валюте магазина
  • miniapp_currency – валюта
  • miniapp_payment_method – способ оплаты:

    • CASH_PAYMENT – наличные,
    • NLINE_PAYMENT – онлайн
  • miniapp_delivery_method – способ доставки:

    • SELF_PICKUP – самовывоз,
    • SHOP_DELIVERY – доставка магазином
  • miniapp_phone – телефон, указанный в заказе
  • miniapp_shipping_address – адрес доставки
  • miniapp_cart_price – общая стоимость всех товаров в валюте магазина
  • miniapp_shipping_price – стоимость доставки
  • miniapp_total_price– стоимость заказа общая
  • miniapp_comment – комментарий
Создана корзинаПользователь добавил в пустую корзину товар.

  • miniapp_cart_json – JSON переменная, со списком товаров корзины
  • miniapp_cart_text – содержимое корзины в текстовом формате
  • miniapp_products_quantity – общее количество всех товаров
  • miniapp_cart_price – общая стоимость всех товаров в валюте магазина
  • miniapp_currency – валюта
Изменен статус заказаИзменился статус заказа (автоматически или вручную)

  • miniapp_order_status:

    • Отменен – cancelled
    • Сформирован – formed
    • Оплачен – paid
    • Завершен – completed
  • miniapp_cart_json – JOSN переменная, со списком товаров корзины
  • miniapp_order_number – переменная с номером заказа
  • miniapp_cart_text – содержимое корзины в текстовом формате
  • miniapp_products_quantity – общее количество всех товаров
  • miniapp_cart_price – общая стоимость всех товаров в валюте магазина
  • miniapp_currency – валюта
  • miniapp_payment_method – способ оплаты:

    • CASH_PAYMENT – наличные,
    • ONLINE_PAYMENT – онлайн
  • miniapp_delivery_method – способ доставки:

    • SELF_PICKUP – самовывоз,
    • SHOP_DELIVERY – доставка магазином
  • miniapp_phone – телефон, указанный в заказе
  • miniapp_shipping_address – адрес доставки
  • miniapp_cart_price – общая стоимость всех товаров в валюте магазина
  • miniapp_shipping_price – стоимость доставки
  • miniapp_total_price– стоимость заказа общая
  • miniapp_comment – комментарий

Пример содержимого переменной miniapp_cart_json

[
  {
    "categories": ["Одежда", "Футболки"],
    "currency": "RUB",
    "image": "https://storage.leadteh.ru/miniapp/example123/image1.png",
    "name": "Футболка без опций",
    "options": [],
    "price": 1200,
    "quantity": 1,
    "video": "https://video.ru/video1/"
  },
  {
    "categories": ["Обувь", "Кроссовки"],
    "currency": "RUB",
    "image": "https://storage.leadteh.ru/miniapp/example456/image2.png",
    "name": "Кроссовки с параметрами",
    "options": [
      "42", 
      "Чёрный"
    ],
    "price": 4500,
    "quantity": 2
  }
]

Обработка события в сценарии бота

Если в конструкторе есть созданный и активный обработчик события, то при срабатывании этого события запустится тот сценарий, который вы указали в настройках обработчика. В этом сценарии будут доступны переменные события — список переменных см. в таблице #Список событий Mini App

Вы можете использовать эти переменные также, как и любые другие переменные, например, добавлять их в текст блока Цепочка сообщений или проверять значение переменной блоком Условие.

Информация

Важно! Данные переменные являются локальными.

miniapps магазин

Использование переменной в блоке Цепочка Сообщений

miniapps магазин

Использование переменной события в блоке Условие

Создание интернет-магазина в Telegram с событиями MiniApp - автоматизация продаж и удержание клиентов

Видеоурок по созданию интернет-магазина в Telegram с использованием событий MiniApp.

Изучите настройку товарного каталога, интеграцию с ЮКасса, создание системы автоматической отправки промокодов для брошенных корзин, настройку уведомлений о заказах и полную автоматизацию процесса продаж без программирования.

🎁 Бесплатный курс по разработке чат-ботов и MiniApps для всех пользователей с активной подпиской PRO уже на LEADTEX.

10 подробных уроков с погружением от А до Я.

Начните обучение прямо сейчас - Начать обучение.