Подключение бота в канал Outlook для интерактивных сообщений (предварительная версия)

  • Статья

ОБЛАСТЬ ПРИМЕНЕНИЯ: ПАКЕТ SDK версии 4

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

Примечание.

Канал Outlook для сообщений с действиями находится в общедоступной предварительной версии. Функции, включенные в предварительную версию, могут быть не завершены и могут пройти изменения, прежде чем стать доступными в общедоступном выпуске. Они предоставляются только для оценки и изучения.

Предупреждение

Это нарушение кодекса поведения Bot Framework для создания "спам-ботов", включая ботов, которые отправляют нежелательные или незапрошенные массовые сообщения электронной почты.

Необходимые компоненты

  • Знание адаптивных карточек и универсальной модели действий.
  • Знакомство с действиями в группах Outlook и Office 365.
  • Бот, готовый к каналу, развернутый в Azure.
  • Выделенный адрес электронной почты, который будет использоваться ботом для отправки и получения сообщений.

Примечание.

  • Не используйте собственные личные учетные записи электронной почты для ботов, так как каждое сообщение, отправленное этой учетной записи электронной почты, будет перенаправлено боту. Это может привести к тому, что бот отправит неправильный ответ отправителю. Поэтому боты должны использовать только специальные учетные записи электронной почты O365.
  • Если вы используете Microsoft Exchange Server, включите автообнаружение перед настройкой канала электронной почты.

Проектирование сообщений

Канал Outlook для интерактивных сообщений отправляет и получает адаптивные карточки по электронной почте.

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

Важно!

Универсальная модель действий бота появилась в схеме адаптивных карточек версии 1.4. Чтобы использовать эти новые возможности, свойство версии адаптивной карточки должно иметь значение 1.4 или более поздней версии. См. действие.Execute в схеме адаптивных карточек Обозреватель.

Реализация и развертывание бота

Общий поток предназначен для бота для отправки активного сообщения пользователю, а затем обработки действия пользователя.

  1. Когда пользователь отвечает на карта в электронной почте, Outlook отправляет в бот действие вызова. Свойство действия value содержит объект действия со свойствами и verbdata свойствамиtype. Например, действие будет содержать следующие сведения, где команда и данные соответствуют сведениям о карта бот, отправляемый изначально.

    "type": "invoke",
"name": "adaptiveCard/action",
"value": {
  "action": {
    "type": "Action.Execute",
    "verb": "<DEVELOPER_DEFINED_VERB>",
    "data": {
      // DEVELOPER_DEFINED_PROPERTIES
    }
  },
}

    См. инструкцию Action.Execute в Обозреватель схемы адаптивных карточек для полной схемы объекта.

  2. Бот обрабатывает входящее действие вызова и возвращает результат, включающий новую адаптивную карточку, которая будет проходить на месте исходной адаптивной карточки. Ответ вызова может выглядеть следующим образом:

    {
  "statusCode": 200,
  "type": "application/vnd.microsoft.card.adaptive",
  "value": <UPDATED_ADAPTIVE_CARD>
}

Запрос на доступ

  1. Откройте ресурс бота в портал Azure.
  2. Откройте область "Каналы".
  3. Выберите канал Outlook.
  4. На странице "Настройка Outlook" выберите здесь.
  5. Заполните форму регистрации для запроса доступа. Дополнительные сведения см. в статье "Регистрация службы с помощью информационной панели разработчика электронной почты".

Следующие шаги