Manifesto do aplicativo

O manifesto da aplicação (anteriormente denominado manifesto de aplicação do Teams) descreve como a sua aplicação se integra no produto Microsoft Teams. O manifesto do seu aplicativo deve estar em conformidade com o esquema hospedado em https://developer.microsoft.com/json-schemas/teams/v1.19/MicrosoftTeams.schema.json. As versões anteriores 1.0, 1.1,...,1.17 e a versão atual são 1.19 suportadas (utilizando "v1.x" no URL). A versão 1.18 não está disponível. Para obter mais informações sobre as alterações efetuadas em cada versão, veja Registo de alterações do manifesto de aplicação e, para versões anteriores, veja Versões do manifesto da aplicação.

A tabela a seguir lista as versões do TeamsJS e do manifesto do aplicativo de acordo com diferentes cenários de aplicativo:

* Utilize o TeamsJS mais recente (v.2.19.0 ou posterior) sempre que possível, para tirar partido das melhorias mais recentes e do novo suporte de funcionalidades, incluindo aplicações apenas do Teams. O TeamsJS v.1.12 continua a ser suportado. No entanto, não são adicionadas novas funcionalidades ou melhorias. Os esquemas 1.12 e 1.13 são os mesmos. Para obter mais informações, veja Biblioteca teamsJS.

Segue-se o esquema de manifesto da aplicação de exemplo:

Manifesto de aplicação de exemplo

