Различия

Показаны различия между двумя версиями страницы.

--- external:carbistbot [2021/01/15 11:17] – Александр Ильин
+++ external:carbistbot [2025/01/24 11:29] (текущий) – Юлия Иванова
@@ Строка 1: / Строка 1: @@
 ====== Carbis Telegram Bot ======
+\\
+\\
+\\
+\\
+\\
+\\
+Это статья по настройке устаревшего ПО.
+**Актуальная информация по настройке телеграм-бота для r_keeper: [[https://wiki.carbis.ru/external/pro_alert|Настройка ProAlert]]**
+\\
+\\
+\\
+\\
+\\
+\\
+\\
+\\
+\\
+\\
+\\
+\\
+\\
 ----
 **Описание:** Модуль предназначен для Владельцев и Управленцев. В чат мессенджера Telegram в режиме реального времени отправляется следующая информация:
-  - Удаление и аннуляция чека.
+   - Удаление и аннулирование чека.
   - Отмена пречека.
   - Удаление блюда.
   - Удаление не сохраненного блюда (актуально для ФастФуда, можно отключить для классического ресторана что бы не засорять чат).
   - Автоотчет при закрытии общей смены (системный балансовый + расход блюд + продажи по часам + скидки + удаления). Набор присылаемых отчетов настраивается индивидуально средствами r_keeper (автоотчет общей смены)
+  - Так же в любой момент можно запросить и получить в режиме он-лайн любые кассовые отчеты: Баланс, Расход, Скидки, Удаления и т.п. (список доступных отчетов настраивается индивидуально)
-Так же в любой момент можно запросить и получить в режиме он-лайн любые кассовые отчеты: Баланс, Расход, Скидки, Удаления и т.п. (список доступных отчетов настраивается индивидуально)
+Вы можете оценить работу данного системы на Демо примере. В этом чате отображаются события происходящие в реальном ресторане (ФИО работников обезличены). Что бы присоединиться к Демо-чату отсканируйте данный QR Код {{  :external:pasted:20210118-153420.png?300  }}Или перейдите по ссылке [[https://t.me/joinchat/SE1lC-t8K_iMtxtd|Демо-Бот]]
 Для сетевых предприятий (несколько MID серверов) можно иметь отдельные чаты по каждому ресторану (для локальных управленцев), а так же общий чат (для владельцев), куда будут собираться сообщения из всех ресторанов и где можно запросить любой отчет из любого ресторана.
-**Стоимость:** 1000 рублей/мес (SaaS).\\
-Лицензия генерируется на MID сервер:
-  * Если в Ресторане (классика) 1 МИД и на нем 10 станций, то это одна лицензия.
-  * Если в Ресторане 2 отдельных зала (2 концепции) и у каждого свой МИД, то это 2 лицензии.
-**Скидки** для дилеров UCS и сетевых объектов.\\
+**Скачать:**
+Презентация решения {{ :external:horeca_carbis_proalert.pdf |}}
+[[https://disk.yandex.ru/d/mMWksLeuqO8Rmw|Актуальный дистрибутив]]
-**Скачать:**\\
-[[http://soft.carbis.ru/download/CarbisTBot%20(HoReCa).pdf|Презентация решения]]\\
-[[https://yadi.sk/d/Ce61YT4tIRZkzA|Актуальный дистрибутив]]\\
-[[https://t.me/joinchat/SE1lC-t8K_iMtxtd|Демо-Бот подключенный к реальному ресторану]]
 ----
-{{:external:tbot1.png?200}} {{:external:tbot2.png?200}} {{:external:tbot3.png?200}}
+{{:external:tbot1.png?200}}  {{:external:tbot2.png?200}}  {{:external:tbot3.png?200}}
 ----
-===== Состав дистрибутива =====
-  - Библиотеки для корректной работы(dll)
-  - Файл настроек config.ini
-  - Исполняемый файл для установки на кассовом сервере RestAgent.exe
-==== Файл настроек config.ini ====
-**Описание параметров:**
-^Секция^Параметр^Описание^Умолчания|
-|**RK7** |rkAddr|IP адрес компьютера, на котором работает кассовый сервер|127.0.0.1|
-| ::: |rkPort|Порт XML-интерфейса кассового сервера|2233|
-|**CORE** |ListenPort|Порт для инициализации TCP\IP сервера|8421|
-| ::: |LicAlertDays|Количество дней, после которого будут отправляться сообщения с предупреждением об окончании лицензии  |3|
-| ::: |PollRate|Периодичность опроса сервера для получения заданий|3|
-| ::: |AlarmOnDelUnPrinted|Нотификация об удалении нераспечатанного блюда|0|
-|**HOME** |PHPServerAddr|Адрес сервера с пулом задач|saturn.carbis.ru:12348/v2/|
-|**LOG** |LogLevel|Уровень логирования|2|
-| ::: |OldLogs|Максимальный возраст .log файлов в днях. Старые файлы подлежат удалению.|7|
-| ::: |LogMem|Логирование занимаемой памяти|1|
-=== Установка и лицензирование службы CarbisTBotRestAgent.exe ===
-  - Запустить CarbisTBotRestAgent.exe с ключом /desktop и произвести лицензирование: \\ 1.1 В окне программы нажать кнопку "Лицензирование" \\ 1.2 В открывшемся окне ввести логин и пароль в системе лицензирования ГК Карбис \\ 1.3 В отобразившемся списке объектов, выбрать текущий, указать дополнительные параметры лицензии и нажать кнопку "Отправить" \\ 1.4 Программа сообщит об успешном применении лицензии и закроет окно лицензирования \\ 1.5 После синхронизации данных с сервером лицензирования, на главно окне программы отобразятся данные о текущей лицензии \\ 1.6 Убедившись, что лицензия установлена корректно, закрыть окно программы.
-  - Установить CarbisTBotRestAgent.exe с ключом /install и запустить службу CarbisTBotRestAgent \\
-**ВНИМАНИЕ!** \\
-Перед запуском и лицензированием убедитесь, что файл server.bin не пустой.\\
-В ином случае будет невозможно получить лицензию.
-**ВАЖНО!**\\
-Дальнейшее **продление лицензии** на модуль "CarbisTBot" делается **ТОЛЬКО** через сайт лицензирования ([[lic:main#продление_лицензий|инструкция]])
-----
-===== Настройки r_keeper =====
-  - Создать XML интерфейс на кассовом сервере, в свойствах задать ему свободный порт, записать номер порта в config.ini в параметр xmlPort{{  :external:carbistbot:2.png?nolink&  }}
-  - Создать логический интерфейс и связать его с XML интерфейсом{{  :external:carbistbot:1.png?nolink&  }}
-  - На каждой кассе добавить I/O порт Print to TCP/IP printer. В свойствах указать ip адрес машины, на которой установлен RestAgent.exe, и порт из config.ini параметра 'ListenPort'
-  - Добавить порт в исключения брандмауэра
-  - **В свойствах драйвера "Print to TCP/IP printer" установить параметр "Keep connect" = "Yes"**
-  - В I/O порте Print to TCP/IP printer на каждой кассе добавить принтер PlainText, активировать его в принтерах
-  - На каждой кассе в назначении принтеров "для XML отчетов" указать ранее созданные принтеры {{  :external:carbistbot:5.png?nolink&  }}
-  - Если есть станция печати, создать I/O порт Print to TCP/IP printer, на него также повесить принтер PlainText. Этот принтер будет использоваться для отправки отчетов о закрытии смены.
-  - Если станции печати нет, выбрать ранее созданный принтер на главной кассе, этот принтер будет использоваться для отправки отчетов о закрытии смены.
-  - В свойствах ресторана в назначении принтеров указать ранее созданный принтер для автозакрытия смены {{  :external:carbistbot:4.png?nolink&  }}
-  - В свойствах автоотчёта общей смены(Настройки→Печать→Схемы печати) указать требуемые макеты отчетов {{  :external:carbistbot:6.png?nolink&  }}
-**ВАЖНО**  Необходима перезагрузка кассового сервера после добавления на него интерфейса. При добавлении интерфейса на станцию печати также перезагрузить станцию печати
-----
-===== Создание группы в telegram =====
-  - Создать группу
-  - Добавить бота @CarbisTBot в группу
-  - Дать ему права админа с возможностью добавления новых админов
-  - Удалить @CarbisTBot из группы
-  - Добавить @CarbisTBot в группу снова (эти действия нужны для апгрейда группы в супергруппу и корректной работы бота)
-  - Бот сообщит ID текущего чата для создания дальнейшей связки с рестораном.
-----
-===== Подключение ресторана к чату =====
-[[http://wiki.carbis.ru/doku.php?id=internal:int_soft:tbot_admin|Для инженеров ГК "Карбис". Описание настройки на стороне сервера отправки сообщений. (настройка чатов, групп, и доступных в чате отчетов)]]
-Для подключения ресторана к чату необходимо направить в службу технической поддержки ГК Карбис [[mailto:zakaz@carbis.ru|письмо]], с названием ресторана и ID чата, полученным от бота в предыдущем пункте инструкции. Кроме того, необходимо указать нужные отчеты и их коды (можно посмотреть в менеджерской настройки→печать→документы и макеты). Нужны именно коды макетов, а не коды "представлений".
-Пример письма:
-<code sql>
-Прошу в системе CarbisTBot подключить уведомления от ресторана "Рога и Копыта"
-к чату -22212458754,
-а так же сделать доступными из чата следующие отчеты:
-Расход блюд по категориям код - 10940
-Скидки и наценки код - 52
-Удаления чеков код - 50
-Системный балансовый отчет код - 10771
-</code>
-В ответ Вы получите дальнейшие инструкции от службы технической поддержки.
-**P.S. В случае, если необходимо подключить ресторан к нескольким чатам, для повышения оперативности обработки заявок просим перечислять все чаты в одном письме.**
-----
-===== Команды бота =====
-  * /start@CarbisTBot - вывести стартовую клавиатуру
-  * /getversion@CarbisTBot - показать информацию о версии
-----
-===== Начало работы =====
-Для отображения списка отчетов отправить команду /start в чат
-\\