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

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

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

Также можно добавить отображаемое изображение 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.

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

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

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

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

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

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

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

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

   Примечание.

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

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

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

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

    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.

Пример кода

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

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

См. также

• Приложения для собраний и звонков Teams
• Создание вкладок для собрания
• Создание приложений для этапа собрания Teams
• Создание расширяемой беседы для чата собрания
• Создание приложений для анонимных пользователей