linkДокументация по модулю "eComBot- Telegram, Viber чатботы для ecommerce"

Модуль совместим со следующими Темами:

• YoupiTheme (совместимых с соответствующей версией CS-Cart);
• UniTheme2 (совместимых с соответствующей версией CS-Cart);
• Responsive.

Общие условия технической поддержки доступны по этой ссылке (обязательно изучите эти условия, все решения от команды разработчиков AlexBranding поставляются с ограниченной технической поддержкой).

Для того, чтобы воспользоваться нашей технической поддержкой, выполняйте следующую последовательность действий:

1. На сайте https://cs-cart.alexbranding.com авторизуйтесь под своей учетной записью владельца заказа;
2. Перейдите на страницу Мой профиль → Заказы;
3. Найдите соответствующий заказ с решением (по которому у Вас есть проблема) в списке заказов и перейдите к его деталям;
4. Найдите ссылку Техническая поддержка рядом с названием модуля (по которому вам необходима помощь) и нажмите ее;
5. Заполните данные с проблемой, предоставьте доступы к Вашей установке (обязательно путь к административной панели, почту и пароль администратора + FTP доступы) и создайте тикет (после того, как будет создан тикет, Вы получите письмо на e-mail и специальный код для отслеживания тикета в дальнейшем);
6. Ожидайте ответ специалиста (на электронную почту владельца заказа с темой) в соответствии с регламентами работы службы техподдержки и выбранным Вами приоритетом решения.

Если Вы не получили ответ в течении сроков, обозначенных в регламентах, напишите на почту info@alexbranding.com с номером тикета, по которому вовремя не получили ответ, и менеджер команды разработчиков решит проблему с соблюдением регламентов.

Протестировать работу модуля, с доступом к административной панели магазина, Вы сможете на нашем сервере Демо решений для CS-Cart от Alexbranding выбрав его в списке Модулей или просто перейдите по ссылке.

Рекомендуем ознакомиться с общими ограничениями:

1. Все модули и решения команды AlexBranding требуют предварительной установки сервисного модуля AB: Менеджер Модулей. Он поставляется бесплатно и отвечает за вопросы: установки, обновления, лицензионной проверки модулей. Исключить использование этого сервисного модуля не представляется возможным;
2. Файлы модуля могут иметь закрытую (закодированную) часть, в которой находится исключительно проверка лицензии;
3. Модуль будет работать только на тех доменах, которые указаны в лицензии пользователя. При попытке использования решения на установках CS-Cart, домены которых не включены в лицензию, модуль будет автоматически выключен;
4. Установка локально не допускается системой лицензирования, чтобы модуль работал на дополнительном домене (поддомене) укажите этот домен (поддомен) в поле Домен при заказе (или напишите на info@alexbranding.com) — добавление технических доменов для разработчика или для тестирования — бесплатно.

После того, как Ваш заказ будет обработан нашим менеджером, он будет переведен в состояние Выполнен, Вы получите письмо на Ваш почтовый ящик с номерами лицензий заказанных модулей (обычно это требует от 15 минут до 8 часов в зависимости от времени суток и дня недели).

Далее выполняйте следующую последовательность действий, которая отличается в зависимости от вашей версии платформы CS-Cart:

Также, Вы можете установить модуль стандартной установкой для CS-Cart. Для этого, скачайте соответствующий архив с совместимой с Вашей версией платформы CS-Cart версией модуля.
Перейдите на сайт cs-cart.alexbranding.com, авторизуйтесь под учетной записью владельца заказа и перейдите в Мой профиль → Заказы → Соответствующий заказ, перейдите в его детали и Вы увидите список доступных архивов для заказанного модуля. Скачайте необходимую Вам версию (архив) и произведите установку (стандартная для CS-Cart установка: Модули → Скачанные модули и в меню шестерёнки выберите Ручная установка).

Для начала работы с текущим функционалом модуля необходимо:

1. Установить модуль стандартной установкой для CS-Cart
2. Настроить мессенджеры и получить API ключи.
3. Указать API ключи мессенджеров в настройках модуля.
4. Указать доступные языки для общения с клиентами в мессенджере.
5. Создать и активировать шаблоны сообщений для отслеживания цены на понижение и повышение цены товаров.
6. Создать промо-акцию для формирования промо-кодов со скидкой.
7. Создать и активировать сообщения для предоставления промо-кодов со скидкой.
8. Настроить Cron-задания для автоматической рассылки сообщений клиентам, что начали отслеживать товар(ы).

Для доступа к настройкам модуля необходимо перейти на страницу Панель администратора → Модули → Управление модулями и у названия модуля в меню шестерёнки выбрать соответствующий пункт меню.

