Carbis Telegram Bot [База знаний ГК Карбис]

Эта страница только для чтения. Вы можете посмотреть её исходный текст, но не можете его изменить. Сообщите администратору, если считаете, что это неправильно.
====== Carbis Telegram Bot ======

----
**Описание:** Модуль предназначен для Владельцев и Управленцев. В чат мессенджера Telegram в режиме реального времени отправляется следующая информация:

  - Удаление и аннуляция чека.
  - Отмена пречека.
  - Удаление блюда.
  - Удаление не сохраненного блюда (актуально для ФастФуда, можно отключить для классического ресторана что бы не засорять чат).
  - Автоотчет при закрытии общей смены (системный балансовый + расход блюд + продажи по часам + скидки + удаления). Набор присылаемых отчетов настраивается индивидуально средствами r_keeper (автоотчет общей смены)

Так же в любой момент можно запросить и получить в режиме он-лайн любые кассовые отчеты: Баланс, Расход, Скидки, Удаления и т.п. (список доступных отчетов настраивается индивидуально)

Для сетевых предприятий (несколько MID серверов) можно иметь отдельные чаты по каждому ресторану (для локальных управленцев), а так же общий чат (для владельцев), куда будут собираться сообщения из всех ресторанов и где можно запросить любой отчет из любого ресторана.

**Стоимость:** 1000 рублей/мес (SaaS).\\
Лицензия генерируется на MID сервер:
  * Если в Ресторане (классика) 1 МИД и на нем 10 станций, то это одна лицензия.
  * Если в Ресторане 2 отдельных зала (2 концепции) и у каждого свой МИД, то это 2 лицензии.

**Скидки** для дилеров UCS и сетевых объектов.\\

**Скачать:**\\
[[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}}

----

===== Состав дистрибутива =====

  - Библиотеки для корректной работы(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 в чат

\\