{
    "$schema": "https://developer.microsoft.com/json-schemas/teams/v1.19/MicrosoftTeams.schema.json",
    "manifestVersion": "1.19",
    "version": "1.0.0",
    "id": "%MICROSOFT-APP-ID%",
    "localizationInfo": {
        "defaultLanguageTag": "en",
        "defaultLanguageFile": "en.json",
        "additionalLanguages": [
            {
                "languageTag": "es",
                "file": "es.json"
            }
        ]
    },
    "developer": {
        "name": "Publisher Name",
        "websiteUrl": "https://example.com/",
        "privacyUrl": "https://example.com/privacy",
        "termsOfUseUrl": "https://example.com/app-tos",
        "mpnId": "1234567890"
    },
    "name": {
        "short": "Name of your app (<=30 chars)",
        "full": "Full name of app, if longer than 30 characters (<=100 chars)"
    },
    "description": {
        "short": "Short description of your app (<= 80 chars)",
        "full": "Full description of your app (<= 4000 chars)"
    },
    "icons": {
        "outline": "A relative path to a transparent .png icon — 32px X 32px",
        "color": "A relative path to a full color .png icon — 192px X 192px"
    },
    "accentColor": "A valid HTML color code.",
    "copilotAgents": {
        "declarativeAgents": [
            {
                "id": "agent1",
                "file": "declarativeAgent1.json"
            }
        ]
    },
    "configurableTabs": [
        {
            "configurationUrl": "https://contoso.com/teamstab/configure",
            "scopes": [
                "team",
                "groupChat"
            ],
            "canUpdateConfiguration": true,
            "context": [
                "channelTab",
                "privateChatTab",
                "meetingChatTab",
                "meetingDetailsTab",
                "meetingSidePanel",
                "meetingStage"
            ],
            "sharePointPreviewImage": "Relative path to a tab preview image for use in SharePoint — 1024px X 768",
            "supportedSharePointHosts": [
                "sharePointFullPage",
                "sharePointWebPart"
            ]
        }
    ],
    "staticTabs": [
        {
            "entityId": "unique Id for the page entity",
            "scopes": [
                "personal"
            ],
            "context": [
                "personalTab",
                "channelTab"
            ],
            "name": "Display name of tab",
            "contentUrl": "https://contoso.com/content (displayed in Teams canvas)",
            "websiteUrl": "https://contoso.com/content (displayed in web browser)",
            "searchUrl": "https://contoso.com/content (displayed in web browser)"
        }
    ],
    "supportedChannelTypes": [
        "sharedChannels",
        "privateChannels"
    ],
    "bots": [
        {
            "botId": "%MICROSOFT-APP-ID-REGISTERED-WITH-BOT-FRAMEWORK%",
            "scopes": [
                "team",
                "personal",
                "groupChat"
            ],
            "needsChannelSelector": false,
            "isNotificationOnly": false,
            "supportsFiles": true,
            "supportsCalling": false,
            "supportsVideo": true,
            "commandLists": [
                {
                    "scopes": [
                        "team",
                        "groupChat"
                    ],
                    "commands": [
                        {
                            "title": "Command 1",
                            "description": "Description of Command 1"
                        },
                        {
                            "title": "Command 2",
                            "description": "Description of Command 2"
                        }
                    ]
                },
                {
                    "scopes": [
                        "personal",
                        "groupChat"
                    ],
                    "commands": [
                        {
                            "title": "Personal command 1",
                            "description": "Description of Personal command 1"
                        },
                        {
                            "title": "Personal command N",
                            "description": "Description of Personal command N"
                        }
                    ]
                }
            ]
        }
    ],
    "connectors": [
        {
            "connectorId": "GUID-FROM-CONNECTOR-DEV-PORTAL%",
            "scopes": [
                "team"
            ],
            "configurationUrl": "https://contoso.com/teamsconnector/configure"
        }
    ],
    "composeExtensions": [
        {
            "canUpdateConfiguration": true,
            "botId": "%MICROSOFT-APP-ID-REGISTERED-WITH-BOT-FRAMEWORK%",
            "commands": [
                {
                    "id": "exampleCmd1",
                    "title": "Example Command",
                    "type": "query",
                    "context": [
                        "compose",
                        "commandBox"
                    ],
                    "description": "Command Description; e.g., Search on the web",
                    "initialRun": true,
                    "fetchTask": false,
                    "parameters": [
                        {
                            "name": "keyword",
                            "title": "Search keywords",
                            "inputType": "choiceset",
                            "description": "Enter the keywords to search for",
                            "value": "Initial value for the parameter",
                            "choices": [
                                {
                                    "title": "Title of the choice",
                                    "value": "Value of the choice"
                                }
                            ]
                        }
                    ]
                },
                {
                    "id": "exampleCmd2",
                    "title": "Example Command 2",
                    "type": "action",
                    "context": [
                        "message"
                    ],
                    "description": "Command Description; e.g., Add a customer",
                    "initialRun": true,
                    "fetchTask": false ,
                    "parameters": [
                        {
                            "name": "custinfo",
                            "title": "Customer name",
                            "description": "Enter a customer name",
                            "inputType": "text"
                        }
                    ]
                },
                {
                    "id": "exampleCmd3",
                    "title": "Example Command 3",
                    "type": "action",
                    "context": [
                        "compose",
                        "commandBox",
                        "message"
                    ],
                    "description": "Command Description; e.g., Add a customer",
                    "fetchTask": false,
                    "taskInfo": {
                        "title": "Initial dialog title",
                        "width": "Dialog width",
                        "height": "Dialog height",
                        "url": "Initial webview URL"
                    }
                }
            ],
            "messageHandlers": [
                {
                    "type": "link",
                    "value": {
                        "domains": [
                            "mysite.someplace.com",
                            "othersite.someplace.com"
                        ],
                        "supportsAnonymizedPayloads": false
                    }
                }
            ]
        }
    ],
    "permissions": [
        "identity",
        "messageTeamMembers"
    ],
    "devicePermissions": [
        "geolocation",
        "media",
        "notifications",
        "midi",
        "openExternal"
    ],
    "validDomains": [
        "contoso.com",
        "mysite.someplace.com",
        "othersite.someplace.com"
    ],
    "webApplicationInfo": {
        "id": "AAD App ID",
        "resource": "Resource URL for acquiring auth token for SSO"
    },
    "authorization": {
        "permissions": {
            "resourceSpecific": [
                {
                    "type": "Application",
                    "name": "ChannelSettings.Read.Group"
                },
                {
                    "type": "Delegated",
                    "name": "ChannelMeetingParticipant.Read.Group"
                }
            ]
        }
    },
    "showLoadingIndicator": false,
    "isFullScreen": false,
    "activities": {
        "activityTypes": [
            {
                "type": "taskCreated",
                "description": "Task created activity",
                "templateText": "<team member> created task <taskId> for you"
            },
            {
                "type": "userMention",
                "description": "Personal mention activity",
                "templateText": "<team member> mentioned you"
            }
        ]
    },
    "defaultBlockUntilAdminAction": true,
    "publisherDocsUrl": "https://example.com/app-info",
    "defaultInstallScope": "meetings",
    "defaultGroupCapability": {
        "meetings": "tab",
        "team": "bot",
        "groupchat": "bot"
    },
    "configurableProperties": [
        "name",
        "shortDescription",
        "longDescription",
        "smallImageUrl",
        "largeImageUrl",
        "accentColor",
        "developerUrl",
        "privacyUrl",
        "termsOfUseUrl"
    ],
    "subscriptionOffer": {
        "offerId": "publisherId.offerId"
    },
    "meetingExtensionDefinition": {
        "scenes": [
            {
                "id": "9082c811-7e6a-4174-8173-6ccd57d377e6",
                "name": "Getting started sample",
                "file": "scenes/sceneMetadata.json",
                "preview": "scenes/scenePreview.png",
                "maxAudience": 15,
                "seatsReservedForOrganizersOrPresenters": 0
            },
            {
                "id": "afeaed22-f89b-48e1-98b4-46a514344e4a",
                "name": "Sample-1",
                "file": "scenes/sceneMetadata.json",
                "preview": "scenes/scenePreview.png",
                "maxAudience": 15,
                "seatsReservedForOrganizersOrPresenters": 3
            }
        ]
    }
}

