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

Artigo
06/24/2024

A notificação em reunião é utilizada para envolver os participantes e recolher 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 do pedido de payload de notificação, inclua o URL onde o conteúdo a mostrar está alojado.

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 seguinte mostra uma notificação em reunião no cliente de ambiente de trabalho do Teams:

Captura de ecrã a mostrar uma notificação em reunião no ambiente 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"
    }

Captura de ecrã a mostrar como uma imagem de apresentação e um cartão pessoas no Teams são utilizados com a caixa de diálogo na reunião.

Compatibilidade de funcionalidades por tipos de utilizador

A tabela seguinte fornece os tipos de utilizador e lista as funcionalidades a que cada utilizador pode aceder em reuniões:

Tipo de usuário	Reunião agendada ou Reunião instantânea do calendário	Chamada um-para-um	Chamada de grupo	Reunião de canal agendada
No inquilino	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 direcionada na reunião permite que as aplicações enviem notificações a participantes específicos numa fase da reunião. As notificações são privadas e são enviadas apenas para participantes específicos ou direcionados. A notificação direcionada na reunião ajuda a melhorar a experiência de reunião e a desenvolver atividades de envolvimento de utilizadores em reuniões do Teams.

Observação

A notificação de reunião direcionada é suportada para reuniões agendadas, reuniões instantâneas (Reunir agora), chamadas um-para-um e chamadas de grupo.

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

Captura de ecrã a mostrar um exemplo de uma notificação de reunião enviada a um participante visado a pedir um pagamento.

Ativar as definições do manifesto da aplicação para notificação direcionada na reunião

Para enviar notificações direcionadas na reunião, tem de configurar a authorization propriedade e as name propriedades e type no resourceSpecific campo no manifesto da aplicação da seguinte forma:


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

Ativar notificação na reunião direcionada

Observação

Só pode enviar uma notificação em reunião direcionada a 50 participantes numa única chamada à API. Se quiser enviar uma notificação em reunião direcionada a mais de 50 participantes, tem de ligar novamente para a targetedMeetingNotification API.

A notificação direcionada na reunião pode ser acionada pela ação do utilizador.

Para ativar a notificação direcionada na reunião:

Obtenha os IDs de utilizador dos participantes através da API Obter participantes e obter a API de membros.

Observação

A notificação direcionada na reunião não suporta IDs de utilizador no formato de ID de utilizador do Microsoft Entra.

Segue-se um exemplo de um ID de utilizador: id=29:1I12M_iy2wTa97T6LbjTh4rJCWrtw2PZ3lxpD3yFv8j2YPnweY2lpCPPAn3RIOPP7rghfHauUz48I1t7ANhj4CA

Inclua os IDs de utilizador no parâmetro do pedido.

Segue-se um exemplo de um pedido:

 POST /v1/meetings/{meetingId}/notification

Segue-se um exemplo de um payload:

{
  "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 na reunião direcionada está ativada.

Para obter mais informações sobre targetedMeetingNotificationo , veja Notificação de reunião direcionada e ícone de aplicação a desativar API.

Depois de criar uma notificação de reunião para a sua aplicação, pode utilizar a API para ativar o targetedMeetingNotification ícone da aplicação para a sua aplicação de reunião. Isto ajuda os participantes da reunião a receber uma notificação sempre que houver nova atividade na aplicação. Para obter mais informações, consulte Ativar a configuração incorreta do ícone de aplicação para a sua aplicação 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 com o bot.	View	View	View

Guias passo a passo

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

Compartilhar via