Оповещения о заказах в Telegram

Скидка
700₽ 1 000₽
Купить
Автор: webspog
Размещено: 7 Июня, 2023
Просмотры: 917
Версия: 1.0
Продаж: 4
Лицензия: На один домен, поддомены
Проверка:
Проверен

Оповещения о заказах в Telegram

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

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

Перед установкой модуля нужно создать бота Telegram и получить Id пользователя.

  1. В поиске телеграм найдите бота @BotFather. Это главный бот, через которого создаются все боты.
  2. Нажмите Запустить.
  3. Напишите и отправьте сообщение /newbot. Это команда для создания нового бота.
  4. В ответ вы получите сообщение Alright, a new bot. How are we going to call it? Please choose a name for your bot. В сообщении говорится, что нужно задать имя для нового бота.
  5. Напишите ответным сообщением имя бота (Например Бот уведомлений о заказах). В ответ вы получите сообщение Good. Now let's choose a username for your bot. It must end in `bot`. Like this, for example: TetrisBot or tetris_bot. Вас просят задать username для бота. Это публичное имя, по которому ваш бот можно будет найти в поиске. оно должно иметь окончание bot. Например my_bot или mybot. Это имя потребуется потом в настройках модуля.
  6. Если такое имя занято, вы получите сообщение об ошибке Sorry, this username is already taken. Please try something different. Тогда нужно придумать другое уникальное имя. В случае успеха вы получите сообщение, в котором будет ссылка на вашего бота и строка с токеном Use this token to access the HTTP API:5642622960:DSFJLDJSLKFKLDJFLEIIEJFDLKD
  7. Токен необходимо сохранить, для дальнейшего ввода в настройках модуля. 
  8. Перейдите по ссылке на вашего бота и нажмите Запустить.

  1. Заходим в телеграм и ищем в поиске @userinfobot
  2. Пишем сообщение /start
  3. В ответ на сообщение вы получите Id вашего пользователя. Он потребуется для настроек модуля

  1. Поле "Статус" должно быть Включено
  2. Поле "Уведомления администратору" должно быть включено
  3. В поле "Token доступа" вводим токен полученный в пункте 6 "инструкции по созданию бота".
  4. В поле "Id пользователя" вводим Id вашего пользователя, полученный в пункте 3 инструкции "Получить Id пользователя".
  5. После заполнения Token и Id вы можете протестировать отправку сообщений ботом. Для этого введите сообщение в поле "Отправить тестовое сообщение" и нажмите кнопку с "самолетиком". В телеграм должно прийти сообщение от вашего бота.
  6. На вкладке "Шаблоны сообщений администратору" в поле "Шаблоны сообщений" задайте шаблон письма, при этом можно использовать динамические теги (они указаны в подсказках при наведении на вопросик). При указании таких тегов они будут заменяться информацией из заказа. Например "Вам поступил заказ № {order_id}". {order_id} в сообщении будет заменен на реальный номер заказа.
  7. Если требуется в сообщении прописывать товары из заказа, то нужно настроить "шаблон строки товара". В нем тоже можно использовать динамические теги, для подстановки нужной информации о товаре. Например "Товар {name} на сумму {total}". {name} и {total} в сообщении будет заменен на реальные название и сумму.
  8. В поле "Разделитель строки" прописываются символы, которые будут вставлены между строками товаров. (Например можно прописать -----------------).
  9. Если шаблон товара заполнен, то в шаблоне сообщения нужно в произвольном месте вывести блок товаров с разделителями путем тега {products}. При этом вместо {products} будут выведены все товары заказа в заданном "шаблоне товара", разделенные "разделителем строки".
  10. Сохранить настройки.
  11. Теперь при создании нового заказа, администратору будут приходить сообщения с информацией о заказе по настроенному шаблону.

  1. Поле "Статус" должно быть Включено
  2. Поле "Уведомления покупателю" должно быть включено
  3. В поле "Token доступа" вводим токен полученный в пункте 6 "инструкции по созданию бота".
  4. В поле "Username бота" вводим username вашего бота, заданный вами в пункте 5 "инструкции по созданию бота".
  5. В поле "Метод получения id покупателя" можно выбрать метод "Вебхук" или оставить "Запрос обновлений". Это методы получения id покупателя для отправки ему уведомлений. После завершения заказа, на странице Успеха пользователю будет предложена ссылка на подписку на уведомления. Если он по ней пройдет и подпишется на бота, путем нажатия кнопки "Запустить", то он будет получать уведомления. Вебхук позволяет автоматически уведомлять сайт о поступившем сообщении боту. Запрос обновлений посылает запросы боту при нахождении пользователя на странице Успеха, и в случае его подписки записывает его ID. Для метода вебхук сайт обязательно должен быть доступен по протоколу https. Если выбираете метод вебхук, нужно скопировать ссылку "Url для создания вебхука" и вызвать ее в браузере. При этом для бота будет создан вебхук. Если вы создали вебхук, и решили все таки использовать метод Запрос обновлений, то нужно скопировать ссылку "Url для удаления вебхука" и вызвать ее в браузере, чтобы вебхук удалился. Т.к. если работает один метод, то другой при этом работать не может.
  6. На вкладке "Шаблоны сообщений покупателю" в поле "Статусы заказов" нужно отметить статусы заказов, при которых будет отправляться уведомление покупателю.
  7. В разделе "Шаблоны сообщений" задайте шаблон письма для включенных статусов, при этом можно использовать динамические теги (они указаны в подсказках при наведении на вопросик). При указании таких тегов они будут заменяться информацией из заказа. Например "Ваш заказ № {order_id} сменил статус на Обработан". {order_id} в сообщении будет заменен на реальный номер заказа.
  8. Если требуется в сообщении прописывать товары из заказа, то нужно настроить "шаблон строки товара". В нем тоже можно использовать динамические теги, для подстановки нужной информации о товаре. Например "Товар {name} на сумму {total}". {name} и {total} в сообщении будет заменен на реальные название и сумму.
  9. В поле "Разделитель строки" прописываются символы, которые будут вставлены между строками товаров. (Например можно прописать -----------------).
  10. Если шаблон товара заполнен, то в шаблоне сообщения нужно в произвольном месте вывести блок товаров с разделителями путем тега {products}. При этом вместо {products} будут выведены все товары заказа в заданном "шаблоне товара", разделенные "разделителем строки".
  11. Сохранить настройки.
  12. При завершении заказа покупателем и попадании на страницу Успеха, ему будет предложено подписаться на уведомления. Если он перейдет по ссылке и нажмет "Запустить", то его id будет записан в БД заказа, и при смене статуса заказа администратором, ему будут приходить уведомления в телеграм.