O esquema define as seguintes propriedades:

$esquema

Opcional, mas recomendado – Cadeia

O URL de https:// que referencia o Esquema JSON para o manifesto da aplicação.

manifestVersion

Necessário – Cadeia

A versão do esquema de manifesto da aplicação que este manifesto está a utilizar. Utilize 1.13 para ativar o suporte de aplicações do Teams no Outlook e na aplicação Microsoft 365; utilize 1.12 (ou anterior) para aplicações apenas do Teams.

versão

Necessário – Cadeia

A versão de um aplicativo específico. Quando atualiza algo no manifesto da aplicação, a versão também tem de ser incrementada. Desta forma, quando o novo manifesto de aplicação é instalado, substitui o existente e o utilizador recebe a nova funcionalidade. Quando esta aplicação foi submetida para a Microsoft Teams Store, o novo manifesto de aplicação tem de ser novamente submetido e revogado. Os utilizadores da aplicação recebem automaticamente o novo manifesto de aplicação atualizado poucas horas após a aprovação do manifesto da aplicação.

Se as solicitações de permissões do aplicativo forem alteradas, os usuários serão solicitados a atualizar e consentir novamente com o aplicativo..

Esta cadeia de caracteres da versão deve seguir o padrão semver (MAJOR.MINOR.PATCH).

ID

Necessário – ID da aplicação Microsoft

A ID é um identificador exclusivo gerado pela Microsoft para o aplicativo. O formato do ID é GUID. Você tem uma ID se seu bot estiver registrado por meio do Microsoft Bot Framework. Você tem uma ID se o aplicativo web da sua guia já entrar com a Microsoft. Você deve inserir a ID aqui. Caso contrário, você deverá gerar uma nova ID no Portal de Registro de Aplicativos da Microsoft. Use a mesma ID se você adicionar um bot.

O ID armazenado no Teams Administração Center é o ID da Aplicação Externa e é visível como ExternalID nos rastreios.

developer

Necessário – Objeto

Especifica informações sobre a sua empresa. Para aplicações submetidas para a Loja Teams, estes valores têm de corresponder às informações na sua listagem da Loja Teams. Para obter mais informações, consulte as diretrizes de publicação da Loja Teams. O nome do programador ajuda a melhorar a deteção de aplicações na Loja Teams.

nome

Necessário – Objeto

O nome da sua experiência de aplicativo, exibido aos usuários na experiência do Teams. Para aplicativos enviados ao AppSource, esses valores devem corresponder às informações na entrada do AppSource. Os valores de short e full devem ser diferentes. O nome da aplicação ajuda a melhorar a deteção da sua aplicação na Loja Teams.

description

Necessário – Objeto

Descreve o seu aplicativo para os usuários. Para aplicativos enviados ao AppSource, esses valores devem corresponder às informações na entrada do AppSource. A descrição da aplicação ajuda a melhorar a deteção de aplicações na Loja Teams.

