Это статья по настройке устаревшего ПО.
Актуальная информация по настройке телеграм-бота для r_keeper: Настройка ProAlert

Актуальный дистрибутив

- Библиотеки для корректной работы (dll)

1. Файл настроек config.ini
2. Исполняемый файл для установки на кассовом сервере RestAgent.exe

Описание параметров:

1. Запустить CarbisTBotRestAgent.exe с ключом /desktop и произвести лицензирование:
   1.1 В окне программы нажать кнопку «Лицензирование»
   1.2 В открывшемся окне ввести логин и пароль в системе лицензирования ГК Карбис
   1.3 В отобразившемся списке объектов, выбрать текущий, указать дополнительные параметры лицензии и нажать кнопку «Отправить»
   1.4 Программа сообщит об успешном применении лицензии и закроет окно лицензирования
   1.5 После синхронизации данных с сервером лицензирования, в главном окне программы отобразятся данные о текущей лицензии
   1.6 Убедившись, что лицензия установлена корректно, закрыть окно программы.
2. Установить CarbisTBotRestAgent.exe с ключом /install и запустить службу CarbisTBotRestAgent

ВНИМАНИЕ!
Перед запуском и лицензированием убедитесь, что файл server.bin не пустой.
В ином случае будет невозможно получить лицензию.

ВАЖНО!
Дальнейшее продление лицензии на модуль «CarbisTBot» делается ТОЛЬКО через сайт лицензирования Инструкция

1. Создать XML интерфейс на кассовом сервере, в свойствах задать ему свободный порт, записать номер порта в config.ini в параметр xmlPort
   

1. Создать логический интерфейс и связать его с XML интерфейсом
2. На каждой кассе добавить I/O порт Print to TCP/IP printer. В свойствах указать ip адрес машины, на которой установлен RestAgent.exe, и порт (8421) из config.ini параметра 'ListenPort'
3. Добавить порт в исключения брандмауэра
4. В свойствах драйвера «Print to TCP/IP printer» установить параметр «Keep connect» = «Yes»
5. В I/O порте Print to TCP/IP printer на каждой станции r_keeper добавить принтер PlainText, активировать его в принтерах
6. На каждой станции r_keeper в назначении принтеров «для XML отчетов» указать ранее созданные принтеры
7. Если есть станция печати, создать I/O порт Print to TCP/IP printer, на него также повесить принтер PlainText. Этот принтер будет использоваться для отправки отчетов о закрытии смены.
8. Если станции печати нет, выбрать ранее созданный принтер на главной кассе, этот принтер будет использоваться для отправки отчетов о закрытии смены.
9. В свойствах ресторана в назначении принтеров указать ранее созданный принтер для автозакрытия смены
10. В свойствах автоотчёта общей смены(Настройки→Печать→Схемы печати) указать требуемые макеты отчетов

ВАЖНО Необходима перезагрузка кассового сервера после добавления на него интерфейса. При добавлении интерфейса на станцию печати также перезагрузить станцию печати

1. Создать группу
2. Добавить бота @CarbisTBot в группу
3. Дать ему права админа с возможностью добавления новых админов
4. Удалить @CarbisTBot из группы
5. Добавить @CarbisTBot в группу снова (эти действия нужны для апгрейда группы в супергруппу и корректной работы бота)
6. Бот сообщит ID текущего чата для создания дальнейшей связки с рестораном.

Для инженеров ГК "Карбис". Описание настройки на стороне сервера отправки сообщений. (настройка чатов, групп, и доступных в чате отчетов)

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

Пример письма:

Прошу в системе CarbisTBot подключить уведомления от ресторана "Рога и Копыта"
к чату -22212458754,
а так же сделать доступными из чата следующие отчеты:
 
Расход блюд по категориям код - 10940
Скидки и наценки код - 52
Удаления чеков код - 50
Системный балансовый отчет код - 10771

В ответ Вы получите дальнейшие инструкции от службы технической поддержки.

P.S. В случае, если необходимо подключить ресторан к нескольким чатам, для повышения оперативности обработки заявок просим перечислять все чаты в одном письме.

• /start@CarbisTBot - вывести стартовую клавиатуру
• /getversion@CarbisTBot - показать информацию о версии

Для отображения списка отчетов отправить команду /start в чат

Для инженеров - после настройки в телеграм-чате обязательно:

1) передать полные максимальные права на администрирование заказчику;

2) в чате сделать ссылку-приглашение и записать её в задаче на настройку и в карточке компании - если в дальнейшем потребуется что-то проверить - можно будет попасть в чат по этой ссылке;

Управление группой - пригласительные ссылки.

«Защитник Windows» часто считает exe-файл телеграм-бота вирусом и склонен его удалять. При этом касса r_keeper начнет немного тормозить при работе с заказом (т. к. не сможет отправлять данные боту). Рекомендуется сразу добавить папку с ботом в исключения антивируса.

Название объектов в боте берется из lic.carbis.ru, и не всегда название помещается на экране телефона. Учитывать при создании объекта.

Спецсимволы в названии ресторана «съедаются» при отображении в телеграм-боте.