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

Позволяет обработать в сценарии Telegram-бота события, которые произошли в магазине MiniApp

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

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

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

Вкладка Mini App

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

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

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

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

Список событий Mini App

Название события
Описание события
Доступные в сценарии переменные

Запуск магазина по кнопке

Пользователь запустил магазин по кнопке

-

Запуск магазина по ссылке

Пользователь запустил магазин по ссылке

-

Переход на страницу оформления заказа

Пользователь перешел на страницу оформления заказа

  • miniapp_cart_json – JOSN переменная, со списком товаров корзины

  • miniapp_cart_text – содержимое корзины в текстовом формате

  • miniapp_products_quantity – общее количество всех товаров

  • miniapp_cart_price – общая стоимость всех товаров в валюте магазина

  • miniapp_currency – валюта

Создание заказа (заказ оформлен)

Пользователь оформил заказ

  • miniapp_cart_json – JOSN переменная, со списком товаров корзины

  • 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 – JOSN переменная, со списком товаров корзины

  • miniapp_cart_text – содержимое корзины в текстовом формате

  • miniapp_products_quantity – общее количество всех товаров

  • miniapp_cart_price – общая стоимость всех товаров в валюте магазина

  • miniapp_currency – валюта

Изменен статус заказа

Изменился статус заказа (автоматически или вручную)

  • miniapp_order_status:

    • Отменен – cancelled

    • Сформирован – formed

    • Оплачен – paid

    • Завершен – completed

  • miniapp_cart_json – JOSN переменная, со списком товаров корзины

  • 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

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

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

Использование переменной в блоке Цепочка Сообщений
Использование переменной события в блоке Условие
PreviousСобытияNextСобытия Telegram

Last updated

Was this helpful?