Certifique-se de que a sua descrição detalhe a sua experiência e ajude os clientes em potencial a entender o que sua experiência faz. Você deve anotar na descrição completa, se uma conta externa for necessária para uso. Os valores de short e full devem ser diferentes. A sua breve descrição não pode ser repetida dentro da descrição longa e não pode incluir qualquer outro nome de aplicação.

localizationInfo

Opcional – Objeto

Permite a especificação de um idioma predefinido e aponta para ficheiros de idioma adicionais. Consulte a localização.

localizationInfo.additionalLanguages

Uma matriz de objetos, cada um com as seguintes propriedades para especificar traduções de idioma adicionais.

ícones

Necessário – Objeto

Ícones usados no aplicativo Teams. Os arquivos de ícone devem ser incluídos como parte do pacote de upload. Para obter mais informações, consulte Ícones.

accentColor

Obrigatório – código de cor Hexadecima html

Uma cor a utilizar e como fundo para os ícones de cor.

O valor deve ser um código de cor HTML válido começando com '#', por exemplo #4464ee. Para obter mais informações, consulte accentColor.

copilotAgents

Opcional – Objeto

Define um ou mais agentes para Microsoft 365 Copilot. Os agentes declarativos são personalizações de Microsoft 365 Copilot que são executadas no mesmo orquestrador e modelos de base.

declarativeAgents

Representa uma personalização de Microsoft 365 Copilot, conforme definido pelo respetivo ficheiro de manifesto.

configurbleTabs

Opcional – Matriz

Utilizado quando a sua experiência de aplicação tem uma experiência de separador de canal de equipa que requer configuração adicional antes de ser adicionada. As guias configuráveis são compatíveis apenas nos escopos team e groupChat, sendo que você pode configurar as mesmas guias várias vezes. No entanto, pode defini-lo no manifesto da aplicação apenas uma vez.

staticTabs

Opcional – Matriz

Define um conjunto de separadores que podem ser afixados por predefinição, sem que o utilizador os adicione manualmente. As guias estáticas declaradas no escopo personal são sempre vinculadas à experiência pessoal do aplicativo.

Este item é uma matriz (máximo de 16 elementos) com todos os elementos do tipo object. Esse bloco é necessário apenas para soluções que fornecem uma solução de guia estática.

bots

Opcional – Matriz

Define uma solução de bot, juntamente com informações opcionais, como propriedades de comando padrão.

O item é uma matriz (no máximo, apenas um elemento— só é permitido um bot por aplicação) com todos os elementos do tipo object. Esse bloco é necessário apenas para soluções que fornecem uma experiência de bot.

bots.configuration

Opcional – Objeto

bots.commandLists

Opcional – Matriz

Uma lista de comandos que seu bot pode recomendar aos usuários. O objeto é uma matriz (máximo de três elementos) com todos os elementos do tipo object; tem de definir uma lista de comandos separada para cada âmbito suportado pelo bot. Para obter mais informações, confira Menus de Bot.

bots.commandLists.commands

Necessário – Matriz

conectores

Opcional – Matriz

O connectors bloco define um conector card para Grupos do Microsoft 365 para a aplicação.

O objeto é uma matriz (máximo de 2 elementos) com todos os elementos do tipo object. Este bloco é necessário apenas para soluções que fornecem um Conector.

composeExtensions

Opcional – Matriz

Define uma extensão de mensagens para o aplicativo.

O item é uma matriz (máximo de um elemento) com todos os elementos do tipo object. Este bloco é necessário apenas para soluções que fornecem uma extensão de mensagens.

composeExtensions.commands

Sua extensão de mensagens deve declarar um ou mais comandos com no máximo 10 comandos. Cada comando aparece no Microsoft Teams como uma interação potencial do ponto de entrada baseado na interface do usuário.

Cada item de comando é um objeto com a seguinte estrutura:

permissões

Opcional – Matriz de cadeias de carateres

Uma matriz de string, que especifica quais permissões o aplicativo solicita, que permite que os usuários finais saibam como a extensão funciona. As seguintes opções não são exclusivas:

• identity Requer informações de identidade do utilizador.
• messageTeamMembers Requer permissão para enviar mensagens diretas aos membros da equipa.