Чтобы настроить мессенджер Telegram, обратитесь к Руководству по настройке Telegram (эту ссылку можно также найти на странице Список ботов в подсказке к полю API ключ).
Чтобы настроить мессенджер Viber, обратитесь к Руководству по настройке Viber (эту ссылку можно также найти на странице Список ботов в подсказке к полю API ключ).

Получив от месенджера API ключ, скопируйте его в соответствующее поле на странице Список ботов.

Отслеживаемые события модулем:

• ФИО клиента, который подписался на отслеживание цены товара;
• Никнейм клиента - вариант имени, который задал пользователь в мессенджере;
• Количество отслеживамых товаров - модуль ведёт учёт всех товаров, по которым идёт отслеживание цены.

Чтобы настроить Messenger, обратитесь к “Руководству по настройке Messenger” (эту ссылку можно также найти на странице Список ботов в подсказке к полю Маркер). Для правильной настройки данного мессенджера следуйте пошаговой инструкции:

1. Создайте в Facebook Страницу типа Компания или Бренд.

2. Создайте аккаунт разработчика Facebook на сайте “Facebook Developers”, где нажмите кнопку Начать работу и выберите тип Разработчик:

   • выберите тип приложения Компания;
   • на странице Добавление продуктов в приложение нажмите кнопку Настроить в продукте Messenger (Настройте формат общения с людьми в Messenger);
   • в секции Маркеры доступа нажмите Добавить или удалить Страницы и свяжите приложение со Страницей Facebook;
   • в секции Маркеры доступа нажмите Сгенерировать маркер и скопируйте маркер.

3. Перейдите на страницу модуля EcomBot: Список ботов для настройки бота Messenger:

   • в поле Маркер вставьте сгенерированный маркер;
   • в поле Маркер подтверждения введите произвольную фразу;
   • добавьте текст приветствия;
   • сохраните внесённые данные;
   • скопируйте сгенерированную ссылку URL обратного вызова.

4. Вернитесь на сайт Facebook Developers, где на странице Messenger → Настройки в секции “Webhooks” выполните следующие действия:

   • вставьте URL обратного вызова и введите придуманный вами Маркер подтверждения;
   • в таблице ниже напротив Facebook Страницы нажмите Изменить и выберите следующие Поля подписки: messages, messaging_postbacks, messaging_referrals, messaging_optins.

5. Перейдите в Facebook Страницу и настройте доступ:

   • на странице Настройки перейдите в раздел Advanced messaging;
   • в секции Запрошенные функции нажмите кнопку Запрос напротив опции Однократное уведомление.

Отслеживаемые события модулем:

• ФИО клиента, который подписался на отслеживание цены товара;
• Никнейм клиента — вариант имени, который задал пользователь в мессенджере;
• Количество отслеживаемых товаров — модуль ведёт учёт всех товаров, по которым идёт отслеживание цены.

На странице Список ботов (Панель администратора → Управление модулями → AB: EcomBot → Список ботов) доступна настройка мессенждеров.

1. API ключ ‒ после получения API ключа добавьте его в это поле;
2. UTM-метка (utm_source) ‒ метка, которая используется для отслеживания рекламных кампаний в сети Интернет. На данный момент UTM-метка не работает в мессенджерах;;
3. Позиция ‒ управление порядком расположения кнопки мессенджера;
4. Статус ‒ статус активности мессенджера.

1. API ключ ‒ после получения API ключа добавьте его в это поле;
2. Автор сообщений ‒ название или имя, которое будет отображаться в диалогах мессенджера. Можно использовать имя бота, которое вы указали при создании бота;
3. Логотип сообщения ‒ ссылка на изображение, которое будет установлено как логотип сообщения вместо изображения бота. Максимальный размер 720px x 720px, 100Кб;
4. UTM-метка (utm_source) ‒ метка, которая используется для отслеживания рекламных кампаний в сети Интернет. На данный момент UTM-метка не работает в мессенджерах;
5. Позиция ‒ управление порядком расположения кнопки мессенджера;
6. Статус ‒ статус активности мессенджера.

1. Маркер — после получения маркера добавьте его в это поле;
2. Маркер подтверждения — введите произвольную фразу для маркера подтверждения;
3. Текст приветствия — введите текст приветствия, которое будет отображаться в мессенджере;
4. URL обратного вызова — скопируйте сгенерированную ссылку “URL обратного вызова” и вставьте её вместе с придуманным вами “Маркером подтверждения” на сайте “Facebook Developers”;
5. Позиция — управление порядком расположения кнопки мессенджера;
6. Статус — статус активности мессенджера.

