Дубовой: Телеграм менеджер - обработка заказов через телеграм

3.2.0 (01.06.2024)	Реализована поддержка региональности при использовании решения Аспро Максимум Реализована выгрузка заказов в групповые чат-боты (приватные группы).
3.0.1 (30.05.2024)	Добавлена поддержка многосайтовости (разделение менеджеров по сайтам) Добавлена возможность привязки пользователей к отдельным регионам сайта Добавлена выгрузка скидок и активированных купонов на скидку Реализована поддержка выгрузки заказов в групповые чаты
2.0.0 (18.08.2023)	Внедрена возможность установки модуля в демо-режиме
1.0.3 (18.08.2023)	Доработан агент удаления логов
1.0.2 (11.07.2023)	Исправлены ошибки при автоматическом создании веб-хука телеграм
1.0.1 (11.07.2023)	Исправлены ошибки административной части модуля

Модуль поддерживает версию php - 8.х, а также работает и на ранних версиях php 7.4 и выше.

Для корректной работы всех функций модуля необходимо иметь актуальный SSL сертификат для вашего домена (в том числе бесплатный Let's Encrypt). Без этого не будут работать функции распределения заказов по менеджерам, а также определение статуса заказов.



1) Перейдите в раздел “Marketplace” - “Обновление платформы” и откройте вкладку “Активация купона”. Введите в поле приобретенный купон и активируйте.


2) Перейдите в раздел “Marketplace” - “Обновление решений”  и установите модуль, нажав на кнопку “Установить рекомендуемые обновления”. Перед этим вы можете нажать на ссылку “Посмотреть список обновлений” и поставить галочку только напротив нашего модуля. В противном случае вы установите обновление всех установленных модулей.


3) После установки появится следующее окно, в котором вы можете перейти на страницу модуля для последующей настройки:


Вы также можете перейти на страницу модуля из левого главного меню по кнопке “Дубовой”, которая находится рядом с разделом “Настройки”




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



Перейдите на страницу настроек модуля и выполните некоторые обязательные настройки:


1. Получите API токен Telegram. Без этого невозможно выполнять какие-либо действия со стороны Telegram
Подробную инструкцию как получить токен вы также можете найти на странице модуля по ссылке “Как получить токен?”.

Запустите Телеграм-бот @BotFather и начните беседу. Отправьте команду /newbot и укажите название своего бота, который будет рассылать сообщения вашим менеджерам. Например, имя нашего бота “Дубовой: телеграм-менеджер”. Имя не должно быть уникальным, указывайте любое имя. Дальше укажите user name вашего бота на латинице - это должно быть уникальное название бота, например, “DubovoiTgManagerBot”. В конце названия обязательно укажите “Bot” или “bot”. После этого вы получите API токен (выделен красным цветом).


2. Укажите ID аккаунтов телеграм для уведомлений. Для того чтобы узнать свой ID запустите бот @getmyid_bot и вы получите ID в строке "Your user ID". Чтобы узнать ID другого пользователя запустите бот и откройте диалог с этим пользователем. В чате выбираем любое полученное сообщение и пересылаем боту @getmyid_bot
Значение поля Forwarded from - это искомый ID.

Вы также можете попросить всех сотрудников прислать свои ID или воспользоваться любым другим способом

3. Если вы хотите включить функцию распределения заказов между менеджерами поставьте соответствующую галочку, а также укажите ID аккаунтов ваших менеджеров на сайте. При отсутствии аккаунтов у менеджеров, создайте аккаунты с правами обработки заказов. Создать или посмотреть ID аккаунтов можно в разделе “Настройки” - “Пользователи” - “Список пользователей.”. Обязательно укажите имя и фамилию менеджера, эта информация отображается при взятии заказа в работу.

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



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


Новинка! В модуле появилась поддержка многосайтовости и региональности. Вы можете у каждого менеджера указать ID сайта, заказы которого нужно выгружать для конкретного менеджера. Также можно указать название региона, с клиентами которого работает менеджер. Если не указывать ID сайта и / или название региона, то менеджер будет получать все заказы со всех сайтов и регионов. При этом возможно совмещение фильтрации по региону и сайту.

Сайты и регионы указываются через разделитель "/", например так: Москва / Санкт-Петербург / Казань или без пробелов Москва/Санкт-Петербург/Казань. Возможно указание одного сайта или региона либо несколько через разделитель.

Для сайтов указывается ID, например - s1 или s1/s2/s3

Для использования региональности на сайте в заказе в любом свойстве должно сохраняться название региона (реализация на стороне владельца сайта). В настройках модуля в поле "ID свойства заказа, в котором сохраняется регион" укажите соответствующее значение на вашем сайте.

Новинка! В модуле появилась поддержка выгрузки заказов в групповые чаты (приватные каналы). Для этого нужно добавить нового менеджера в модуле и указать ID группового чата (начинается с '-' и содержит только цифры). Узнать ID группового чата можно через десктоп версию телеграм.

Обновленная версия добавления менеджеров:

4. Cоздайте веб-хук Телеграм. Перейдите в самую нижнюю часть страницы настроек модуля и нажмите на кнопку “Создать вебхук”. Система автоматически отправит в Телеграм URL адрес вашего сайта. Если у вас сменится доменное имя, вебхук надо сгенерировать заново.

Создавать веб-хук нужно только по HTTPS протоколу с наличием актуального SSL сертификата. При создании веб-хука по http протоколу будет ошибка (не поддерживается со стороны Телеграм). Создание веб-хука необходимо для работы функции распределения заказов по менеджерам, а также определения статуса заказов.


5. Проверьте символьные коды свойств заказа и приведите в соответствии с обязательными значениями:

FIO - ФИО или имя клиента (тип данных - "строка")
EMAIL - электронная почта клиента (тип данных - "строка")
PHONE -  телефон клиента (тип данных - "строка")
ADDRESS - адрес клиента (тип данных - "строка")
LOCATION - местоположение (тип данных - "местоположение")

Свойства заказа можно найти в административной панели сайта в разделе "Магазин" - "Настройки" - "Свойства заказа" - "Список свойств"

В случае возникновения каких-либо ошибок необходимо перейти на вкладку "Логирование" в настройках модуля и посмотреть логи.

Для обращения в техподдержку нужно иметь активную лицензию на модуль.

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

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