====== Мессенджеры ======
===== Установка =====
**Перед установкой!** Убедитесь, что версия QR-Меню не ниже версии 1.4.3.512.
- Скачать последнюю версию по [[https://disk.yandex.ru/d/OPjIOiM3BKENxA|ссылке]].
- Распаковать архив.
**Важно!** Во избежании конфликтов при обновлении модулей не устанавливайте сервер оповещений в одну папку с QR-menu.
**Внимание!** Путь не должен содержать кириллицу. Только латинские буквы (временное ограничение).
В дистрибутиве содержатся следующие файлы:
desktop.bat - запуск приложения в экранном режиме
install.bat - установка приложения службой (запускать с правами Администратора)
uninstall.bat - удаление службы приложения (запускать с правами Администратора)
Первый запуск приложения рекомендуется провести через desktop.bat
В процессе запуска возможно появления сообщение от брандмауэра или антивируса с запросом на сетевой доступ для нового приложения. Необходимо "Разрешить" доступ.
{{ :external:qr_меню:04_оповещения_для_персонала:pasted:20211108-154719.png |}}
Результатом успешного запуска является вот такое окно
{{ :external:qr_меню:04_оповещения_для_персонала:pasted:20211108-154739.png |}}
Так же можно проверить работу web интерфейса перейдя по адресу [[http://127.0.0.1:11014/|http://127.0.0.1:11014/]]
{{ :external:qr_меню:04_оповещения_для_персонала:2026-04-20_12-18-04.png?800 |}}
После проверки рекомендуется закрыть приложение и установить его службой запустив install.bat и далее перейти в службы Windows и запустить "Carbis QRMenu Telegram Notification"
Лицензирование данного модуля - не требуется.
==== Возможные проблемы ====
По умолчанию, модуль использует порт 11014. Если этот порт занят, то приложение не будет работать.
Изменить номер используемого порта можно в файле "qrmenu_notification_settings.yaml" в параметре "server_settings" -> "port". Данный файл отсутствует в дистрибутиве и создается автоматически при первом запуске модуля.
===== Настройка =====
Все настройки модуля производятся через web интерфейс доступный по адресу [[http://127.0.0.1:11014/|http://127.0.0.1:11014/]]
{{ :external:qr_меню:04_оповещения_для_персонала:2026-04-20_11-52-24.png?800 |}}
==== Настройки -> QR-меню ====
* Ввести IP адрес компьютера на котором установлена служба "Carbis QRMenu Agent"
* Ввести порт.
* Указать токен экземпляра QR меню с которым мы собираемся работать.
Посмотреть его можно в административной части qr-меню (по умолчанию [[http://127.0.0.1:11010/|http://127.0.0.1:11010/]] в разделе Параметры системы -> Регистрация на сервере приложений -> Секретный ключ.
{{ :external:qr_меню:04_оповещения_для_персонала:pasted:20211108-163134.png?800 |}}
Результатом корректной настройки является следующее состояние
{{ :external:qr_меню:04_оповещения_для_персонала:2026-04-20_11-53-51.png?800 |}}
==== Настройки -> Уведомления====
=== Telegram ===
* Создать бота как описано в статье [[external:zz_дополнительные_материалы:01_telegram_bot|Создание Бота в Telegram]]
* Ввести токен бота в настройки
* Сохранить и проверить
{{ :external:qr_меню:04_оповещения_для_персонала:2026-04-20_12-09-40.png?800 |}}
=== Max ===
Данная настройка доступна с версии v1.0.4.21.
* Создать бота как описано в статье [[external:zz_дополнительные_материалы:11_for_max|Создание бота в MAX]]
* Ввести токен бота в настройки
* Сохранить и проверить
{{ :external:qr_меню:04_оповещения_для_персонала:2026-04-20_12-12-35.png?800 |}}
==== Настройки -> Система ====
* Порт на котором работает служба "Carbis QRMenu Telegram Notification"
* Язык интерфейса и сообщений в боте (при необходимости можно сделать собственную локализацию модуля на нужный язык ([[external:qr_меню:05_локализация:01_admin|Локализация служебных модулей]])
* Уровень логирования
После сохранения новых настроек необходимо перезапустить службу "Carbis QRMenu Telegram Notification" для того что бы изменения вступили в силу
{{ :external:qr_меню:04_оповещения_для_персонала:2026-04-20_12-16-13.png?800 |}}
===== Регистрация персонала =====
1. Каждого сотрудника, который должен получать уведомления от бота необходимо зарегистрировать через "список работников". (По умолчанию доступны все сотрудники которые есть в справочнике "Работники" системы r_keeper)
Сотрудников можно отфильтровать:
* Фильтр "На смене" позволяет отобразить только тех сотрудников, которые зарегистрированы в текущей смене на кассе.
* Фильтр "Нет в системе уведомлений" позволяет отобразить только тех сотрудников, которые еще не зарегистрированы в боте.
{{ :external:qr_меню:04_оповещения_для_персонала:2026-04-20_12-20-00.png?800 |}}
2. Далее необходимо выбрать в списке нужного сотрудника и для него будет сгенерирован персональный qr-код. (Qr-код - ссылка для подключения к боту. Саму ссылку можно отправить сотруднику любым удобным способом).
3. Сотрудник, на своем телефоне считывает этот QR код (или переходит по ссылке) и подключается к боту.
{{ :external:qr_меню:04_оповещения_для_персонала:2026-04-20_12-21-57.png?800 |}}
* Если вы удалите или деактивируете учетную запись сотрудника в системе r_keeper - бот перестанет с ним общаться.
* Если вы приняли на работу нового сотрудника, то вам необходимо завести его как работника в справочнике r_keeper и после этого показать ему персональный qr-код.
===== Использование =====
**Общий принцип отправки уведомлений**
Когда происходит событие для которого мы не можем определить конкретного получателя - уведомление получат все сотрудники, зарегистрированные в смене на кассе r_keeper.
Пример: Гость сел за стол №5, отсканировал qr-код, и сделал заказ.
На кассе r_keeper будет создан стол №5 и наполнен заказанными блюдами. Но т.к. на этот стол еще не назначен официант, то уведомление получает все сотрудники в смене.
Когда происходит событие связанное со столом за которым уже закреплен официант (например гости самостоятельно рассчитались через qr-меню за свой заказ) уведомление получит только один сотрудник (тот кто является официантом данного заказа)
События, по которым приходят уведомления:
* Сделан новый заказ.
* Сделан дозаказ.
* Заказ оплачен гостем самостоятельно через QR-меню.
{{:external:qr_меню:04_оповещения_для_персонала:pasted:20211127-142222.png?300}} {{:external:qr_меню:04_оповещения_для_персонала:pasted:20211127-142237.png?300}}
{{:external:qr_меню:04_оповещения_для_персонала:pasted:20211127-142250.png?300}} {{:external:qr_меню:04_оповещения_для_персонала:pasted:20211127-142258.png?300}}
{{:external:qr_меню:04_оповещения_для_персонала:pasted:20211127-142305.png?300}} {{:external:qr_меню:04_оповещения_для_персонала:pasted:20211127-142311.png?300}}
==== История версий ====
1.0.4.23 (29.04.25)
* Добавлено оповещения о корректности соединения
1.0.4.21 (20.04.25)
* Добавлен мессенджер МАХ
1.0.3.18 (12.12.2025)
* Добавлено поле "Комментарий" в оповещении при заказе и дозаказе блюд.
1.0.2.16 (22.06.2023)
* Расширенно логирование
* Теперь при ошибке отправки сообщения одному из сотрудников (при отправке уведомления всем), очередь отправки не отчищается
1.0.1.15 (08.04.2022)
* Возможность установить службой несколько экземпляров приложения на одном устройстве. **Важно!** В обязательном порядке необходимо удалить службу версии ниже текущей.
* Динамическое обновление списка сотрудников. Теперь не нужно обновлять страницу после регистрации сотрудника, чтобы он отобразился как зарегистрированный.