Criar separadores para chamadas

Artigo
02/03/2025

Observação

A extensibilidade de chamadas só está disponível para chamadas um-para-um e na pré-visualização de programadores públicos para o Teams.

Agora, pode criar aplicações de âmbito pessoal que se integram perfeitamente com chamadas rtPC (Public Switched Telephone Network) e Teams-to-Teams. Ao utilizar o âmbito e o contexto corretos, pode criar aplicações que utilizam o tipo de separador, o âmbito estático, o contexto pessoal e os painéis do lado da reunião de forma eficaz.

Esta integração é simples. Pode criar uma nova aplicação de separador pessoal ou atualizar uma aplicação de separador existente com âmbito pessoal e o contexto adequado. As aplicações podem aceder ao ID do autor da chamada para chamadas específicas e apresentar informações relevantes, como casos ativos ou problemas de faturação. Isto melhora o utilitário da aplicação e proporciona uma experiência mais rica para os utilizadores durante as chamadas.

Pré-requisitos

Certifique-se de que os seguintes requisitos estão implementados antes de criar ou atualizar uma aplicação de separador para suportar chamadas um-para-um:

Permissões RSC necessárias: certifique-se de que são concedidas as seguintes permissões RSC para a aplicação:
- OnlineMeetingParticipant.Read.Chat
- OnlineMeeting.ReadBasic.Chat
SDK do Teams JS necessário: Versão mais recente do SDK do TeamsJS
Informações do ID do Autor da Chamada: a aplicação de separador tem de utilizar o getMeetingDetailsVerbose em vez de getMeetingDetails para obter as informações relacionadas com a chamada. A aplicação pode obter detalhes do ID do autor da chamada, como o número de telefone e o ID de e-mail.

Para obter mais informações, veja Obter a API de detalhes da reunião.

Ativar aplicações de separador pessoais para chamadas

Para ativar a aplicação de separador pessoal para chamadas um-para-um:

Atualizar manifesto do aplicativo
Afixar a sua aplicação de separador pessoal a extensões de chamadas

Atualizar manifesto do aplicativo

O Teams utiliza o contexto do painel do lado da reunião para adicionar contexto de chamada no esquema de manifesto. Atualize o manifesto da aplicação com as matrizes de contexto e âmbito relevantes na staticTabs secção . Para configurar a sua aplicação de separador pessoal para chamadas um-para-um, atualize a secção da staticTabs seguinte forma:

scope Defina como personal para disponibilizar a sua aplicação num âmbito pessoal e permite que a aplicação esteja numa chamada.

Defina como contextmeetingSidePanel para permitir que a aplicação de separador seja suportada

Eis um exemplo da atualização na staticTabs secção do manifesto da aplicação:


"staticTabs":[
{
    "entityId": "contoso",
    "scopes": ["personal"],
    "context":[
        "meetingSidePanel",
    ],
    "name": "Contoso"
    "contentUrl": "http://contoso.com/content",
    "websiteUrl": "http://contoso.com/content"
}
],

Eis um exemplo do ficheiro de manifesto da aplicação:

Selecione para ver um manifesto de aplicação de exemplo.

{
  "$schema": "https://raw.githubusercontent.com/OfficeDev/microsoft-teams-app-schema/preview/DevPreview/MicrosoftTeams.schema.json",
  "version": "1.1.5", 
  "manifestVersion": "devPreview",
  "id": "25407c29-8335-68a3-bfdb-4384580a1858",
  "packageName": "",
  "name": { "short": "Packing List - PersMSP", "full": "Packing List - PersonalAndMeetingSidePanel" },
  "developer": {
    "name": "Microsoft Corporation",
    "websiteUrl": "https://www.microsoft.com",
    "privacyUrl": "https://packing-list.azurewebsites.net/privacy.html",
    "termsOfUseUrl": "https://packing-list.azurewebsites.net/tou.html"
  },
  "description": {
    "short": "Packing list app",
    "full": "Test app to test static tabs flow"
  },
  "icons": { "outline": "outline.png", "color": "color.png" },
  "accentColor": "#eff9fc",
  "staticTabs": [
    {
      "entityId": "54d496e0-2b51-4210-bf7d-21d0b5821d9c",
      "name": "Packing List - PersonalAndMeetingSidePanel",
      "contentUrl": "https://packing-list.azurewebsites.net",
      "websiteUrl": "https://packing-list.azurewebsites.net",
      "scopes": ["personal"],
      "context": [
        "meetingSidePanel"
      ]
    }
  ],
  "validDomains": ["packing-list.azurewebsites.net"],
  "webApplicationInfo": { "id": "25407c29-8335-68a3-bfdb-4384580a1858" },
  "showLoadingIndicator": true,
  "authorization": {
    "permissions": {
      "orgWide": [],
      "resourceSpecific": [
        { "name": "OnlineMeeting.ReadBasic.Chat", "type": "Delegated" },
        { "name": "MeetingStage.Write.Chat", "type": "Delegated" },
        { "name": "OnlineMeetingParticipant.Read.Chat", "type": "Delegated" },
        {
          "name": "OnlineMeetingParticipant.ToggleIncomingAudio.Chat",
          "type": "Delegated"
        },
        { "name": "ChannelMeetingStage.Write.Group", "type": "Delegated" },
        { "name": "ChannelMeeting.ReadBasic.Group", "type": "Delegated" }
      ]
    }
  }
}

Afixar a sua aplicação de separador pessoal a extensões de chamadas

Os utilizadores cliente do Teams só podem aceder à sua aplicação de separador pessoal se estiverem afixados pelo administrador do Teams. Os administradores podem tirar partido das Extensões de chamadas para afixar aplicações de separador de chamadas pessoais. Para afixar uma aplicação para chamar:

Aceda à secção aplicações afixadas na política de configuração da aplicação.
Afixe a sua aplicação e atribua-a aos utilizadores que precisam de acesso durante as chamadas um-para-um.

Para obter mais informações, veja como utilizar políticas de configuração de aplicações para afixar e instalar aplicações para os utilizadores.

Confira também

Criar uma guia

Partilhar via