JAICP

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


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

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

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

Создание канала в 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.

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

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

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