Мессенджеры

Перед установкой! Убедитесь, что версия 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:11014/

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

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

Результатом корректной настройки является следующее состояние

Данная настройка доступна с версии v1.0.4.21.

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

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

1. Каждого сотрудника, который должен получать уведомления от бота необходимо зарегистрировать через «список работников». (По умолчанию доступны все сотрудники которые есть в справочнике «Работники» системы r_keeper)
Сотрудников можно отфильтровать:

• Фильтр «На смене» позволяет отобразить только тех сотрудников, которые зарегистрированы в текущей смене на кассе.
• Фильтр «Нет в системе уведомлений» позволяет отобразить только тех сотрудников, которые еще не зарегистрированы в боте.

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

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

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

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

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