Это ошибка в коде php вашего сайта. Чтобы ее расшифровать и устранить нужно:
  1. В административной части сайта перейти в Система -> Инструменты -> Журнал ошибок. В конце будут актуальные ошибки сайта. Если ошибки в журнале отсутствуют - нужно включить запись ошибок. Для этого перейдите в Система -> Настройки -> Сервер -> Записывать ошибки -> Да.
  2. Если есть доступ по FTP, то вы можете открыть файл logs/error.log у вас на сервере. Последние ошибки - будут соответствовать ошибкам вашего сайта.
  3. Если на сайте не отображается ошибка - можно отобразить их через Ваш htaccess, который находится в корне сайта. Нужно в самом начале дописать следующий код.
php_value display_errors 1
php_value display_startup_errors 1
php_value error_reporting E_ALL
Если при установке модуля вы получаете данную ошибку, то нужно сделать следующее:
  1. Вы можете установить модификатор localcopy.ocmod.xml, который позволяет устанавливать модули без настройки FTP на вашем сайте.
  2. Или же настроить доступы FTP. Зайдите в Система -> Настройки -> FTP и корректно укажите данные.
Если при установке модуля вы получаете данную ошибку, то нужно сделать следующее:
  1. Скачайте и установите модификатор localcopy.ocmod.xml
  2. Обновите модификаторы в администативной части сайта.
  3. Загрузите модуль еще раз.
