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

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

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

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

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

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

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

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

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

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

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

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.

Технический писатель: Дмитрий Дерябин