На странице Список скриптов (Панель администратора → Управление модулями → AB: EcomBot → Список скриптов) доступен список шаблонов с их настройками и сообщениями для действий и событий в мессенджере. На этой странице можно управлять настройками шаблона, редактировать и включать/выключать шаблоны (управление статусом возможно после сохранения настроек шаблона), а также указать на каких языках могут отправляться сообщения в мессенджере. Для каждого шаблона и его сообщений доступно форматирование текста и набор соответствующих плейсхолдеров.

На странице доступны настройки для отслеживания цены отдельно на понижение и на повышение.

1. Время отслеживания, дни ‒ количество дней, в течении которых будет происходить процесс отслеживания цены товара;
2. Учет наличия товара ‒ влияет на отображение кнопок и отправку уведомлений;
3. Отслеживание на понижение ‒ отслеживание цены на понижение. Доступны настройки для отслеживания цены отдельно на понижение и на повышение:
   • Включить ‒ возможность включить или выключить соответствующее отслеживание цены;
   • Тип дельты цены ‒ выбор варианта погрешности цены: Абсолютная - разница между первоначальной суммой и её точным значением; Относительная - процентное соотношение погрешности цены;
   • Значение дельты цены ‒ значение, при котором пользователям будут отправляться сообщения об изменении цены.
4. Отслеживание на повышение ‒ отслеживание цены на повышение;
5. Статус ‒ статус активности скрипта Отслеживание цены.

На странице доступны сообщения для действий и событий в мессенджере. В сообщениях можно использовать специальные теги для форматирования текста. Чтобы отформатировать текст оберните нужный участок открывающим и закрывающим тегом.

В сообщениях доступны для использования следующие плейсхолдеры:

• [product_name] - Название товара
• [tracking_days] - Количество дней отслеживания
• [product_link] - Ссылка на товар
• [current_price] - Текущая цена товара
• [current_price_with_currency] - Текущая цена товара с валютой
• [previous_price] - Предыдущая цена товара
• [previous_price_with_currency] - Предыдущая цена товара с валютой
• [price_difference_percent] - Разница между предыдущей и текущей ценой в процентах
• [price_difference] - Разница между предыдущей и текущей ценой
• [firstname] - Имя клиента
• [lastname] - Фамилия клиента
• [username] - Имя пользователя (ник) клиента
• [any_name] - Имя клиента или фамилия клиента, или имя пользователя, или любое значение языковой переменной ab__eb.clients.no_name. Будет выбрано первое заполненое значение
• [counter] - Счетчик сообщений, отправляемых вместе

Вкладка разработана для предоставления персональной скидки пользователям с помощью генерируемых модулем промо-кодов.
В первую очередь необходимо использовать стандартный механизм CS-Cart Маркетинг → Промо-акции и скидки и создать отдельную промо-акцию для корзины, где во вкладке Бонус следует выбрать Использовать скидку на товар из отправленного промо-кода. Условия для данной промо-акции задавать не нужно, так как величина скидки будет задана в самом шаблоне Отслеживание цены, во вкладке Предложить скидку. Здесь же необходимо связать созданную промо-акцию с предлагаемыми скидками, выбрав промо-акцию в поле Связанная промо-акция.

Далее необходимо создать сообщения, указать время отправки и величину скидки по промо-коду. По умолчанию все сообщения будут отправляться по Cron-заданию Запланировать отправку промо-кода в соответствии с назначенным временем для каждого сообщения в отдельности.
Все сгенерированные промо-коды и их состояние указываются на странице Список промо-кодов.

1. Включить — возможность включить или выключить предоставление промо-кода по Cron-заданию;
2. Связанная промо-акция — выбор промо-акции для корзины. Бонусы с указанной промо-акции будут использованы, если пользователь введет действующий промо-код. Текущие условия, заданные для выбранной промо-акции, будут опущены. Для формирования промо-кода следует во вкладке Бонусы соответствующей промо-акции добавить бонус Использовать скидку на товар из отправленного промо-кода;
3. Стратегии рассылок — добавляет стратегии с возможностью настройки уникальных сообщений и настроек.

Во всплывающем окне настроек стратегии рассылок предусмотрен функционал, который позволяет гибко проработать каждый уникальный случай. Среди условий доступен диапазон цен, количество товара в наличии, а также выбор отдельных категорий для предоставления персональной скидки.
После сохранения условий, доступна вкладка Предложить скидку. В этой вкладке следует создать сообщение с промо-кодом, указать когда это сообщение должно быть отправлено и настроить процент скидки, предоставляемой по промо-коду. Для лёгкого понимания настроек предусмотрены подсказки, которые помогут разобраться в функционале.

Например, временное условие Через указанное время с интервалом 00:20 позволит системе отправить пользователю автоматическое сообщение по Cron-заданию через 20 минут после того, как пользователь подпишется на отслеживание цены товара.

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