Alterar essas permissões durante a atualização do aplicativo faz com que seus usuários repitam o processo de consentimento depois de executar o aplicativo atualizado. Para saber mais, confira Atualizando seu aplicativo.

devicePermissions

Opcional – Matriz de cadeias de carateres

Fornece os recursos nativos no dispositivo de um usuário aos quais o seu aplicativo solicita acesso. As opções são:

• geolocation
• media
• notifications
• midi
• openExternal

validDomains

Opcional (exceto Obrigatório onde indicado) – Matriz de cadeias

Uma lista de domínios válidos para sites que o aplicativo espera carregar no cliente do Teams. As listagens de domínio podem incluir curingas, por exemplo, *.example.com. O domínio válido corresponde exatamente a um segmento do domínio; se você precisar combinar a.b.example.com, use *.*.example.com. Se a sua configuração de guias ou interface do usuário de conteúdo navegar para qualquer outro domínio que não seja a configuração de guias, esse domínio deverá ser especificado aqui.

Não inclua os domínios dos provedores de identidade aos quais você deseja oferecer suporte em seu aplicativo. Por exemplo, para autenticar com um ID do Google, é necessário redirecionar para accounts.google.com, no entanto, não pode incluir accounts.google.com no validDomains[].

Os aplicativos do Teams que exigem que suas próprias URLs do SharePoint funcionem bem incluem "{teamsitedomain}" em sua lista de domínios válida.

O objeto é uma matriz com todos os elementos do tipo string. O item máximo do objeto é 16 e o comprimento máximo é de 2048 carateres.

webApplicationInfo

Opcional – Objeto

Forneça o seu ID de Aplicação Microsoft Entra e informações do Microsoft Graph para ajudar os utilizadores a iniciar sessão na sua aplicação de forma totalmente integrada. Se a sua aplicação estiver registada no Microsoft Entra ID, tem de fornecer o ID da Aplicação. Os administradores podem revisar facilmente as permissões e conceder consentimento no centro de administração do Teams.

graphConnector

Opcional – Objeto

Especifique a configuração do conector de gráfico do aplicativo. Se estiver presente, webApplicationInfo.id também tem de ser especificado.

showLoadingIndicator

Opcional – Booleano

Indica se deve ou não mostrar o indicador de carregamento quando um aplicativo ou guia está carregando. O padrão é false.

isFullScreen

Opcional – Booleano

Indica se um aplicativo pessoal é renderizado sem uma barra de cabeçalho de guia (significando o modo de tela inteira). Valor predefinido: false

activities

Opcional – Objeto

Defina as propriedades que o seu aplicativo usa para postar um feed de atividades do usuário..

activities.activityTypes

{
   "activities":{
      "activityTypes":[
         {
            "type":"taskCreated",
            "description":"Task Created Activity",
            "templateText":"{actor} created task {taskId} for you"
         },
         {
            "type":"teamMention",
            "description":"Team Mention Activity",
            "templateText":"{actor} mentioned team"
         },
         {
            "type":"channelMention",
            "description":"Channel Mention Activity",
            "templateText":"{actor} mentioned channel"
         },
         {
            "type":"userMention",
            "description":"Personal Mention Activity",
            "templateText":"{actor} mentioned user"
         },
         {
            "type":"calendarForward",
            "description":"Forwarding a Calendar Event",
            "templateText":"{actor} sent user an invite on behalf of {eventOwner}"
         },
         {
            "type":"calendarForward",
            "description":"Forwarding a Calendar Event",
            "templateText":"{actor} sent user an invite on behalf of {eventOwner}"
         },
         {
            "type":"creatorTaskCreated",
            "description":"Created Task Created",
            "templateText":"The Creator created task {taskId} for you"
         }
      ]
   }
}

defaultInstallScope

Opcional – Cadeia

Especifica o escopo de instalação definido para este aplicativo por padrão. O âmbito definido é a opção apresentada no botão quando um utilizador tenta adicionar a aplicação. As opções são:

• personal
• team
• groupChat
• meetings

defaultGroupCapability

Opcional – Objeto

Quando um âmbito de instalação de grupo é selecionado, define a capacidade predefinida quando o utilizador instala a aplicação.

configurableProperties

Opcional – Matriz

