Обновление сообщения с действиями при открытии пользователем
Важно!
Подключение новых поставщиков сообщений с действиями с глобальной область временно приостановлено до 30 июня 2024 г. из-за обновления служб. Существующие глобальные поставщики и подключение поставщиков область для организации и тестирования не затрагиваются. Дополнительные сведения см. в разделе Часто задаваемые вопросы о сообщениях с действиями.
Интерактивные сообщения позволяют пользователям быстро выполнять действия с сообщением электронной почты, часто на основе данных, представленных в карта. Однако иногда данные изменяются после отправки сообщения с действиями. Например, служба может отправить несколько утверждающих сообщение с просьбой утвердить или отклонить запрос. Один утверждающий утверждает запрос, но сообщение в почтовом ящике другого утверждающего по-прежнему запрашивает утверждение. Теперь, используя autoInvokeAction
свойство для сообщений с действиями, вы можете предоставить конечную точку HTTP для получения актуальных полезных данных адаптивной карточки с последними сведениями, когда пользователь открывает сообщение электронной почты в Outlook.
Важно!
Обновление сообщения с действиями, когда пользователь открывает его, напрямую влияет на воспринимаемую производительность вашего решения для сообщений с действиями. Очень важно, чтобы служба, которая предоставляет обновленные карта соответствовала требованиям к производительности, описанным в разделе Реализация веб-API.
Службы сообщений с действиями, зарегистрированные на панели мониторинга разработчика с помощью тестового область пользователей или организации, могут использовать эту функцию сразу после утверждения. Если ваша служба зарегистрирована в Глобальной область, необходимо обратиться onboardoam@microsoft.com за этой функцией.
Чтобы использовать эту функцию, карта должны использовать формат адаптивной карточки. Свойство autoInvokeAction — это свойство Outlook, добавляемое к типу AdaptiveCard. Значением этого свойства является действие Action.Http с параметром method
POST
. Свойство url
указывает конечную точку веб-API в службе, которая будет предоставлять обновленные полезные данные адаптивной карточки.
{
"$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
"type": "AdaptiveCard",
"version": "1.0",
"body": [...],
"actions": [...],
"autoInvokeAction": {
"method": "POST",
"url": "https://actionablemessages.contoso.com/api/getupdatedcard",
"body": "",
"type": "Action.Http"
}
}
При использовании autoInvokeAction очень важно, чтобы начальные карта, включенные в сообщение, по-прежнему были ценными для конечного пользователя и, в идеале, были практическими. Может autoInvokeAction
произойти сбой, или сетевые условия могут замедлить его работу. В этом случае начальный карта будет отображаться конечным пользователем.
-
Не отправляйте пустой начальный карта только
autoInvokeAction
с . Такие карточки будут отклонены платформой actionable Message. - Не отправляйте начальное карта, которое является просто заполнителем, который просит пользователя подождать.
- Отправьте начальную карта, которая отображает сведения в текущем состоянии, даже если это означает, что пользователь может увидеть устаревшие данные к моменту открытия сообщения.
Действие Action.Http
, указанное в свойстве autoInvokeAction
, работает точно так же, как и любое другое Action.Http
действие. Дополнительные сведения о реализации конечной точки для этого действия см. в разделе Реализация веб-API.
Конечная точка для autoInvokeAction
также должна соответствовать следующим дополнительным требованиям.
- Запросы должны вернуться в течение 2 секунд.
- Запросы, которые занимают больше времени, будут игнорироваться клиентом, а исходные карта будут по-прежнему отображаться. Сообщение будет по-прежнему обновляться на сервере.
- Успешные ответы должны включать заголовок
CARD-UPDATE-IN-BODY
со значениемtrue
и полезные данные JSON адаптивной карточки.
После успешного выполнения возвращенная адаптивная карточка полностью заменит существующие карта в сообщении электронной почты. Если URL-адрес возвращает ошибку или время ожидания, существующие карта будут отображаться по-прежнему.
Рассмотрим этот пример запроса на отпуск карта, созданного средством запроса на отпуск и отправленного руководителю сотрудника.
Совет
Вы можете получить доступ к JSON и изменить этот пример карта, выбрав пример утверждения отпуска в Designer с интерактивным сообщением.
В карта содержатся сведения, помогающие руководителю принять решение, включая запрошенные даты и сколько осталось у сотрудника. Эта информация была точной при создании и отправке сообщения. Однако данные могут измениться до того, как руководитель проверит свой адрес электронной почты. Например, сотрудник может изменить свой запрос в средстве запроса на отпуск, чтобы изменить запрошенные даты.
Включив autoInvokeAction
свойство в сообщение с действиями, созданное средством, карта с исходными данными заменяется новым карта с новыми данными при его открытии менеджером. URL-адрес, указанный в , autoInvokeAction
возвращает те же полезные данные JSON с новыми значениями для запрошенных дат отпуска.