Публикация карточки интерактивного сообщения в группе Office 365
Создание карточки сообщения с действиями
Для начала создадим карточку интерактивного сообщения. Начнем с простой карточки, содержащей действия HttpPOST
и OpenUri
. Для разработки карта мы будем использовать Designer "Сообщения с действиями".
Важно!
Соединители Office поддерживают только формат прежних версий MessageCard для карточек. Они не поддерживают формат адаптивных карточек.
Перейдите в раздел Actionable Message Designer и вставьте следующий код JSON:
{
"@context": "https://schema.org/extensions",
"@type": "MessageCard",
"themeColor": "0072C6",
"title": "Visit the Outlook Dev Portal",
"text": "Click **Learn More** to learn more about Actionable Messages!",
"potentialAction": [
{
"@type": "ActionCard",
"name": "Send Feedback",
"inputs": [
{
"@type": "TextInput",
"id": "feedback",
"isMultiline": true,
"title": "Let us know what you think about Actionable Messages"
}
],
"actions": [
{
"@type": "HttpPOST",
"name": "Send Feedback",
"isPrimary": true,
"target": "http://..."
}
]
},
{
"@type": "OpenUri",
"name": "Learn More",
"targets": [
{ "os": "default", "uri": "https://learn.microsoft.com/outlook/actionable-messages" }
]
}
]
}
Не стесняйтесь поэкспериментировать с этим простым примером в Designer actionable Message. Вы можете просмотреть сообщение карта справочнике для получения сведений о доступных полях. Завершив создание карточки, вы можете отправлять ее.
Отправка сообщений с действиями с помощью соединителей Office
Соединители используют веб-перехватчики для создания сообщений из карточек соединителей в группе Office 365. Разработчики могут создавать эти карточки, отправляя HTTP-запросы с простыми полезными данными JSON по адресу веб-перехватчика группы Office 365. Попробуем опубликовать базовые карточки в группе.
Для продолжения вам потребуется подписка на Microsoft 365. Если у вас нет подписки на Microsoft 365, вы можете претендовать на нее в рамках программы microsoft 365 для разработчиков. Дополнительные сведения см. в разделе Вопросы и ответы. Кроме того, вы можете зарегистрироваться для получения бесплатной пробной версии на 1 месяц или приобрести план Microsoft 365.
Получение URL-адреса веб-перехватчика для соединителя группы Microsoft 365
Войдите в Outlook в Интернете по адресу https://outlook.office.com.
В списке папок выберите группу в разделе Группы. В меню группы нажмите многоточие (…) и выберите Параметры.
В области Параметры группы выберите Соединители.
Найдите и выберите соединитель Входящий веб-перехватчик в списке доступных соединителей.
Введите имя соединителя и нажмите Создать.
Скопируйте и сохраните представленный URL-адрес веб-перехватчика. Нажмите кнопку Готово.
URL-адрес веб-перехватчика должен выглядеть примерно так:
https://outlook.office365.com/webhook/a1269812-6d10-44b1-abc5-b84f93580ba0@9e7b80c7-d1eb-4b52-8582-76f921e416d9/IncomingWebhook/3fdd6767bae44ac58e5995547d66a4e4/f332c8d9-3397-4ac5-957b-b8e3fc465a8c
Отправка сообщения
Используйте Postman, чтобы отправить полезные данные интерактивного сообщения на URL-адрес веб-перехватчика. Откройте Postman. При необходимости создайте новую вкладку и настройте ее, выполнив указанные ниже действия.
Выберите запрос GET и измените его на POST.
В текстовом поле
Enter request URL
вставьте URL-адрес веб-перехватчика.Нажмите Основной текст под URL-адресом и выберите вариант необработанный.
Выберите Текст и измените его на JSON (application/json).
Введите код JSON карточки сообщения в текстовой области ниже.
По завершении окно Postman должно выглядеть так:
Нажмите кнопку Отправить, чтобы опубликовать сообщение.