O bloco configurableProperties define as propriedades do aplicativo que os administradores do Teams podem personalizar. Para obter mais informações, consulte habilitar a personalização do aplicativo. A funcionalidade de personalização de aplicações não é suportada em aplicações personalizadas ou aplicações personalizadas criadas para a sua organização (aplicações LOB).

Você pode definir qualquer uma das seguintes propriedades:

• name: o nome a apresentar da aplicação.
• shortDescription: a breve descrição da aplicação.
• longDescription: a descrição longa da aplicação.
• smallImageUrl: o ícone de destaque da aplicação.
• largeImageUrl: o ícone de cor da aplicação.
• accentColor: a cor a utilizar e um fundo para os ícones de destaque.
• developerUrl: o URL HTTPS do site do programador.
• privacyUrl: o URL HTTPS da política de privacidade do programador.
• termsOfUseUrl: o URL HTTPS dos termos de utilização do programador.

supportedChannelTypes

Opcional – Matriz

Habilita seu aplicativo em canais não-padronizados. Se seu aplicativo der suporte a um escopo de equipe e esta propriedade for definida, o Teams habilita seu aplicativo em cada tipo de canal adequadamente. A propriedade supportedChannelTypes só suporta sharedChannels e privateChannels.

defaultBlockUntilAdminAction

Opcional – Booleano

Quando a propriedade defaultBlockUntilAdminAction é definida como true, o aplicativo fica oculto dos usuários por padrão até que o administrador permita. Se definido como true, o aplicativo ficará oculto para todos os locatários e usuários finais. Os administradores de locatários podem ver o aplicativo no centro de administração do Teams e tomar medidas para permitir ou bloquear o aplicativo. O valor padrão é falso. Para obter mais informações sobre o bloco de aplicações predefinido, consulte Bloquear aplicações por predefinição para utilizadores até que um administrador aprove.

publisherDocsUrl

Opcional – Cadeia

Tamanho máximo - 2048 carateres

O valor do publisherDocsUrl parâmetro é um URL HTTPS seguro para a página de documentação e informações da aplicação que os programadores de aplicações optam por fornecer. Os administradores de inquilinos obtêm documentação sobre a aplicação neste URL. O centro de administração do Teams apresenta o URL na página de detalhes da aplicação. A documentação pode incluir as instruções para os administradores facilitarem a adoção de aplicações e a implementação de aplicações. Na documentação da aplicação, também pode incluir instruções ou informações sobre a aplicação que são úteis para o administrador de inquilinos, utilizadores e outros intervenientes empresariais.

subscriptionOffer

Opcional – Objeto

Especifica a oferta de SaaS associada ao seu aplicativo.

meetingExtensionDefinition

Opcional – Objeto

Especifique a definição de extensão da reunião. Para obter mais informações, consulte cenas personalizadas do Modo Juntos no Teams.

meetingExtensionDefinition.scenes

autorização

Opcional – Objeto

Especifique e consolide as informações relacionadas à autorização para o aplicativo.

authorization.permissions

authorization.permissions.resourceSpecific

Permissões da aplicação RSC

As permissões do aplicativo permitem que o aplicativo acesse dados sem um usuário conectado. Para obter informações sobre permissões de aplicação, veja Permissões RSC para o Microsoft Graph e o Microsoft BotSDK.

Permissões delegadas do RSC

As permissões delegadas permitem que o aplicativo acesse dados em nome do usuário conectado.

• Permissões delegadas do RSC para uma equipa

  Nome	Descrição
  ChannelMeetingParticipant.Read.Group	Permite que o aplicativo leia as informações dos participantes, incluindo nome, função, ID, horários de ingresso e de saída, de reuniões de canal associadas a esta equipe, em nome do usuário conectado.
  ChannelMeetingIncomingAudio.Detect.Group	Permite que a aplicação detete áudio recebido em reuniões de canal associadas à equipa.
  ChannelMeetingActiveSpeaker.Read.Group	Permite que a aplicação leia os participantes que estão a enviar áudio para as reuniões de canal associadas à equipa.
  ChannelMeetingAudioVideo.Stream.Group	Permite que a aplicação transmita conteúdos de áudio-vídeo a partir de reuniões de canal associadas à equipa.
  InAppPurchase.Allow.Group	Permite que a aplicação mostre ofertas do marketplace aos utilizadores na equipa e conclua as compras na aplicação, em nome do utilizador com sessão iniciada.
  ChannelMeetingStage.Write.Group	Permite que a aplicação mostre conteúdo na fase da reunião em reuniões de canal associadas à equipa, em nome do utilizador com sessão iniciada.
  LiveShareSession.ReadWrite.Group	Permite que a aplicação crie e sincronize sessões live share para a equipa e obtenha informações relacionadas com o acesso, como o nome e a função, sobre a lista da equipa e quaisquer reuniões associadas, em nome do utilizador com sessão iniciada.
  MeetingParticipantReaction.Read.Group	Permite que a aplicação leia as reações dos participantes em reuniões de canal associadas à equipa.

