Публикация карточки интерактивного сообщения в группе Office 365Post an actionable message card to an Office 365 group

Создание карточки сообщения с действиямиCreate an actionable message card

Для начала создадим карточку интерактивного сообщения. Начнем с простой карточки, содержащей действия HttpPOST и OpenUri. Для создания карточки мы будем использовать интерактивную среду.Let's start by creating an actionable message card. We'll start with something simple, just a basic card with an HttpPOST action and an OpenUri action. We'll use the Card Playground to design the card.

Откройте веб-сайт Интерактивный запуск кода карточки и вставьте следующий код JSON:Go to Card Playground and paste in the following 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://docs.microsoft.com/outlook/actionable-messages" }
      ]
    }
  ]
}

Вы можете экспериментировать с этим простым примером в интерактивной среде. В справочнике по карточкам сообщений вы найдете сведения о доступных полях. Завершив создание карточки, вы можете отправлять ее.Feel free to experiment with this simple example in the playground. You can see the message card reference for details on the available fields. Once you have a card you're happy with, you can move on to sending it.

Отправка сообщений с действиями с помощью соединителей Office 365Sending actionable messages via Office 365 Connectors

Соединители используют веб-перехватчики для создания сообщений из карточек соединителей в группе Office 365. Разработчики могут создавать эти карточки, отправляя HTTP-запросы с простыми полезными данными JSON по адресу веб-перехватчика группы Office 365. Попробуем опубликовать базовые карточки в группе.Connectors use webhooks to create Connector Card messages within an Office 365 group. Developers can create these cards by sending an HTTP request with a simple JSON payload to an Office 365 group webhook address. Let's try posting some basic cards to a group.

Для продолжения вам потребуется подписка на Office 365.You'll need an Office 365 subscription to proceed. Если у вас нет подписки на Office 365, вы можете получить годовую БЕСПЛАТНУЮ подписку на Office 365, приняв участие в программе для разработчиков приложений для Office 365.If you do not have an Office 365 subscription you can get a one year FREE Office 365 Subscription under the Office 365 Developer Program.

Получение URL-адреса веб-перехватчика соединителя для папки "Входящие"Get a connector webhook URL for your Inbox

  1. Войдите в почтовое приложение Office 365 по адресу https://outlook.office.com.Log on to the Office 365 Mail app at https://outlook.office.com. Нажмите значок шестеренки в правом верхнем углу страницы и выберите пункт Управление соединителями.Click the gear icon in the upper-right-hand corner of the page, and select Manage connectors.

  2. Найдите и выберите соединитель Входящий веб-перехватчик в списке доступных соединителей.Locate and select the Incoming Webhook connector in the list of available connectors.

    Снимок экрана с элементом "Входящий веб-перехватчик" в списке доступных соединителей

  3. Введите имя соединителя и нажмите Создать.Enter a name for this connector and choose Create.

    Снимок экрана со страницей создания соединителя "Входящий веб-перехватчик"

  4. Скопируйте и сохраните представленный URL-адрес веб-перехватчика. Нажмите кнопку Готово.Copy the webhook URL that is displayed and save it. Choose Done.

    Снимок экрана с URL-адресом входящего веб-перехватчика

URL-адрес веб-перехватчика должен выглядеть примерно так:The webhook URL should look similar to the following:

https://outlook.office365.com/webhook/a1269812-6d10-44b1-abc5-b84f93580ba0@9e7b80c7-d1eb-4b52-8582-76f921e416d9/IncomingWebhook/3fdd6767bae44ac58e5995547d66a4e4/f332c8d9-3397-4ac5-957b-b8e3fc465a8c

Отправка сообщенияSend the message

Используйте Postman, чтобы отправить полезные данные интерактивного сообщения на URL-адрес веб-перехватчика. Откройте Postman. При необходимости создайте новую вкладку и настройте ее, выполнив указанные ниже действия.Use Postman to post an actionable message payload to the webhook URL. Open Postman. Create a new tab if needed and configure the tab as follows:

  1. Выберите запрос GET и измените его на POST.Click the GET and change to POST.

  2. В текстовом поле Enter request URL вставьте URL-адрес веб-перехватчика.In the text box labeled Enter request URL paste the webhook URL.

  3. Нажмите Основной текст под URL-адресом и выберите вариант необработанный.Click Body underneath the URL, then select the raw option.

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

  5. Введите код JSON карточки сообщения в текстовой области ниже.Enter the message card JSON in the text area below.

    По завершении окно Postman должно выглядеть так:The Postman window should look like this when you are done:

    Окно запроса Postman, настроенное на публикацию примера интерактивного сообщения по URL-адресу веб-перехватчика

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