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

Модуль поддерживает версию php - 8.0 и выше.



Для корректной работы всех функций модуля необходимо иметь актуальный 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 Телеграм аккаунта Ивана Иванова, то также первой строкой указывайте его ID на сайте



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

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

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



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

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



FIO - ФИО или имя клиента (тип данных - "строка")

EMAIL - электронная почта клиента (тип данных - "строка")

PHONE -  телефон клиента (тип данных - "строка")

ADDRESS - адрес клиента (тип данных - "строка")

LOCATION - местоположение (тип данных - "местоположение")



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



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

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

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

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