Habilitar a má configuração do ícone de aplicativo para seu aplicativo do Teams

  • Artigo

A má configuração do ícone de aplicativo ajuda um participante da reunião a identificar qualquer atividade de aplicativo durante uma reunião. Os participantes recebem notificação de atividade para os aplicativos de reunião.

Quando há uma nova atividade durante a reunião, o aplicativo chama a targetedMeetingNotification API e exibe um selo vermelho no ícone do aplicativo na barra unificada da reunião (barra U). Quando o participante seleciona o ícone do aplicativo, o aplicativo é aberto no painel lateral da reunião e o selo desaparece.

Por exemplo, durante uma colaboração em tempo real em uma reunião, se um participante adicionar um comentário em um arquivo adicionado à reunião, o aplicativo chamará a targetedMeetingNotification API do painel lateral da reunião do participante. A API dispara um selo no ícone do aplicativo para conscientizar outros participantes sobre a atividade de comentário.

A imagem a seguir mostra o ícone do aplicativo que está inválido na barra de reuniões:

A captura de tela mostra o erro do ícone do aplicativo na barra de dados na reunião do teams.

Observação

Para habilitar a má configuração do ícone do aplicativo, siga estas etapas:

  1. Habilitar configurações de manifesto do aplicativo para o ícone de aplicativo
  2. Habilitar a má configuração do ícone de aplicativo para seu aplicativo

Habilitar configurações de manifesto do aplicativo para o ícone de aplicativo

Para habilitar a má configuração do ícone do aplicativo, você deve:

  • Verifique se você configurou meetingSidePanel como uma context propriedade para seu aplicativo.
  • Configure 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 má configuração do ícone de aplicativo para seu aplicativo

Para habilitar a má configuração do ícone do aplicativo, verifique se você habilitou a notificação de destino na reunião.

A API de alteração da notificação de reunião direcionada e do ícone de aplicativo foi estendida para dar suporte ao ícone de aplicativo no ícone do aplicativo e passar as IDs de mri do usuário dos destinatários pretendidos. O surfaces parâmetro agora dá meetingTabIcon suporte ao valor, que é usado pelo aplicativo.

O aplicativo também poderá passar o tabEntityId, se houver várias instâncias do aplicativo adicionadas à mesma reunião. Se o tabEntityId não for passado, o Teams exibirá o selo no primeiro ícone do aplicativo na janela de reunião dos usuários.

Exemplo

A seguir está um exemplo de uma carga:

{
    "type": "targetedMeetingNotification",
    "value": {
        "recipients": [
            "<participant1 MRI>",
            "<participant2 MRI>" 
        ],
        "surfaces": [
            {
                "surface": "meetingTabIcon",
                "tabEntityId": "<tab id from tab sdk>" // optional           
            }
        ]
    }
}

Código da resposta

A tabela a seguir inclui os códigos de resposta:

Código da resposta Descrição
202 A notificação é enviada com êxito.
207 As notificações são enviadas apenas para alguns participantes.
400 Falha na validação da solicitação de notificação de reunião.
401 O token bot é inválido.
403 O bot não tem permissão para enviar a notificação.
404 O chat da reunião não foi encontrado ou nenhum dos participantes foi encontrado na lista.

Limitações

  • A má configuração do ícone do aplicativo exibe apenas uma notificação para um usuário em um minuto por reunião.

  • O ícone de aplicativo é exibido para um máximo de 50 participantes para uma reunião específica.

Exemplo de código

Nome do exemplo Descrição Node.js .NET
Má configuração do ícone de aplicativo para seu aplicativo do Teams Este exemplo demonstra como habilitar a má configuração do ícone de aplicativo para seu aplicativo do Teams. View Exibir

Confira também