search string side menu

ELMA Bot > Установка и интеграция конструктора ELMA Bot / Настройка интеграции конструктора ELMA Bot с ELMA365

Настройка интеграции конструктора ELMA Bot с ELMA365

Чтобы подключать к линиям ботов, созданных в конструкторе ELMA Bot, настройте интеграцию одним из следующих способов:

  1. При помощи Х‑токена конструктора ELMA Bot.

Такой вариант подключения доступен для всех поставок ELMA365. Он выполняется в разделе Администрирование > Линии > Боты. При этом способе интеграции пользователи ELMA365 должны быть предварительно авторизованы в конструкторе ELMA Bot, чтобы переходить в него по ссылкам из настроек линии или раздела Администрирование > Линии > Боты.
Для редакции ELMA365 On‑Premises Standard, установленной в Kubernetes‑in‑Docker (KinD), вы можете настроить интеграцию с конструктором ELMA Bot только через его Х-токен.

начало внимание

Подключение конструктора ELMA Bot с помощью его X‑токена доступно, если включён фича-флаг allowElmaBotXTokenAuth. Подробнее читайте в статьях «Изменение параметров ELMA365 Enterprise» и «Изменение параметров ELMA365 Standard». Если вы используете поставку SaaS, для включения фича-флага обратитесь к вашему менеджеру ELMA365.

конец внимание

  1. Через микросервис Hydra.

Если вы используете поставку ELMA365 On‑Premises, установленную в Kubernetes‑кластер, вы можете настроить интеграцию на уровне Helm‑чартов. Тогда пользователи ELMA365 будут автоматически авторизовываться в конструкторе ELMA Bot при переходе по ссылкам из настроек линии или раздела Администрирование > Линии > Боты.

Интеграция при помощи Х-токена конструктора ELMA Bot

При активации решения ELMA365 Service во всех поставках ELMA365 можно подключить конструктор ELMA Bot с помощью его Х‑токена. После этого в настройках линий станут доступны боты подключённого конструктора.

Чтобы подключить конструктор ELMA Bot, выполните шаги:

  1. В ELMA365 перейдите в Администрирование > Линии > Боты.
  2. В правом верхнем углу страницы нажмите + Конструктор ELMA Bot.
  3. В открывшемся окне заполните поля:

integrate-chatbot-builder-1

  • Название* — укажите название подключения конструктора ELMA Bot;
  • URL* — откройте ELMA Bot в браузере и скопируйте его адрес из адресной строки. Например:
    • https://elma365.[адрес ELMA Bot] — для режима с поддоменами;
    • https://[адрес ELMA Bot]/elma365 — для режима с подпутями.
      Режимы определяются при установке конструктора ELMA Bot. Подробнее об этом читайте в статье «Установка ELMA Bot в Kubernetes»;
  • X-Token* — токен конструктора ELMA Bot. Он указан на вкладке API любого бота, который создан в конструкторе ELMA Bot.
  1. Нажмите Добавить. Теперь ботов подключённого конструктора можно выбрать в настройках линии.

Интеграция при помощи микросервиса Hydra

Если ELMA365 On‑Premises и ELMA Bot On‑Premises установлены в Kubernetes‑кластер при помощи Helm‑чартов, вы можете подключить конструктор ELMA Bot, используя микросервис Hydra. Для этого выполните следующие условия:

  • cо стороны ELMA365:
    • установить с TLS;
    • настроить сервисы elmabot-proxy, hydra-adaptor, settings;
    • активировать лицензии платформы и ELMA365 Service;  
  • cо стороны ELMA Bot:
    • включить провайдер авторизации (сервис Hydra);
    • настроить параметры global.elma365Integration.

Затем задайте настройки интеграции.

Пример настройки интеграции ELMA365 и ELMA Bot

  1. Настройки файла values.yaml в Helm-чарте ELMA365:

elmabot-proxy:
 appconfig:
   apiUrl: https://elma365.example.com
   grantType: elma.assistant.auth.grants.impersonation.elma365
   identityServerUrl: https://auth.example.com
   oidcUri: example.com
   scope: elma.assistant.scopes.api.gateways.elma365 elma.assistant.scopes.auth.impersonation
hydra-adaptor:
 appconfig:
   client_id: elma.assistant.clients.external.elma365.server
   client_secret: wvmtLu1KAvf8XjtULBFJ3DP0eB
   hydraAdminURL: http://hydra-admin:4445
   loginEndpoint: https://example.com/ext-api/oidc-adaptor/login
settings:
 appconfig:
   onPremiseCustomEnabledFeatureFlags:
   - allowLinesBots

  1. Настройки файла values.yaml в Helm-чарте ELMA Bot:

global:
  elma365Integration:
    clientSecret: wvmtLu1KAvf8XjtULBFJ3DP0eB
    elma365Uri: example.com
    elma365TlsSecret: example-com-tls
  host: example.com
  ingress:
    existingTLSSecret: example-com-tls
 
hydra:
  enabled: true

После настройки интеграции ELMA Bot с ELMA365, вы можете подключать ботов к линиям.

Страница с подключённым конструктором ELMA Bot

Когда интеграция с конструктором ELMA Bot настроена, вы можете посмотреть, какие боты есть в конструкторе и к каким линиям они подключены. Для этого перейдите в ELMA365 и в разделе Администрирование > Линии > Боты нажмите значок integrate-chatbot-builder-3 рядом с названием конструктора ELMA Bot, чтобы развернуть таблицу и увидеть список его ботов.

integrate-chatbot-builder-2

Если интеграция с ELMA Bot настроена через микросервис Hydra, на странице отобразится Конструктор по умолчанию. Для конструктора ELMA Bot, который подключён к ELMA365 через Х‑токен, название задаётся при настройке интеграции.

Напротив названия подключённого конструктора ELMA Bot можно использовать следующие опции:

  • нажмите значок трёх точек и выберите:
    • Редактировать — изменить название настроенного подключения;
    • Удалить — разорвать связь с конструктором. Тогда боты станут недоступны в линиях.
      Эти действия доступны только для конструктора ELMA Bot, который подключён к ELMA365 через Х‑токен.

Вы также можете открыть страницу любого бота. Для этого нажмите на его название. Если бот подключён к линии, доступна ссылка для перехода в её настройки.

elma-bot-in-private-registry.html