Создание уведомления о собрании для собрания Teams

Статья
06/30/2023

Уведомление на собрании используется для привлечения участников и сбора информации или отзывов во время собрания. Используйте полезные данные уведомления на собрании, чтобы активировать уведомление на собрании. В рамках запроса полезных данных уведомления включите URL-адрес, по которому размещается отображаемое содержимое.

Для отображения уведомления на собрании используется URL-адрес внешнего ресурса. Вы можете использовать метод submitTask для отправки данных в чате собрания.

Компьютер
Мобильные устройства

На следующем рисунке показано уведомление о собрании в классическом клиенте Teams:

Снимок экрана: уведомление о собрании на рабочем столе Teams.

Также можно добавить отображаемое изображение Teams и карточку пользователя в уведомление собрания на основе маркера onBehalfOf, при этом MRI пользователя и отображаемое имя передаются в полезных данных. Ниже приведен пример полезных данных:

    {
       "type": "message",
       "text": "John Phillips assigned you a weekly todo",
       "summary": "Don't forget to meet with Marketing next week",
       "channelData": {
           onBehalfOf: [
             { 
               itemId: 0, 
               mentionType: 'person', 
               mri: context.activity.from.id, 
               displayname: context.activity.from.name 
             }
            ],
           "notification": {
           "alertInMeeting": true,
           "externalResourceUrl": "https://teams.microsoft.com/l/bubble/APP_ID?url=<url>&height=<height>&width=<width>&title=<title>&completionBotId=BOT_APP_ID"
            }
        },
       "replyToId": "1493070356924"
    }

Снимок экрана: отображение изображения и людей, карта в Teams, используется с диалоговым окном в собрании.

Совместимость функций по типам пользователей

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

Тип пользователя	Запланированное собрание или мгновенное собрание по календарю	Один-на-один	Групповой вызов	Запланированное собрание канала
В клиенте	Доступно	Доступно	Доступно	Доступно
Guest	Доступно	Доступно	Доступно	Доступно
Федеративный или внешний	Доступно	Недоступно	Недоступно	Доступно
Анонимный	Доступно	Недоступно	Недоступно	Недоступно

Целевое уведомление о собрании

Целевое уведомление на собрании позволяет приложениям отправлять уведомления определенным участникам на этапе собрания. Уведомления являются частными и отправляются только определенным или целевым участникам. Целевое уведомление о собрании помогает улучшить взаимодействие с собраниями и разработать действия по взаимодействию с пользователями в собраниях Teams.

Примечание.

Целевое уведомление о собрании поддерживается для запланированных собраний, мгновенных собраний (собрание сейчас), 1-на-один и групповых звонков.

На следующем рисунке уведомление о собрании с запросом оплаты отправляется одному из участников собрания. Уведомление о собрании отображается только целевому участнику:

Снимок экрана: пример уведомления о собрании, отправленного целевому участнику, запрашивающего оплату.

Включение параметров манифеста приложения для уведомления о целевом собрании

Чтобы отправлять целевые уведомления о собрании, необходимо настроить authorization свойства и name свойства и type под resourceSpecific полем манифеста приложения следующим образом:


"webApplicationInfo": {
    "id": "<<MICROSOFT-APP-ID>>",
    "resource": "https://RscBasedStoreApp"  },
  "authorization": {
    "permissions": {
      "resourceSpecific": [
        {
          "name": "OnlineMeetingNotification.Send.Chat",
          "type": "Application"        }
      ]
    }
  }

Включение уведомления о целевом собрании

Примечание.

Вы можете отправить целевое уведомление о собрании только 50 участникам собрания в одном вызове API. Если вы хотите отправить целевое уведомление о собрании более чем 50 участникам, необходимо снова вызвать targetedMeetingNotification API.

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

Чтобы включить целевое уведомление о собрании, выполните следующие действия:

Получите идентификаторы пользователей участников с помощью командлета Get participant API и Get members API.

Примечание.

Целевое уведомление о собрании не поддерживает идентификаторы пользователей в формате Microsoft Entra идентификатора пользователя.

Ниже приведен пример идентификатора пользователя. id=29:1I12M_iy2wTa97T6LbjTh4rJCWrtw2PZ3lxpD3yFv8j2YPnweY2lpCPPAn3RIOPP7rghfHauUz48I1t7ANhj4CA

Включите идентификаторы пользователей в параметр запроса.

Ниже приведен пример запроса:

 POST /v1/meetings/{meetingId}/notification

Ниже приведен пример полезных данных:

{
  "type": "targetedMeetingNotification",
  "value": {
    "recipients": [ 
    "29:1I12M_iy2wTa97T6LbjTh4rJCWrtw2PZ3lxpD3yFv8j2YPnweY2lpCPPAn3RI0PP7rghfHauUz48I1t7ANhj4CA"
     ], 
    "surfaces": [ 
      { 
        "surface": "meetingStage", 
        "contentType": "task", 
        "content": { 
          "value": { 
            "height": "300", 
            "width": "400", 
            "title": "Targeted meeting Notification", 
            "url": "https://somevalidurl.com"           
            }
        } 
      } 
    ] 
  },
  "channelData": { // optional if a developer doesn't want to support user attributes.
    "onBehalfOf": [ 
      { 
        "itemid": 0, 
        "mentionType": "person", 
        "mri": "29:1mDOCfGM9825lMHlwP8NjIVMJeQAbN-ojYBT5VzQfPpnst1IFQeYB1QXC8Zupn2RhgfLIW27HmynQk-4bdx_YhA", 
        "displayName": "yunny chung"      } 
    ] 
  }
}

Включено целевое уведомление о собрании.

Дополнительные сведения о см. в разделе API уведомлений о targetedMeetingNotificationцелевом собрании и значка приложения.

После того как вы встроите уведомление о собрании для своего приложения, вы можете использовать targetedMeetingNotification API, чтобы включить изменение значков приложения для приложения собрания. Это помогает участникам собрания получать уведомления при каждом новом действии в приложении. Дополнительные сведения см. в разделе Включение badging значка приложения для приложения Teams.

Пример кода

Название примера	Описание	.NET	Node.js	Манифест
Уведомление на собрании	Демонстрирует реализацию уведомлений на собрании с помощью бота.	Просмотр	Просмотр	View

Пошаговые инструкции

Следуйте инструкциям из пошагового руководства , чтобы создать уведомление о собрании в собрании Teams.