Перейти к содержанию

Инструкция по включению опции установки связи чата Мессенджера с чатом MAX

Назначение документа

В документе описана настройка связи чата Мессенджера с чатом MAX.

Создание связи между чатами приложений предоставляет:

  • Возможность коммуникации пользователей корпоративного сервиса Мессенджер c физлицами или пользователями из других компаний без Мессенджера.
  • Возможность переписки и обмена файлами в групповых чатах, в которых состоят пользователи Мессенджера и MAX.

Верхнеуровневое описание взаимодействия

Общая схема взаимодействия при установке связи между чатами:

max-integration-5

Взаимодействие между чатами выполняется с помощью сервиса Pigeon, который осуществляет перенаправление сообщений из бота Мессенджера в бот MAX и в обратном направлении.

Общее описание взаимодействия:

  1. При создании связи между чатами создается отдельный мост для каждого соединения. Все созданные связи (мосты) хранятся в хранилище соединений между чатами -- Tarantool.

  2. Передача и получение сообщений осуществляется через ботов, между которыми установлена связь.

  3. При отправке сообщений бот отправляет запрос в Router для получения данных установленной связи между чатами из Tarantool.

  4. После получения данных из Tarantool, Router отправляет сообщение боту мессенджера, с которым установлена связь.

Включения опции установки связи с чатом MAX

  1. В конфигурационном файле /usr/local/etc/k8s/helmwave/store/pigeon.yml добавьте полученный токен бота MAX в поле token и включите возможность установки связи с MAX установив enabled: true в блоке max.

    botSettings:
  max:
    enabled: false # включение возможности связывать с max
    token: <токен max бота>
  vkt:
    enabled: true # включение возможности связываться с внешними мессенджерами. Для начала работы должно быть в true
  proxy:
    url: '' # http адрес прокси, если требуется для связи с внешним интернетом

  2. В конфигурационном файле /usr/local/etc/k8s/helmwave/projects.yml включите сервис pigeon.

        # Окружения
envs:
  all:
    projects:
      disabled:
    ...
        #pigeon: # для включения убрать символ `#`
    ....

  3. Примените изменения, выполнив команду:

    hwup -t pigeon

  4. В Супераппе перейдите на вкладку Мессенджера и выполните поиск Bridgebot и назначьте владельца.

  5. В Мессенджере выполните поиск Metabot, в меню бота выполните: Разрешить боту добавляться в чаты -> введите botid или ник созданного бота -> enable.