Перейти к основному содержимому

Microsoft Teams как входящий канал

Microsoft Teams — корпоративная платформа, объединяющая в рабочем пространстве чат для работы над проектами, хаб для командной работы, заметки и вложения.

Чтобы подключить Microsoft Teams как входящий канал:

  1. Создайте канал в JAICP.
  2. Настройте Azure Bot Service.
  3. Настройте канал в JAICP.
  4. Протестируйте бота.

Создание канала в JAICP​

Перейдите в JAICP, нажмите на панели управления Каналы → Входящие → Подключить канал. В разделе Другие выберите Azure Bot.

Заполните поля:

  • Название — укажите название для канала или оставьте по умолчанию.
  • Токен — оставьте пустым.
  • Microsoft App ID — оставьте пустым.
  • Пароль — оставьте пустым.
  • Ветка — укажите ветку проекта, которую вы хотите развернуть в канал, по умолчанию master. Вы также можете выбрать Git-тег или ввести хеш конкретного коммита.
  • Оператор — выберите операторский канал или оставьте пустым.
  • Публикация — автоматически (после каждого сохранения внесенных в проект изменений) или вручную (с помощью кнопки Опубликовать в строке с описанием канала).
предупреждение
Публикацию сценария нужно выполнять перед запуском бота. На этом этапе происходит сборка бота, проверка синтаксиса сценариев и скриптов, а также проверка прохождения тестов.

Нажмите Создать. Под названием созданного канала нажмите Получить вебхук, он будет скопирован в буфр обмена. Скопированный вебхук необходим для настройки Azure Bot Service.

Azure Bot Service​

подсказка
Для подключения бота в Microsoft Teams к JAICP используется служба Azure Bot Service.

Зарегистрируйтесь и авторизуйтесь в сервисе Microsoft Azure. Выберите в разделе Azure services → Bot Services.

На верхней панели нажмите Add, далее выберите Bot Channels Registration. Нажмите Create.

Заполните поля:

  • Bot handle — уникальный идентификатор для вашего бота.
  • Subscription — выберите вариант подписки.
  • Resource group — выберите или создайте новую группу.
  • Location — выберите местоположение.
  • Messaging endpoint — вставьте вебхук, который вы скопировали ранее на этапе создания канала в JAICP.
подсказка
Остальные поля являются необязательными, заполните их по необходимости.

Нажмите Create.

Вернитесь на главную страницу Microsoft Azure. В разделе Recent resources нажмите на имя созданного бота → в левом меню нажмите Settings.

Здесь скопируйте поле Microsoft App ID. Скопированное значение понадобится на этапе настройки канала в JAICP.

Нажмите Manage напротив Microsoft App ID. Далее нажмите New client secret.

Заполните поля:

  • Description — описание для вашего секретного ключа.
  • Expires — период действия секретного ключа. По истечении выбранного срока понадобится перевыпуск ключа.

Скопируйте ключ из поля Value. Скопированное значение понадобится на этапе настройки канала в JAICP.

Настройка канала в JAICP​

Перейдите в JAICP. Нажмите напротив названия созданного канала → Редактировать. Теперь вы находитесь в настройках канала.

Здесь вставьте значение для полей Microsoft App ID и Пароль, которые вы ранее скопировали на этапе настройки Azure Bot Service.

Нажмите Сохранить.

Тестирование бота​

Перейдите в окно диалога с ботом в подключенном мессенджере и отправьте ему приветственную/активационную фразу, предусмотренную вашим сценарием. После этого должен начаться ваш диалог с ботом.