• Permissões delegadas do RSC para conversas ou reuniões

  Nome	Descrição
  InAppPurchase.Allow.Chat	Permite que a aplicação mostre ofertas do marketplace aos utilizadores no chat e a qualquer reunião associada e conclua as compras na aplicação, em nome do utilizador com sessão iniciada.
  MeetingStage.Write.Chat	Permite que a aplicação mostre conteúdo na fase da reunião em reuniões associadas ao chat, em nome do utilizador com sessão iniciada.
  OnlineMeetingParticipant.Read.Chat	Permite que a aplicação leia as informações dos participantes, incluindo o nome, a função, o ID, a adesão e os horários à esquerda, da reunião associada ao chat, em nome do utilizador com sessão iniciada.
  OnlineMeetingParticipant.ToggleIncomingAudio.Chat	Permite que a aplicação alterne o áudio recebido para os participantes em reuniões associadas ao chat, em nome do utilizador com sessão iniciada.
  LiveShareSession.ReadWrite.Chat	Permite que a aplicação crie e sincronize sessões de Live Share para o chat e obtenha informações relacionadas com o acesso, como o nome e a função, sobre a lista do chat e quaisquer reuniões associadas, em nome do utilizador com sessão iniciada.
  MeetingParticipantReaction.Read.Chat	Permite que a aplicação leia as reações dos participantes em reuniões associadas ao chat.
  OnlineMeetingIncomingAudio.Detect.Chat	Permite que a aplicação detete alterações na status de áudio recebido em reuniões associadas ao chat, em nome do utilizador com sessão iniciada.
  OnlineMeetingActiveSpeaker.Read.Chat	Permite que a aplicação leia os participantes que estão a enviar áudio para as reuniões associadas ao chat.
  OnlineMeetingAudioVideo.Stream.Chat	Permite que a aplicação transmita em fluxo conteúdos de áudio-vídeo de reuniões associadas ao chat.

• Permissões delegadas do RSC para utilizadores

  Nome	Descrição
  CameraStream.Read.User	Permite que a aplicação leia o fluxo da câmara do utilizador.
  InAppPurchase.Allow.User	Permite que o aplicativo mostrar as ofertas do marketplace do usuário e conclua as compras do usuário dentro do aplicativo, em nome do usuário conectado.
  OutgoingVideoStream.Write.User	Permite que a aplicação modifique o vídeo de saída do utilizador.
  MicrophoneStream.Read.User	Permite que a aplicação leia o fluxo de microfone do utilizador.
  MeetingParticipantReaction.Read.User	Permite que a aplicação leia as reações do utilizador durante a participação numa reunião.

extensions

Opcional – Objeto

A extensions propriedade especifica suplementos do Outlook num manifesto de aplicação e simplifica a distribuição e aquisição no ecossistema do Microsoft 365. Cada aplicação suporta apenas uma extensão.

Para obter mais informações, consulte o manifesto de Suplementos do Office para o Microsoft 365.

extensions.requirements

O extensions.requirements objeto especifica os âmbitos, os fatores de formulário e os conjuntos de requisitos da Biblioteca JavaScript do Office que têm de ser suportados no cliente do Office para que o suplemento seja instalado. Os requisitos também são suportados nas propriedades subordinadas "ribbon", "runtime", "alternates" e "autoRunEvents" para filtrar seletivamente algumas funcionalidades do suplemento. Para obter mais informações, consulte Especificar os requisitos do Suplemento do Office no manifesto unificado do Microsoft 365.

