Подключение бота в канал 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. Например, действие будет содержать следующие сведения, где команда и данные соответствуют сведениям о карта бот, отправляемый изначально.

   JSON

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

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

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

   JSON

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

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

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

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

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