Artix:TgBot предназначен для управления рекламными акциями и рассылками, а также для взаимодействия с клиентами через мессенджер.

Установка сервисов возможна как на кассовый сервер, так и на отдельные машины.

Для использования Artix:TgBot требуется установленный бонусный сервер.

Установка Artix:TgBot

Для использования Artix:TgBot может потребоваться установка дополнительных сервисов:

  • artixcs-issuance-card – для создания виртуальных карт клиентов,
  • artix-loyalty-plugin-telegram – для рассылки промо и сообщений.

  1. Для установки Artix:TgBot необходимо скачать и запустить скрипт установки:

    curl https://update.artix.su/static/cs/install_scripts/stable/telegram_bot/install.sh -o /tmp/install.sh
chmod +x /tmp/install.sh
/tmp/install.sh

  2. Для проверки состояния Artix:TgBot можно выполнить команду:

    service artixcs-telegram-bot status

  3. Для управления Artix:TgBot необходимо установить плагин, выполнив команду. Подробнее об этом можно прочитать в разделе "Управление рассылкой сообщений через Artix Loyalty Management".

    aptitude install artix-loyalty-plugin-telegram

  4. Для возможности регистрации пользователя необходимо установить сервис выдачи карт. Подробнее об этом можно прочитать в разделе "Сервис выдачи карт".

    apt-get install artixcs-issuance-card

Настройка Artix:TgBot

Получение токена

Для получения токена необходимо:

  1. В приложении Telegram найти и запустить бота @BotFather.
  2. Выбрать команду /newbot и задать имя для будущего бота.
  3. Скопировать полученный токен.

Настройка конфигурационного файла

Настройка работы Artix:TgBot осуществляется в конфигурационном файле application.properties. Подробнее об этом можно прочитать в разделе "Руководство администратора".

Для работы с Artix:TgBot необходимо в конфигурационном файле /opt/artixcs-telegram-bot/application.properties:

  1. Указать токен, полученный от бота @BotFather:

    su.artix.telegram.bot.token = <полученный токен>

  2. Указать порт бонусного сервера (artixcs-accounting-bonuses или artixcs-accounting-bonuses-certificates). Подробнее об этом можно прочитать в разделе "Список пакетов и образов".

    su.artix.telegram.bot.accountingservice.prefix = http://<IP-адрес бонусного сервера>:<порт бонусного сервера>/ACC/rest/v1/
  3. Лицензировать продукт одним из доступных способов:

    • Указать идентификационный номер юридического лица для авторизации на сервере лицензий. Подробнее об этом можно прочитать в разделе "Лицензирование".

      licencecenter.contragentId = <идентификационный номер юридического лица>
    • Поместить файл лицензии licence.li4 в директорию /opt/artixcs-telegram-bot/licence/.
  4. Разрешить пользователю управление Telegram-ботом через плагин во вкладке "Роли пользователей" в разделе "Настройки сервера" Artix Control Center. Подробнее об этом можно прочитать в разделе "Настройки сервера".

  5. Перезапустить сервис:

    systemctl restart artixcs-telegram-bot


  • No labels