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

Статья
10/24/2023

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

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

Примечание.

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

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

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

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

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

Примечание.

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

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

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

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

Важно!

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

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

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

Когда пользователь отвечает на карта в электронной почте, Outlook отправляет в бот действие вызова. Свойство действия value содержит объект действия со свойствами и verbdata свойствамиtype. Например, действие будет содержать следующие сведения, где команда и данные соответствуют сведениям о карта бот, отправляемый изначально.
```
"type": "invoke",
"name": "adaptiveCard/action",
"value": {
  "action": {
    "type": "Action.Execute",
    "verb": "<DEVELOPER_DEFINED_VERB>",
    "data": {
      // DEVELOPER_DEFINED_PROPERTIES
    }
  },
}
```
См. инструкцию Action.Execute в Обозреватель схемы адаптивных карточек для полной схемы объекта.
Бот обрабатывает входящее действие вызова и возвращает результат, включающий новую адаптивную карточку, которая будет проходить на месте исходной адаптивной карточки. Ответ вызова может выглядеть следующим образом:
```
{
  "statusCode": 200,
  "type": "application/vnd.microsoft.card.adaptive",
  "value": <UPDATED_ADAPTIVE_CARD>
}
```

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

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

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

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

Поделиться через