Содержание

Установка и настройка

Данная статья является устаревшей. Актуальная документация по установке и настройке модуля:ProDiscoBot

Создание бота

О том как завести своего бота подробно написано тут

Настройка HTTP XML интерфейса

Описано в статье Настройка XML интерфейса

Настройка пользователя для HTTP XML интерфейса

  1. Перейдите в справочник «Персонал → Работники»
  2. В рамках текущего ресторана выберите или создайте новую роль, дайте ей привилегию на объект «HTTP Access» (или ту что вы завели в прошлом разделе) в группе параметров «Менеджерские ограничения»
  3. Для выбранной роли создайте пользователя с названием строго из ЛАТИНСКИХ букв, задайте пользователю пароль (цифры и латинские буквы).

Важно! От имени этого работника в заказ будет добавляться информация о пресональной карте гостя, убедитесь что у данной роли есть права на «Общие операции», «Пользовательские операции» и «Редактирование заказа».

Свойство «Телефон» у работников

Для корректной работы бота ему требуются телефоны сотрудников, для этого нужно создать дополнительно поле работникам, где можно будет записывать их номера. Откройте справочник «Настройки → Настройка → Расширенные свойства». Выберите группу «Свойства для справочников» и создайте новый тип расширенных свойств «Телефон». Задайте системное имя «PhoneNumber» (регистр очень важен) и тип свойства «ANSI string».

Дважды кликните по полю «Список типов», чтобы открыть окно типов для расширенного свойства «Телефон», затем добавьте новый элемент и выберите из списка «Работники → Работник».

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

Настройка MCR алгоритма

Для применения кода бот использует MCR алгоритм, привязанный к логическому интерфейсу платежной системы.
В настройках MCR алгоритма необходимо указать тип устройства «Штрих код».

Настройка бота

Подготовка

В составе установочного пакета в папке redist находится VC_redist.x86. Установите его.
Если visual c++ уже установлен в системе - этот пункт можно пропутистить.

Конфигурация

Откройте файл config.ini и отредактируйте значения. Секция [telegram]:

Секция [r_keeper]:

Секция [log]

Пример конфигурационного файла:

[telegram]
; Токен бота, который должен выдать BotFather
token = <BOT_TOKEN>
 
[r_keeper]
; Адрес кассового сервера
addr = 127.0.0.1
; Порт кассового сервера (HTTP Data Port)
port = 15151
; Имя работника (не код!)
user = Username
; Пароль работника
pass = Password
; Код логического интерфейса платежной системы
interface = 12
; Код кассовой станции, от имени которой проходят операции
cash_station = 1
; Принимать ли ввод номера телефона для применения карты. (0 — только фотографии кодов, 1 — принимать также и ввод)
phone_numbers = 0
; Включить поддержку скидок "на место"
seat_discounts = 1
 
[log]
; Время жизни старых Log файлов в днях
retention = 7
; Уровень важности логируемых сообщений, высокий уровень логирования будет показывать
; только критичные ошибки программы, низкий — всю информацию о работе программы.
level = 1

Лицензирование и Запуск

  1. Запустить DiscoBot.exe с ключом /license (либо запустить license_form.bat, который делает то же самое), подождать несколько секунд и произвести лицензирование:
    1. В окне программы нажать кнопку «Лицензирование»
    2. В открывшемся окне ввести логин и пароль в системе лицензирования ГК «Карбис»
    3. В отобразившемся списке объектов, выбрать текущий, указать дополнительные параметры лицензии и нажать кнопку «Отправить»
    4. Программа сообщит об успешном применении лицензии и закроет окно лицензирования
    5. После синхронизации данных с сервером лицензирования, в главном окне программы отобразятся данные о текущей лицензии
    6. Убедившись, что лицензия установлена корректно, закрыть окно программы.
  2. Установить DiscoBot.exe с ключом /install (либо запустить install.bat)
  3. Запустить службу CarbisDiscoBot

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

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