Описание
MC: Telegram веб-приложение — это модуль от команды Maxi Cart для платформы CS-Cart (всех редакций) и MultiVendor (всех редакций) 4.11.1 - 4.18.2.
Модуль добавит Вашему магазину функционал персонализированного чат-бота
Первая реализация модуля имеет широкий функционал, однако модуль будет дорабатываться в дальнейшем.
Что умеет модуль в текущей реализации:
- Отправка уведомлений покупателю (о статусе заказов, отгрузках, добавлении доступа на скачивание электронных товаров).
- Отображать список заказов пользователя (можно выбрать заказы в каких статусах будут доступны для пользователя в боте).
- Запускать веб-приложение, которое позволит покупателю не выходя из Telegram совершать покупки в Вашем магазине.
- Отображать товары: хиты продаж, новинки, товары со скидкой с возможностью пагинации.
- Делать рассылки о промо-акция и скидках.
- Отправлять напоминание покупателям о брошенных корзинах.
Мы продолжаем работать над функционалом модуля. В новой версии Вас ждут расширенные функции и новые инструменты. Дата выхода новой версии зависит только от интереса пользователей к продукту.
Подробнее смотрите в видео.
Техническая поддержка
Общие условия технической поддержки доступны по этой ссылке (обязательно изучите эти условия, все решения от команды разработчиков MaxiCart поставляются с ограниченной технической поддержкой).
Обратите внимание, что за ответ на вопрос, который уже описан в документации специалист поддержки вправе списать с Вас баллы.
Использование
Установка
Для установки модуля Вам необходимо выполнить следующие шаги:
- Перейти на Маркетплейс и авторизоваться под учётной записью владельца заказа
- Перейти в заказ с модулем «Telegram веб-приложение», там Вы сможете увидеть ссылку для скачивания архива модуля
- Произвести установку скачанного архива в своём магазине (стандартная для CS-Cart установка: Модули → Управление модулями, в меню шестерёнки выберите Ручная установка, загрузите архив в появившемся окне и нажмите кнопку Установить).
Настройки
Общие настройки
1. Token доступа телеграм бота
Значением данной настройки является Access Token
Вашего Telegram бота.
Вы можете создать нового бота или использовать уже существующего.
Для того, чтоб создать нового Telegram бота
- Перейдите в BotFather;
- Отправьте боту команду
/start
; - Следуя инструкциям BotFather создайте своего бота;
- После создания бота Вы получите токен для доступа к
HTTP API
;
2. Соль
Обе настройки используются для повышения безопасности модуля в различного рода проверках и верификациях на стороне сервера магазина.
Соли
Вам необходимо удалить и создать заново вебхук.
Настройки бота
1. Никнейм бота
Никнейм Вашего бота можно посмотреть открыв профиль бота в поле "Имя пользователя".
2. Отображать заказы со статусом
Настройки определяет список статусов заказа, при которых заказ будет отображен покупателю по нажатию на кнопку "Мои заказы" в боте.
3. Отображать товаров за сообщение
Настройка определяет количество товаров в сообщении при пагинации в боте.
4. Главное меню
Данная секция настроек отвечает за отображение главного меню бота. Вы можете включить и отключить отображение разных элементов главного меню.
Обратите внимание, что отображение некоторых элементов меню может зависеть от дополнительных модулей ядра и третьих сторон.
Работа со встроенным функционалом
В этом разделе представлена информация исключительно по функциям, которые добавляет «Telegram веб-приложение».
Мы настоятельно рекомендуем Вам ознакомиться с документацией к использованию CS-Cart перед тем как приступать работать с модулем.
Незавершенные покупки
На странице "Заказы → Незавершенные покупки" доступна отправка напоминаний о пустой корзине покупателям.
Уведомления
На странице "Администрирование → Уведомления → Уведомления для покупателей" доступен список уведомлений поддерживаемых модулем.
Разработка
Добавление новых элементов в главном меню
Файл отвечающий за отображение главного меню расположен по данном пути: app/addons/mc__telegram_webapp/Mc_telegramWebapp/Commands/Telegram/ShowMainMenu.php
.
Добавить/изменить элементы главного меню бота можно воспользовавшись PHP хуком mc__telegram_webapp_commands_show_main_menu
:
/**
* Change request before sending main menu to chat
*
* @param ATelegramCommand $this
* @param array $req
*/
fn_set_hook('mc__telegram_webapp_commands_show_main_menu', $this, $req);