Если при входе в модуль вы получаете сообщение "Доступ запрещен! У Вас нет прав для доступа к этой странице. Если она Вам нужна, обратитесь к администратору." бывает несколько причин:
  1. Нужно дать права администраторам на управление модулем. Для этого перейдите в Система -> Настройки -> Пользователи -> Группа пользователей -> Выбрать вашу группу, установить все галочки и нажать сохранить.
  2. Модуль установился не полностью. Файлы не загружены на сервер. Нужно установить модификатор localcopy.ocmod.xml и попробовать переустановить снова.
  3. Версия Модуля может не соответствовать версии Вашего сайта. Сверьте версии сайта и модуля.
Дополнения для установки с администативной части должны соответствовать требованиям:
  1. Имя файла дополнения должно заканчиваться на .ocmod
  2. Архив дополнения должен иметь расширение .zip
  3. Внутри архива могут быть файлы install.xml install.php install.sql и папка upload (может быть пуста, если это модификатор).
Неверно упакован архив:
  1. Эта ошибка означает что внутри установочного архива отсутствует папка upload. Такие папки должны быть внутри модуля .ocmod.zip и может быть пустой, но является обязательной в Opencart 2.
Если при установке дополнения возникает такая ошибка, то вероятно, Вы пытаетесь установить модификатор с ID, который уже установлен (повторная установка).
  1. Перед установкой модуля нужно удалить предыдущую версию данного модификатора.
  2. Если модули разные но совпали названия id, то нужно его изменить
Возможные решения:
  1. Если до этого Вы не устанавливали модули через админку сайта, то Вам нужно установить модификатор localcopy.ocmod.xml. После этого попробовать переустановить Ваш модуль.
  2. Необходимо дать права на просмотр и изменение настроек модуля - для этого нужно перейти Система -> Настройки -> Пользователи -> Группа пользователей -> Выбрать вашу группу, установить все галочки и нажать сохранить.
  3. Возможно Ваш язык не поддерживается модулем и Вам нужно обратиться в поддержку за доработкой.
  4. У модуля может не быть страницы с настройками. Что бывает очень редко.
  5. У модификатора никогда не бывает собственного раздела с настройками.
Вроде бы модуль установлен и настроен, а все-равно не видно его работы.
  1. Возможно, такой модуль требует вывода на сайте в ручном режиме. Для этого Вам нужно перейти в Дизайн -> Макеты и вывести модуль в нужном макете в нужном месте.
  2. Если отображение контентной части дополнения реализовано с помощью модификатора, возможно, есть несовместимость с шаблоном. Потребуется адаптация модификатора.
  3. В Opencart 3 после установки дополнения с модификатором необходимо обновить кэш шаблонизатора (кнопка с "шестеренкой" на главной странице админки в правом верхнем углу).
  1. Файлы модуля не загужены на сервер, проверьте их наличие через FTP-клиент.
  2. Не выданы права администратору магазина на просмотр и управление модулем в разделе "Группы пользователей".
  3. Некоторые модули вносят изменения в файлы сайта в виде модификаций, не меняя их, а создавая кэш модифицированных файлов. После установки таких модулей нужно обязательно обновить кэш модификаторов сайта.
  4. В Opencart 3 после установки дополнения с модификаторов необходимо обновить кэш шаблонизатора (кнопка с "шестеренкой" на главной странице админки в правом верхнем углу).
  1. В этой версии Opencart в файле system/modification.xml на 21 строке допущена ошибка из-за которой не применяются другие модификаторы. Необходимо заменить эту строку на следующее и обновить кэш модификаторов:
<![CDATA[$loader = new \Twig\Loader\ArrayLoader(array($filename . '.twig' => $code));]]>