extensions.runtimes

Opcional – Matriz

A extensions.runtimes matriz configura os conjuntos de runtimes e ações que cada ponto de extensão pode utilizar.

Para utilizar extensions.runtimeso , veja criar comandos de suplementos, configurar o runtime para um painel de tarefas e configurar o runtime para o comando da função.

extensions.ribbons

Opcional – Matriz

A extensions.ribbons propriedade fornece a capacidade de adicionar comandos de suplemento ( botões e itens de menu) ao friso da aplicação do Microsoft 365. A definição do friso é selecionada na matriz com base nos requisitos e na ordem inicial.

Para utilizar extensions.ribbonso , veja criar comandos de suplemento,configurar a IU para o comando do painel de tarefas e configurar a IU para o comando de função.

extensions.autoRunEvents

Opcional – Matriz

A extensions.autoRunEvents propriedade define pontos de extensão de ativação baseados em eventos.

extensions.alternates

Opcional – Matriz

A extensions.alternates propriedade é utilizada para ocultar ou atribuir prioridades a suplementos específicos no mercado quando tiver publicado vários suplementos com funcionalidades sobrepostas.

dashboardCards

Opcional – Matriz

Define uma lista de cartões que podem ser afixados a um dashboard, como Microsoft Viva Connections, para fornecer uma vista resumida das informações da aplicação. Para saber mais sobre como criar cartões para Viva Connections Dashboard, veja Descrição geral das Extensões de Cartão Adaptável Com Tecnologia de Bot.

Este item é uma matriz de dashboardCard elementos do tipo object.

dashboardCards.dashboardCard

Define um único dashboard card e as respetivas propriedades.

dashboardCards.dashboardCard.icon

Define as propriedades do ícone de um determinado dashboard card.

dashboardCards.dashboardCard.contentSource

Define a origem de conteúdo de uma determinada dashboard card.

dashboardCards.dashboardCard.contentSource.botConfiguration

Criar um ficheiro de manifesto de aplicação

Se a sua aplicação não tiver um ficheiro de manifesto de aplicação, terá de criá-lo.

Para criar um ficheiro de manifesto de aplicação:

1. Utilize o esquema de manifesto da aplicação de exemplo para criar um ficheiro de .json.
2. Salve-o na raiz da pasta do seu projeto como manifest.json.

{ 
"$schema": "https://developer.microsoft.com/json-schemas/teams/v1.11/MicrosoftTeams.schema.json", 
"manifestVersion": "1.12", 
"version": "1.0.0", 
"id": "{new GUID for this Teams app - not the Microsoft Entra App ID}", 
"developer": { 
"name": "Microsoft", 
"websiteUrl": "https://www.microsoft.com", 
"privacyUrl": "https://www.microsoft.com/privacy", 
"termsOfUseUrl": "https://www.microsoft.com/termsofuse" 
}, 

"name": { 
  "short": "Teams Auth SSO", 
  "full": "Teams Auth SSO" 
}, 


"description": { 
  "short": "Teams Auth SSO app", 
  "full": "The Teams Auth SSO app" 
}, 

"icons": { 
  "outline": "outline.png", 
  "color": "color.png" 
}, 

"accentColor": "#60A18E", 
"staticTabs": [ 
  { 
   "entityId": "auth", 
   "name": "Auth", 
   "contentUrl": "https://subdomain.example.com/Home/Index", 
   "scopes": [ "personal" ] 
  } 
], 

"configurableTabs": [ 
  { 
   "configurationUrl": "https://subdomain.example.com/Home/Configure", 
   "canUpdateConfiguration": true, 
   "scopes": [ 
   "team" 
    ] 
  } 
], 
"permissions": [ "identity", "messageTeamMembers" ], 
"validDomains": [ 
 "{subdomain or ngrok url}" 
], 
"webApplicationInfo": { 
  "id": "{Microsoft Entra AppId}", 
  "resource": "api://subdomain.example.com/{Microsoft Entra AppId}" 
}
} 

Confira também

• Compreender a estrutura do aplicativo Microsoft Teams
• Habilitar personalização de aplicativo
• Localizar o aplicativo
• Integrar recursos de mídia
• Esquema de manifesto da aplicação de pré-visualização do programador público