external:qr_меню:04_оповещения_для_персонала:02_telegram

Это старая версия документа!


Telegram

Перед установкой! Убедитесь, что версия QR-Меню не ниже версии 1.4.3.512.

  1. Скачать последнюю версию по ссылке.
  2. Распаковать архив.

Важно! Во избежании конфликтов при обновлении модулей не устанавливайте сервер оповещений в одну папку с QR-menu.
Внимание! Путь не должен содержать кириллицу. Только латинские буквы (временное ограничение).

В дистрибутиве содержатся следующие файлы:

desktop.bat   - запуск приложения в экранном режиме
install.bat   - установка приложения службой (запускать с правами Администратора)
uninstall.bat - удаление службы приложения (запускать с правами Администратора)

Первый запуск приложения рекомендуется провести через desktop.bat
В процессе запуска возможно появления сообщение от брандмауэра или антивируса с запросом на сетевой доступ для нового приложения. Необходимо «Разрешить» доступ.

Результатом успешного запуска является вот такое окно

Так же можно проверить работу web интерфейса перейдя по адресу http://127.0.0.1:11014/
НАДО СКРИН

После проверки рекомендуется закрыть приложение и установить его службой запустив install.bat и далее перейти в службы Windows и запустить «Carbis QRMenu Telegram Notification»
Лицензирование данного модуля - не требуется.

По умолчанию, модуль использует порт 11014. Если этот порт занят, то приложение не будет работать.
Изменить номер используемого порта можно в файле «qrmenu_notification_settings.yaml» в параметре «server_settings» → «port». Данный файл отсутствует в дистрибутиве и создается автоматически при первом запуске модуля.

Все настройки модуля производятся через web интерфейс доступный по адресу http://127.0.0.1:11011/

ТУТ СКРИН раздела настройки с выделением в шапке

  • Ввести IP адрес компьютера на котором установлена служба «Carbis QRMenu Agent»
  • Ввести порт.
  • Указать токен экземпляра QR меню с которым мы собираемся работать.

Посмотреть его можно в административной части qr-меню (по умолчанию http://127.0.0.1:11010/ в разделе Параметры системы → Регистрация на сервере приложений → Секретный ключ.

Создать бота как описано в статье Создание Бота в Telegram
Ввести токен

  • Порт на котором работает служба «Carbis QRMenu Telegram Notification»
  • Язык интерфейса и сообщений в боте (при необходимости можно сделать собственную локализацию модуля на нужный язык (Локализация служебных модулей)
  • Уровень логирования

После сохранения новых настроек необходимо перезапустить службу «Carbis QRMenu Telegram Notification» для того что бы изменения вступили в силу

Каждого сотрудника, который должен получать уведомления от бота необходимо зарегистрировать в разделе «Список работников»
Обновить список можно нажатием кнопки
По умолчанию доступны все сотрудники которые есть в справочнике Работники системы r_keeper
Фильтр «На смене» позволяет отобразить только тех сотрудников, которые зарегистрированы в текущей смене на кассе
Фильтр «Нет в системе уведомлений» позволяет отобразить только тех сотрудников, которые еще не зарегистрированы в боте.

Далее необходимо выбрать в списке нужного сотрудника и для него будет сгенерирован персональный QR код
Сотрудник на своем телефоне считывает этот QR код и подключается к боту (скрины)

Если вы удалите или деактивируете учетную запись сотрудника в системе r_keeper - бот перестанет с ним общаться
Если вы приняли на работу нового сотрудника то вам необходимо завести его как работника в справочнике r_keeper и после этого показать ему персональный QR код

Общий принцип отправки уведомлений
Когда происходит событие для которого мы не можем определить конкретного получателя - уведомление получат все сотрудники, зарегистрированные в смене на кассе r_keeper
Пример: гости сели за стол №5, отсканировали QR-код, и сделали заказ через QR меню.
На кассе r_keeper будет создан стол №5 и наполнен заказанными блюдами. Но т.к. на этот стол еще не назначен официант, то уведомление получает все сотрудники на смене

Когда происходит событие связанное со столом за которым уже закреплен официант (например гости самостоятельно рассчитались через qr-меню за свой заказ) уведомление получит только один сотрудник (тот кто является официантом данного заказа)
События, по которым приходят уведомления:

  • Сделан новый заказ.
  • Сделан дозаказ.
  • Заказ оплачен гостем самостоятельно через QR-меню.

ТУТ НАДО СДЕЛАТЬ СКРИНЫ

  • external/qr_меню/04_оповещения_для_персонала/02_telegram.1638010268.txt.gz
  • Последнее изменение: 2021/11/27 13:51
  • Александр Ильин