Кнопка Тест позволяет проверить каждое сообщение в отдельности и точечно отправить промо-код со скидкой конкретному клиенту-подписчику на конкретный отслеживаемый товар. Обратите внимание, что любые условия стратегии рассылки игнорируются с целью тестовой отправки сообщения индивидуальному пользователю.

Для каждого сообщения доступны специальные теги для форматирования текста и набор следующих плейсхолдеров:

• [product_name] - Название товара
• [product_link] - Ссылка на товар
• [current_price] - Текущая цена товара
• [current_price_with_currency] - Текущая цена товара с валютой
• [firstname] - Имя клиента
• [lastname] - Фамилия клиента
• [username] - Имя пользователя (ник) клиента
• [any_name] - Имя клиента или фамилия клиента, или имя пользователя, или любое значение языковой переменной eb.clients.no_name. Будет выбрано первое заполненное значение
• [promo_code] - Промо-код
• [discounted_price] - Цена с промо-кодом
• [price_tracking_start] - Дата и время начала отслеживания

Данная страница предназначена для настройки стандартных шаблонов сообщений в рамках указанных языков. Благодаря выбранным языкам на этой странице клиенты Вашего магазина смогут выбрать желаемый язык сообщений и общения в мессенджерах.

• Доступные языки ‒ варианты языков, на которых могут отправляться сообщения в мессенджере;
• Статус ‒ статус активности шаблона.

На странице доступны сообщения для действий в мессенджере. В сообщениях можно использовать специальные теги для форматирования текста. Чтобы отформатировать текст оберните нужный участок открывающим и закрывающим тегом.

В сообщениях доступны для использования плейсхолдеры:

• [product_name] - Название товара
• [tracking_days] - Количество дней отслеживания
• [product_link] - Ссылка на товар
• [current_price] - Текущая цена товара
• [current_price_with_currency] - Текущая цена товара с валютой
• [previous_price] - Предыдущая цена товара
• [previous_price_with_currency] - Предыдущая цена товара с валютой
• [price_difference_percent] - Разница между предыдущей и текущей ценой в процентах
• [price_difference] - Разница между предыдущей и текущей ценой
• [firstname] - Имя клиента
• [lastname] - Фамилия клиента
• [username] - Имя пользователя (ник) клиента
• [any_name] - Имя клиента или фамилия клиента, или имя пользователя, или любое значение языковой переменной ab__eb.clients.no_name. Будет выбрано первое заполненое значение
• [counter] - Счетчик сообщений, отправляемых вместе

На странице Список клиентов (Панель администратора → Управление модулями → AB: EcomBot → Список клиентов) доступна информация о клиентах и товарах, которые они отслеживают.

Доступна следующая информация о клиенте:

• ФИО клиента;
• Никнейм клиента;
• Название бота;
• Перечень отслеживаемых товаров.

На странице Список отслеживаемых товаров (Панель администратора → Управление модулями → AB: EcomBot → Список отслеживаемых товаров) доступна информация о товарах, которые отслеживают клиенты.

Доступна следующая информация:

• Название отслеживамого товара;
• ФИО клиента;
• Никнейм клиента;
• Период отслеживания (от - до);
• Базовая цена товара;
• Цена в валюте клиента;
• Валюта клиента.

Страница Список промо-кодов (Панель администратора → Управление модулями → AB: EcomBot → Список промо-кодов) предусмотрена для хранения и контроля промо-кодов, сформированных посредством отправленных сообщений с промо-кодами соответствующей скидки (страница Отслеживание цены, вкладка Предложить скидку). На странице фиксируются данные по каждому промо-коду и если промо-код был использован, в последней колонке будет содержаться ссылка на сформированный заказ.

Доступна следующая информация:

• Промо-код;
• Наименование товара;
• Скидка в процентах, которая даётся по промо-коду;
• Дата и время создания промо-кода;
• Статус использования промо-кода.

На странице Cron-задания (Панель администратора → Управление модулями → AB: EcomBot → Cron-задания) доступна возможность настроить автоматическую отправку уведомлений о смене цены отслеживаемых товаров и удаление просроченных отслеживаний. Эти команды можно настроить как по отдельности, так и вместе, используя третье Cron-задание.

Используя отправку сообщений с промо-кодом персональной скидки, воспользуйтесь Cron-заданиями Запланировать отправку промо-кода и Отправить сообщения из очереди.

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

Частота отправки уведомлений искусственно ограничена до значения 0,35 секунды на уведомление. Это сделано в связи с рекомендациями мессенджеров во избежание блокировок отправки. Таким образом при установке параметра --limit=1000 1 000 отслеживаний будет обработана максимум за 350 секунд (примерно 6 минут). Это время может сократиться, если среди отслеживаемых товаров будут такие, уведомления по которым отсылать не нужно (цена не изменилась или изменилась недостаточто, недоступные на витрине товары или товары без цены).