Criar notificação em reunião para a reunião do Teams

Artigo
06/30/2023

A notificação em reunião é usada para envolver os participantes e coletar informações ou comentários durante a reunião. Use uma carga de notificação na reunião para disparar uma notificação na reunião. Como parte da solicitação de carga de notificação, inclua a URL em que o conteúdo a ser mostrado está hospedado.

Uma URL de recurso externo é usada para exibir a notificação na reunião. Você pode usar o submitTask método para enviar dados em um chat de reunião.

Desktop
Dispositivo móvel

A imagem a seguir mostra uma notificação em reunião no cliente da área de trabalho do Teams:

A captura de tela mostra uma notificação em reunião na área de trabalho do Teams.

Você também pode adicionar a imagem de exibição do Teams e o cartão de visita do usuário à notificação de reunião com base no onBehalfOf token com a MRI do usuário e o nome de exibição passado em conteúdo. A seguir um exemplo de conteúdo:

    {
       "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"
    }

A captura de tela mostra como uma imagem de exibição e pessoas cartão no Teams é usada com a caixa de diálogo na reunião.

Compatibilidade de recursos por tipos de usuário

A tabela a seguir fornece os tipos de usuário e lista os recursos que cada usuário pode acessar em reuniões:

Tipo de usuário	Reunião agendada ou reunião de calendário instantâneo	Chamada um-a-um	Chamada de grupo	Reunião de canal agendada
In-tenant	Disponível	Disponível	Disponível	Disponível
Guest	Disponível	Disponível	Disponível	Disponível
Federado ou Externo	Disponível	Não disponível	Não disponível	Disponível
Anônimo	Disponível	Não disponível	Não disponível	Não disponível

Notificação de reunião direcionada

A notificação de reunião direcionada permite que os aplicativos enviem notificações para participantes específicos em um estágio de reunião. As notificações são privadas e são enviadas apenas para participantes específicos ou direcionados. A notificação de reunião direcionada ajuda a aprimorar a experiência de reunião e desenvolver atividades de engajamento do usuário em reuniões do Teams.

Observação

Há suporte para notificação de reunião direcionada para reuniões agendadas, reunião instantânea (Atender agora), chamadas um a um e chamadas em grupo.

Na imagem a seguir, uma notificação de reunião solicitando pagamento é enviada a um dos participantes da reunião. A notificação da reunião só está visível para o participante de destino:

A captura de tela mostra um exemplo de uma notificação de reunião enviada a um participante de destino solicitando um pagamento.

Habilitar configurações de manifesto do aplicativo para notificação de reunião direcionada

Para enviar notificações de reunião direcionadas, você deve configurar a authorization propriedade e as name propriedades e type no resourceSpecific campo no manifesto do aplicativo da seguinte maneira:


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

Habilitar a notificação de reunião direcionada

Observação

Você só pode enviar uma notificação de reunião direcionada para 50 participantes da reunião em uma única chamada de API. Se você quiser enviar uma notificação de reunião direcionada para mais de 50 participantes, deverá chamar a targetedMeetingNotification API novamente.

A notificação de reunião direcionada pode ser disparada pela ação do usuário.

Para habilitar a notificação de reunião direcionada:

Recupere as IDs de usuário dos participantes por meio da API do participante e da API Obter membros.

Observação

A notificação de reunião direcionada não dá suporte a IDs de usuário no formato Microsoft Entra ID do usuário.

A seguir está um exemplo de uma ID do usuário: id=29:1I12M_iy2wTa97T6LbjTh4rJCWrtw2PZ3lxpD3yFv8j2YPnweY2lpCPPAn3RIOPP7rghfHauUz48I1t7ANhj4CA

Inclua as IDs do usuário no parâmetro de solicitação.

A seguir está um exemplo de uma solicitação:

 POST /v1/meetings/{meetingId}/notification

A seguir está um exemplo de uma carga:

{
  "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"      } 
    ] 
  }
}

A notificação de reunião direcionada está habilitada.

Para obter mais informações sobre targetedMeetingNotification, consulte Notificação de reunião direcionada e a API de falsificação de ícone de aplicativo.

Depois de criar uma notificação em reunião para seu aplicativo, você pode usar a API para habilitar a targetedMeetingNotification má configuração do ícone de aplicativo para seu aplicativo de reunião. Isso ajuda os participantes da reunião a receber uma notificação sempre que houver uma nova atividade no aplicativo. Para obter mais informações, confira habilitar a má configuração do ícone de aplicativo para seu aplicativo do Teams.

Exemplo de código

Nome do exemplo	Descrição	.NET	Node.js	Manifesto
Notificação na reunião	Demonstra como implementar a notificação em reunião usando o bot.	View	View	View

Guias passo a passo

Siga o guia passo a passo para gerar notificação em reunião na reunião do Teams.