Публикация карточки интерактивного сообщения в группе 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

1. Войдите в Outlook в Интернете по адресу https://outlook.office.com.

2. В списке папок выберите группу в разделе Группы. В меню группы нажмите многоточие (…) и выберите Параметры.

   

3. В области Параметры группы выберите Соединители.

4. Найдите и выберите соединитель Входящий веб-перехватчик в списке доступных соединителей.

   

5. Введите имя соединителя и нажмите Создать.

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

1. Выберите запрос GET и измените его на POST.

2. В текстовом поле Enter request URL вставьте URL-адрес веб-перехватчика.

3. Нажмите Основной текст под URL-адресом и выберите вариант необработанный.

4. Выберите Текст и измените его на JSON (application/json).

5. Введите код JSON карточки сообщения в текстовой области ниже.

   По завершении окно Postman должно выглядеть так:

   

6. Нажмите кнопку Отправить, чтобы опубликовать сообщение.