Esquema de manifesto de aplicativo de visualização do desenvolvedor público

Artigo
04/13/2024

Para obter informações sobre como habilitar o Developer Preview, confira Developer Preview público para Microsoft Teams.

Observação

Se você não estiver usando recursos de visualização do desenvolvedor, incluindo a execução de guias pessoais e extensões de mensagens do Teams no Outlook e no aplicativo Microsoft 365, use o manifesto do aplicativo (anteriormente chamado de manifesto de aplicativo do Teams) para recursos de GA (geralmente disponíveis).

O manifesto do aplicativo descreve como o aplicativo se integra à plataforma do Microsoft Teams. O manifesto do seu aplicativo deve estar em conformidade com o esquema hospedado em https://developer.microsoft.com/json-schemas/teams/vDevPreview/MicrosoftTeams.schema.json.

Manifesto de aplicativo de exemplo

{
    "$schema": "https://developer.microsoft.com/json-schemas/teams/vDevPreview/MicrosoftTeams.schema.json",
    "manifestVersion": "devPreview",
    "version": "1.0.0",
    "id": "%MICROSOFT-APP-ID%",
    "devicePermissions": [
        "geolocation",
        "media"
    ],
    "developer": {
        "name": "Publisher Name",
        "websiteUrl": "https://website.com/",
        "privacyUrl": "https://website.com/privacy",
        "termsOfUseUrl": "https://website.com/app-tos",
        "mpnId": "1234567890"
    },
    "localizationInfo": {
        "defaultLanguageTag": "es-es",
        "additionalLanguages": [
            {
                "languageTag": "en-us",
                "file": "en-us.json"
            }
        ]
    },
    "name": {
        "short": "Name of your app (<=30 chars)",
        "full": "Full name of app, if longer than 30 characters"
    },
    "description": {
        "short": "Short description of your app",
        "full": "Full description of your app"
    },
    "icons": {
        "outline": "%FILENAME-32x32px%",
        "color": "%FILENAME-192x192px"
    },
    "accentColor": "%HEX-COLOR%",
    "configurableTabs": [
        {
            "configurationUrl": "https://contoso.com/teamstab/configure",
            "canUpdateConfiguration": true,
            "scopes": [
                "team",
                "groupchat"
            ],
            "context": []
        }
    ],
    "staticTabs": [
        {
            "entityId": "idForPage",
            "name": "Display name of tab",
            "contentUrl": "https://contoso.com/content?host=msteams",
            "contentBotId": "Specifies to the app that tab is an Adaptive Card Tab. You can either provide the contentBotId or contentUrl.",
            "websiteUrl": "https://contoso.com/content",
            "scopes": [
                "personal"
            ]
        }
    ],
    "bots": [
        {
            "botId": "%MICROSOFT-APP-ID-REGISTERED-WITH-BOT-FRAMEWORK%",
            "needsChannelSelector": false,
            "isNotificationOnly": false,
            "scopes": [
                "team",
                "personal",
                "groupchat"
            ],
            "supportsFiles": true,
            "commandLists": [
                {
                    "scopes": [
                        "team",
                        "groupchat"
                    ],
                    "commands": [
                        {
                            "title": "Command 1",
                            "description": "Description of Command 1"
                        },
                        {
                            "title": "Command N",
                            "description": "Description of Command N"
                        }
                    ]
                },
                {
                    "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%",
            "configurationUrl": "https://contoso.com/teamsconnector/configure",
            "scopes": [
                "team"
            ]
        }
    ],
    "composeExtensions": [
        {
            "botId": "%MICROSOFT-APP-ID-REGISTERED-WITH-BOT-FRAMEWORK%",
            "canUpdateConfiguration": true,
            "commands": [
                {
                    "id": "exampleCmd1",
                    "title": "Example Command",
                    "description": "Command Description; e.g., Search on the web",
                    "initialRun": true,
                    "type": "search",
                    "context": [
                        "compose",
                        "commandBox"
                    ],
                    "parameters": [
                        {
                            "name": "keyword",
                            "title": "Search keywords",
                            "description": "Enter the keywords to search for"
                        }
                    ]
                },
                {
                    "id": "exampleCmd2",
                    "title": "Example Command 2",
                    "description": "Command Description; e.g., Search for a customer",
                    "initialRun": true,
                    "type": "action",
                    "fetchTask": true,
                    "context": [
                        "message"
                    ],
                    "parameters": [
                        {
                            "name": "custinfo",
                            "title": "Customer name",
                            "description": "Enter a customer name",
                            "inputType": "text"
                        }
                    ]
                },
                {
                    "id": "exampleMessageHandler",
                    "title": "Message Handler",
                    "description": "Domains that will create a preview when pasted into the compose box",
                    "messageHandlers": [
                        {
                            "type": "link",
                            "value": {
                                "domains": [
                                    "mysite.someplace.com",
                                    "othersite.someplace.com"
                                ]
                            }
                        }
                    ]
                }
            ]
        }
    ],
    "permissions": [
        "identity",
        "messageTeamMembers"
    ],
    "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"
                }
            ]
        }
    },
    "configurableProperties": [
        "name",
        "shortDescription",
        "longDescription",
        "smallImageUrl",
        "largeImageUrl",
        "accentColor",
        "developerUrl",
        "privacyUrl",
        "termsOfUseUrl"
    ],
    "defaultInstallScope": "meetings",
    "defaultGroupCapability": {
        "meetings": "tab",
        "team": "bot",
        "groupchat": "bot"
    },
    "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 de caracteres

A https:// URL que faz referência ao Esquema JSON para o manifesto do aplicativo.

manifestVersion

Obrigatório – Cadeia de caracteres

A versão do esquema de manifesto do aplicativo que esse manifesto está usando.

versão

Obrigatório – Cadeia de caracteres

A versão do aplicativo específico. Se você atualizar algo no manifesto do aplicativo, a versão também deverá ser incrementada. Dessa forma, quando o novo manifesto do aplicativo é instalado, ele substitui o existente e o usuário obtém a nova funcionalidade. Se esse aplicativo foi enviado para a Microsoft Teams Store, o novo manifesto do aplicativo deverá ser reenviado e revalidado. Em seguida, os usuários deste aplicativo receberão o novo manifesto de aplicativo atualizado automaticamente em algumas horas, depois de aprovado.

Se as permissões solicitadas pelo 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).

Observação

Se o aplicativo incluir um Suplemento do Office, cada segmento da cadeia de caracteres de versão será limitado a um máximo de cinco dígitos. Não há suporte para extensões de cadeia de caracteres de versão de versão de pré-lançamento e metadados do padrão semver.

id

Obrigatório – ID do aplicativo microsoft

O identificador exclusivo gerado pela Microsoft para esse aplicativo. O formato da ID é GUID. Se você registrou um bot por meio de Microsoft Bot Framework ou o aplicativo Web da sua guia já entrar com a Microsoft, talvez você já tenha uma ID e deve inseri-lo aqui. Caso contrário, você deve gerar uma nova ID no Portal de Registro de Aplicativos da Microsoft (Meus Aplicativos), inseri-la aqui e reutilizá-la quando adicionar um bot.

developer

Obrigatório – Objeto

Especifica informações sobre a sua empresa. Para aplicativos enviados ao Microsoft AppSource (antigo Office Store), esses valores devem corresponder às informações em sua entrada do AppSource.

Nome	Tamanho máximo	Obrigatório	Descrição
`name`	32 caracteres	✔️	O nome de exibição do desenvolvedor.
`websiteUrl`	2048 caracteres	✔️	A URL https:// para o site do desenvolvedor. Esse link deve levar os usuários à página de destino específica da sua empresa ou do produto.
`privacyUrl`	2048 caracteres	✔️	A URL https:// para a política de privacidade do desenvolvedor.
`termsOfUseUrl`	2048 caracteres	✔️	A URL https:// para os termos de uso do desenvolvedor.
`mpnId`	10 caracteres		Opcional A ID do Microsoft Partner Network que identifica a organização parceira criadora do aplicativo.

localizationInfo

Opcional – Objeto

Permite a especificação de um idioma padrão e ponteiros para arquivos de idioma adicionais. Consulte a localização.

Nome	Tamanho máximo	Obrigatório	Descrição
`defaultLanguageTag`	4 caracteres	✔️	A marca de idioma das cadeias de caracteres neste arquivo de manifesto de aplicativo de nível superior.

localizationInfo.additionalLanguages

Uma matriz de objetos especificando traduções de idiomas adicionais.

Nome	Tamanho máximo	Obrigatório	Descrição
`languageTag`	4 caracteres	✔️	A marca de idioma das cadeias de caracteres no arquivo fornecido.
`file`	2048 caracteres	✔️	Um caminho de arquivo relativo para o arquivo .json que contém as cadeias de caracteres traduzidas.

nome

Obrigató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.

Nome	Tipo	Tamanho máximo	Obrigatório	Descrição
`short`	Cadeia de caracteres	30 caracteres	✔️	O nome de exibição curto para o aplicativo.
`full`	Cadeia de caracteres	100 caracteres	✔️	O nome completo do aplicativo. Ele será usado se o nome completo do aplicativo exceder 30 caracteres.

description

Obrigató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.

Certifique-se de que a sua descrição detalhe corretamente a sua experiência e forneça informações para ajudar 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 descrição curta não deve ser repetida na descrição longa e não deve incluir nenhum outro nome de aplicativo.

Nome	Tamanho máximo	Obrigatório	Descrição
`short`	80 caracteres	✔️	Uma descrição curta da experiência do seu aplicativo, usada quando o espaço é limitado.
`full`	4000 caracteres	✔️	A descrição completa do seu aplicativo.

ícones

Obrigatório – Objeto

Ícones usados no aplicativo Teams. Os arquivos de ícone devem ser incluídos como parte do pacote de upload.

Nome	Tamanho máximo	Obrigatório	Descrição
`outline`	2048 caracteres	✔️	Um caminho de arquivo relativo para um ícone de contorno PNG transparente de 32x32. A cor da borda deve ser branca.
`color`	2048 caracteres	✔️	Um caminho de arquivo relativo para um ícone PNG colorido de 192x192.

accentColor

Obrigatório – Cadeia de caracteres

Uma cor a ser usada com e como plano de fundo para seus ícones de contorno.

O valor deve ser um código de cor HTML válido começando com '#', por exemplo #4464ee.

configurbleTabs

Opcional – Matriz

Usado quando sua experiência de aplicativo tem uma experiência de guia de canal de equipe que requer configuração extra antes de ser adicionada. As guias configuráveis têm suporte apenas no escopo das equipes e, atualmente, há suporte apenas para uma guia por aplicativo.

O objeto é uma matriz com todos os elementos do tipo object. Esse bloco é necessário apenas para soluções que fornecem uma solução de guia de canal configurável.

Nome	Tipo	Tamanho máximo	Obrigatório	Descrição
`configurationUrl`	Cadeia de caracteres	2048 caracteres	✔️	A URL https:// a ser usada ao configurar a guia.
`canUpdateConfiguration`	Boolean			Um valor que indica se uma instância da configuração da guia pode ser atualizada pelo usuário após a criação. Valor padrão: `true`
`scopes`	Matriz de enumeração	2	✔️	Atualmente, as guias configuráveis são compatíveis apenas com os escopos `team` e `groupChat`.
`context`	Matriz de enumeração	8		O conjunto de `contextItem` escopos em que uma guia é compatível. Valores padrão: `channelTab`, , `privateChatTab`, `meetingChatTab`, `meetingDetailsTab`, `meetingSidePanel`, `meetingStage`, `personalTab`.
`sharePointPreviewImage`	Cadeia de caracteres	2048 caracteres		Um caminho de arquivo relativo para uma imagem de visualização de guia para uso no SharePoint. Tamanho 1024x768.
`supportedSharePointHosts`	Matriz de enumeração	2		Define como a sua guia é disponibilizada no SharePoint. As opções são `sharePointFullPage`, `sharePointWebPart`
`meetingSurfaces`	Matriz de enumeração	2		O conjunto de `meetingSurfaceItem` escopos ao qual uma guia pertence. Valores padrão: `sidePanel`, `stage`
`supportedPlatform`	Matriz de enumeração	3		O conjunto de `supportedPlatform` escopos ao qual uma guia pertence. Valores padrão: `desktop`, , `mobileteamsMeetingDevices`

staticTabs

Opcional – Matriz

Define um conjunto de guias que podem ser "fixadas" por padrão, sem que o usuário as adicione manualmente. As guias estáticas declaradas no escopo personal são sempre vinculadas à experiência pessoal do aplicativo. As guias estáticas declaradas no escopo team não são suportadas no momento.

Renderize guias com Cartões Adaptáveis especificando contentBotId em vez de contentUrl no bloco staticTabs.

O objeto é 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.

Nome	Tipo	Tamanho máximo	Obrigatório	Descrição
`entityId`	String	64 caracteres	✔️	Um identificador exclusivo para a entidade que a guia exibe.
`name`	Cadeia de caracteres	128 caracteres	✔️	O nome de exibição da guia.
`contentUrl`	Cadeia de caracteres	2048 caracteres	✔️	A URL https:// que aponta para a interface do usuário da entidade a ser exibida na tela do Teams.
`contentBotId`	Cadeia de caracteres			A ID do Aplicativo do Microsoft Teams especificada para o bot no portal do Bot Framework.
`websiteUrl`	Cadeia de caracteres	2048 caracteres		A URL https:// para apontar se um usuário optar por visualizar em um navegador.
`scopes`	Matriz de enumeração	3	✔️	As guias estáticas dão suporte aos escopos , `team`e `groupChat` , o `personal`que significa que ele pode ser provisionado como parte da experiência de reuniões pessoais, de grupo e de canais.
`searchUrl`	Cadeia de caracteres	2048 caracteres		O https:// URL para direcionar as consultas de pesquisa de um usuário.
`context`	Matriz de enumeração	8		O conjunto de `contextItem` escopos ao qual uma guia pertence. Valores padrão: `personalTab`, , `channelTab`, `privateChatTab`, `meetingChatTab`, `meetingDetailsTab`, `meetingSidePanel`, , `meetingStageteamLevelApp`
`supportedPlatform`	Matriz de enumeração	3		O conjunto de `supportedPlatform` escopos ao qual uma guia pertence. Valores padrão: `desktop`, , `mobileteamsMeetingDevices`

bots

Opcional – Matriz

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

O objeto é uma matriz (no máximo 1 elemento , atualmente, apenas um bot é permitido por aplicativo) com todos os elementos do tipo object. Esse bloco é necessário apenas para soluções que fornecem uma experiência de bot.

Nome	Tipo	Tamanho máximo	Obrigatório	Descrição
`botId`	Cadeia de caracteres		✔️	O ID exclusivo do aplicativo Microsoft para o bot conforme registrado na estrutura do bot. A ID pode ser igual a ID do aplicativo geral.
`needsChannelSelector`	Booliano			Descreve se o bot utiliza uma dica de usuário para adicionar o bot a um canal específico. Valor padrão: `false`
`isNotificationOnly`	Boolean			Indica se um bot é um bot unidirecional, somente para notificação, em vez de um bot de conversa. Valor padrão: `false`
`supportsFiles`	Boolean			Indica se o bot é compatível com a capacidade de carregar/baixar arquivos em chat pessoal. Valor padrão: `false`
`scopes`	Matriz de enumeração	3	✔️	Especifica se o bot oferece uma experiência no contexto de um canal em um `team`, em um chat de grupo (`groupChat`) ou uma experiência delimitada apenas a um usuário individual (`personal`). Essas opções não são inexclusivas.
`supportsCalling`	Booliano			Um valor que indica onde um bot dá suporte a chamadas de áudio. IMPORTANTE: Esta propriedade é experimental no momento. As propriedades experimentais podem estar incompletas e podem sofrer alterações antes de estarem totalmente disponíveis. A propriedade é fornecida apenas para fins de teste e exploração e não deve ser usada em aplicativos de produção. Valor padrão: `false`
`supportsVideo`	Booliano			Um valor que indica onde um bot oferece suporte a chamadas com vídeo. IMPORTANTE: Esta propriedade é experimental no momento. As propriedades experimentais podem estar incompletas e podem sofrer alterações antes de estarem totalmente disponíveis. A propriedade é fornecida apenas para fins de teste e exploração e não deve ser usada em aplicativos de produção. Valor padrão: `false`
`requiresSecurityEnabledGroup`	Booliano			Um valor que indica se o grupo do Office da equipe precisa estar habilitado para segurança. Valor padrão: `false`

bots.configuration

Nome	Tipo	Tamanho máximo	Obrigatório	Descrição
`team.fetchTask`	Booliano		✔️	Um valor booliano que indica se ele deve buscar a caixa de diálogo (conhecido como módulo de tarefa no TeamsJS v1.x) dinamicamente. Valor padrão: `false`
`team.taskInfo.title`	String	64 caracteres	✔️	Título inicial da caixa de diálogo.
`team.taskInfo.width`	Cadeia de caracteres	16		A largura da caixa de diálogo é um número em pixels ou layout padrão, como `large`, `medium`ou `small`.
`team.taskInfo.height`	Cadeia de caracteres	16		A altura da caixa de diálogo é um número em pixels ou layout padrão, como `large`, `medium`ou `small`.
`team.taskInfo.url`	Cadeia de caracteres	2048 caracteres		URL inicial da webview.
`groupChat.fetchTask`	Booliano		✔️	Um valor booliano que indica se ele deve buscar a caixa de diálogo dinamicamente. Valor padrão: `false`
`groupChat.taskInfo`	Objeto			Caixa de diálogo a ser iniciada quando a tarefa de busca é definida como false. Valor padrão: `false`
`groupChat.taskInfo.title`	String	64 caracteres	✔️	Título inicial da caixa de diálogo.
`groupChat.taskInfo.width`	Cadeia de caracteres	16		A largura da caixa de diálogo é um número em pixels ou layout padrão, como `large`, `medium`ou `small`.
`groupChat.taskInfo.height`	Cadeia de caracteres	16		A altura da caixa de diálogo é um número em pixels ou layout padrão, como `large`, `medium`ou `small`.
`groupChat.taskInfo.url`	Cadeia de caracteres	2048 caracteres		URL inicial da webview.

bots.commandLists

Uma lista opcional de comandos que seu bot pode recomendar aos usuários. O objeto é uma matriz (máximo de dois elementos) com todos os elementos do tipo object. Você deve definir uma lista de comandos separada para cada escopo que o seu bot oferece suporte. Para obter mais informações, confira Menus de Bot.

Nome	Tipo	Tamanho máximo	Obrigatório	Descrição
`items.scopes`	Matriz de enumeração	3	✔️	Especifica o escopo para o qual a lista de comandos é válida. As opção são `team`, `personal` e `groupChat`.
`items.commands`	Matriz de objetos	10	✔️	Uma matriz de comandos que o bot suporta: `title`: o nome do comando do bot (cadeia de caracteres, 32). `description`: uma descrição simples ou exemplo da sintaxe do comando e seu argumento (cadeia, 128)

conectores

Opcional – Matriz

O connectors bloco define um conector para Grupos do Microsoft 365 para o aplicativo.

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

Nome	Tipo	Tamanho máximo	Obrigatório	Descrição
`configurationUrl`	Cadeia de caracteres	2048 caracteres	✔️	O https:// URL a ser usado ao configurar o conector usando a experiência de configuração embutida.
`connectorId`	String	64 caracteres	✔️	Um identificador exclusivo para o Conector que corresponde a sua ID no Painel do Desenvolvedor de Conectores.
`scopes`	Matriz de enumeração	1	✔️	Especifica se o Conector oferece uma experiência no contexto de um canal em um `team`, ou uma experiência com escopo apenas para um usuário individual (`personal`). Atualmente, apenas o escopo `team` é compatível.

composeExtensions

Opcional – Matriz

Define uma extensão de mensagens para o aplicativo.

Observação

O nome do recurso foi alterado de "extensão de composição" para "extensão de mensagem" em novembro de 2017, mas o nome do manifesto do aplicativo permanece o mesmo para que as extensões existentes continuem funcionando.

O objeto é 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 mensagem.

Nome	Tipo	Tamanho Máximo	Descrição
`botId`	Cadeia de caracteres		A ID exclusiva do aplicativo da Microsoft para o bot que oferece suporte à extensão de mensagens, conforme registrado no Bot Framework. A ID pode ser igual a ID do aplicativo geral.
`composeExtensionType`	Cadeia de caracteres		Tipo da extensão de composição. Os valores de enumeração são `botBased` e `apiBased`.
`authorization`	Objeto	2	Informações relacionadas à autorização para a extensão de mensagem baseada em API
`authorization.authType`	Cadeia de caracteres		Enumeração de possíveis tipos de autorização. Os valores com suporte são `none`, `apiSecretServiceAuth`e `microsoftEntra`.
`authorization.microsoftEntraConfiguration`	Objeto		Detalhes de captura de objeto necessários para fazer o fluxo de auth microsoftEntra. Aplicável somente quando o tipo de auth for `microsoftEntra`.
`authorization.microsoftEntraConfiguration.supportsSingleSignOn`	booliano		Um valor que indica se o logon único está configurado para o aplicativo.
`authorization.apiSecretServiceAuthConfiguration`	Objeto		Detalhes de captura de objeto necessários para fazer a auth de serviço. Aplicável somente quando o tipo de auth for `apiSecretServiceAuth`.
`authorization.apiSecretServiceAuthConfiguration.apiSecretRegistrationId`	Cadeia de caracteres	128 caracteres	ID de registro retornada quando o desenvolvedor envia a chave da API por meio do Portal do Desenvolvedor.
`apiSpecificationFile`	Cadeia de caracteres	2048 caracteres	Um caminho de arquivo relativo para o arquivo de especificação de api no pacote de manifesto.
`canUpdateConfiguration`	Booliano		Um valor que indica se a configuração de uma extensão de mensagem pode ser atualizada pelo usuário. Valor padrão: `true`
`commands`	Matriz de objeto	10	Matriz de comandos com suporte da extensão de mensagens.
`messageHandlers`	Matriz de objetos	5	Uma lista de manipuladores que permitem que aplicativos sejam invocados quando determinadas condições são atendidas. Os domínios também devem ser listados em `validDomains`.
`messageHandlers.type`	Cadeia de caracteres		O tipo de manipulador de mensagens. Deve ser `"link"`.
`messageHandlers.value.domains`	Matriz de cadeias de caracteres	2048 caracteres	Matriz de domínios para os quais o manipulador de mensagens de link pode se registrar.
`messageHandlers.supportsAnonymizedPayloads`	Booliano		Um valor booliano que indica se o manipulador de mensagens de link do aplicativo dá suporte ao fluxo de invocação anônimo. Valor padrão: `false` Para habilitar a instalação zero para a desenrolação de link, o valor precisa ser definido como `true`. Observação: a propriedade `supportAnonymousAccess` é substituída por `supportsAnonymizedPayloads`.
`type`	Tipo da extensão de composição. Os valores com suporte são `apiBased` ou `botBased`.

composeExtensions.commands

Sua extensão de mensagem deve declarar um ou mais comandos. Cada comando aparece no Teams como uma possível interação do ponto de entrada baseado em interface do usuário. Há no máximo 10 comandos.

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

Nome	Tipo	Tamanho máximo	Obrigatório	Descrição
`id`	String	64 caracteres	✔️	A ID do comando.
`type`	String	64 caracteres		O tipo do comando. Um de `query` ou `action`. Padrão: `query`
`samplePrompts`	array	5	Não	Propriedade usada por Copilot para exibir prompts com suporte pelo plug-in para o usuário.
`samplePrompts.text`	string	128 caracteres	✔️	Conteúdo do prompt de exemplo.
`apiResponseRenderingTemplateFile`	Cadeia de caracteres	2048 caracteres		Um caminho de arquivo relativo para o arquivo de modelo de renderização de resposta de api usado para formatar a resposta JSON da API do desenvolvedor para a resposta do Cartão Adaptável.
`context`	Matriz de cadeias de caracteres	3 caracteres		Define de onde a extensão da mensagem pode ser invocada. Qualquer combinação de `compose`, `commandBox` e `message`. Valores padrão: `compose, commandBox`
`title`	Cadeia de caracteres	32 caracteres	✔️	O nome do comando amigável.
`description`	Cadeia de caracteres	128 caracteres		A descrição que aparece para os usuários para indicar a finalidade deste comando.
`semanticDescription`	Cadeia de caracteres	5000 caracteres		Descrição semântica do comando para consumo por Copilot usando llm (modelo de linguagem grande).
`initialRun`	Booliano			Um valor booliano que indica se o comando é executado inicialmente sem parâmetros. Valor padrão: `false`
`fetchTask`	Booliano			Um valor booliano que indica se ele deve buscar a caixa de diálogo dinamicamente.
`taskInfo`	Objeto			Especifique a caixa de diálogo para pré-carregar ao usar um comando de extensão de mensagem.
`taskInfo.title`	String	64 caracteres		Título inicial da caixa de diálogo.
`taskInfo.width`	Cadeia de caracteres			Largura da caixa de diálogo – um número em pixels ou layout padrão, como `large`, `medium`ou `small`.
`taskInfo.height`	Cadeia de caracteres			Altura da caixa de diálogo – um número em pixels ou layout padrão, como `large`, `medium`ou `small`.
`taskInfo.url`	Cadeia de caracteres	2048 caracteres		URL inicial da webview.
`parameters`	Matriz de objeto	5		A lista de parâmetros que o comando usa. Mínimo: 1; máximo: 5.
`parameter.name`	String	64 caracteres	✔️	O nome do parâmetro como ele aparece no cliente. Isso está incluído na solicitação de usuário. Para a extensão de mensagem baseada em API, o nome deve ser mapeado para o `parameters.name` na Descrição OpenAPI. Se você estiver fazendo referência a uma propriedade no esquema do corpo da solicitação, o nome deverá mapear `properties.name` para ou consultar parâmetros.
`parameter.title`	Cadeia de caracteres	32 caracteres	✔️	Título amigável para o parâmetro.
`parameter.description`	Cadeia de caracteres	128 caracteres		Cadeia de caracteres amigável que descreve a finalidade desse parâmetro.
`parameter.semanticDescription`	Cadeia de caracteres	2000 caracteres		Descrição semântica do parâmetro para consumo pelo modelo de linguagem grande.
`parameter.inputType`	Cadeia de caracteres			Define o tipo de controle exibido em uma caixa de diálogo para `fetchTask: false`. Um de `text`, `textarea`, `number`, `date`, `time`, `toggle` e `choiceset`.
`parameter.value`	Cadeia de caracteres	512 caracteres		Valor inicial para o parâmetro.
`parameter.choices`	Matriz de objetos	10		As opções de escolha para `choiceset`. Use apenas quando `parameter.inputType` for `choiceset`.
`parameter.choices.title`	Cadeia de caracteres	128 caracteres	✔️	Títulor da escolha.
`parameter.choices.value`	Cadeia de caracteres	512 caracteres	✔️	O valor da escolha.

scopeConstraints

As restrições de escopo impostas a um aplicativo para especificar em quais threads você pode instalar o aplicativo. Quando nenhuma restrição for especificada, você pode instalar o aplicativo em todos os threads dentro do escopo específico.

Opcional – Objeto

Nome	Tipo	Tamanho Máximo	Obrigatório	Descrição
`teams`	Matriz	128		Uma lista de IDs de thread de equipe às quais seu aplicativo é restrito.
`teams.id`	String	64 caracteres	✔️	ID do thread da equipe.
`groupChats`	Matriz	128		Uma lista de IDs de thread de chat às quais seu aplicativo é restrito.
`groupChats.id`	String	64 caracteres	✔️	ID do thread do chat.

permissões

Opcional – Matriz de cadeias de caracteres

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

identity Requer informações de identidade do usuário.
messageTeamMembers Requer permissão para enviar mensagens diretas aos membros da equipe.

Alterar essas permissões ao atualizar seu aplicativo faz com que os usuários repitam o processo de consentimento na primeira vez que executam o aplicativo atualizado.

devicePermissions

Opcional – Matriz de Cadeias de Caracteres

Especifica os recursos nativos no dispositivo de um usuário ao qual seu aplicativo pode solicitar acesso. As opções são:

geolocation
media
notifications
midi
openExternal

validDomains

Opcional, exceto Obrigatório onde indicado.

Uma lista de domínios válidos dos quais o aplicativo espera carregar qualquer conteúdo. As listagens de domínio podem incluir caracteres curinga, 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 configuração da guia ou a interface do usuário de conteúdo precisar ir para qualquer outro domínio além do uso para configuração de guia, esse domínio deve ser especificado aqui.

Observação

Os suplementos do Office, configurados com uma extensions propriedade no manifesto, desconsideram domínios que contêm um curinga. Se o aplicativo incorporar um Suplemento do Office, especifique o nome de domínio completo para os domínios que o suplemento acessará.

No entanto, não é necessário incluir os domínios dos provedores de identidade que você deseja dar suporte em seu aplicativo. Por exemplo, para autenticar usando uma ID do Google, é necessário redirecionar para accounts.google.com, mas você não deve incluir accounts.google.com no validDomains[].

Importante

Não adicione domínios que estão fora de seu controle, seja diretamente ou por meio de curingas. Por exemplo, yourapp.onmicrosoft.com é válido, mas *.onmicrosoft.com não é válido.

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

webApplicationInfo

Opcional – Objeto

Especifique a ID do aplicativo Microsoft Entra e as informações do Graph para ajudar os usuários a entrar perfeitamente em seu aplicativo Microsoft Entra.

Nome	Tipo	Tamanho máximo	Obrigatório	Descrição
`id`	Cadeia de caracteres		✔️	Microsoft Entra ID do aplicativo. Essa ID deve ser um GUID.
`resource`	Cadeia de caracteres	2048 caracteres		URL de recurso do aplicativo para adquirir token de autenticação para logon único.

graphConnector

Opcional – Objeto

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

Nome	Tipo	Tamanho máximo	Obrigatório	Descrição
`notificationUrl`	string	2048 caracteres	✔️	A URL https:// em que as notificações do conector do Graph para o aplicativo devem ser enviadas.

showLoadingIndicator

Opcional – booliano

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

Observação

Se você selecionar showLoadingIndicator como true no manifesto do aplicativo, para carregar a página corretamente, modifique as páginas de conteúdo de suas guias e caixas de diálogo, conforme descrito em Mostrar um documento indicador de carregamento nativo .
Se você não modificar as páginas de conteúdo da guia, o aplicativo de guias não carregará e mostrará o erro There was a problem reaching this app.

isFullScreen

Opcional – booliano

Indique onde um aplicativo pessoal é renderizado com ou sem uma barra de cabeçalho de guia.
Valor padrão: false

Observação

isFullScreen funciona apenas para aplicativos publicados em sua organização.

activities

Opcional – Objeto

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

Nome	Tipo	Tamanho máximo	Obrigatório	Descrição
`activityTypes`	Matriz de objetos	128 itens		Forneça os tipos de atividades que seu aplicativo pode postar no feed de atividades de um usuário. O `systemDefault` tipo de atividade é uma cadeia de caracteres reservada e inválida.

activities.activityTypes

Nome	Tipo	Tamanho máximo	Obrigatório	Descrição
`type`	Cadeia de caracteres	32 caracteres	✔️	O tipo de notificação. Confira a seguir.
`description`	Cadeia de caracteres	128 caracteres	✔️	Uma breve descrição da notificação. Confira a seguir.
`templateText`	Cadeia de caracteres	128 caracteres	✔️	Ex: "{actor} criou a tarefa {taskId} para você"

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

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.

Observação

Um mínimo de uma propriedade deve ser definido. Você pode definir um máximo de nove propriedades neste bloco.

Você pode definir qualquer uma das seguintes propriedades:

name: O nome de exibição do aplicativo.
shortDescription: A breve descrição do aplicativo.
longDescription: descrição detalhada do aplicativo.
smallImageUrl: O ícone de contorno do aplicativo.
largeImageUrl: O ícone de cor do aplicativo.
accentColor: a cor a ser usada com e como plano de fundo para seus ícones de contorno.
developerUrl: A URL HTTPS do site do desenvolvedor.
privacyUrl: A URL HTTPS da política de privacidade do desenvolvedor.
termsOfUseUrl: A URL HTTPS dos termos de uso do desenvolvedor.

supportedChannelTypes

Opcional – Matriz

Habilita seu aplicativo em canais não padrão. 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. Atualmente, há suporte para os tipos de canais privados e compartilhados.

Observação

Se seu aplicativo der suporte a um escopo de equipe, ele funciona nos canais padrão independentemente dos valores que são definidos nesta propriedade.
Seu aplicativo pode levar em conta as propriedades únicas de cada um dos tipos de canal para funcionar corretamente. Para habilitar sua guia para canais privados e compartilhados, confira Recuperar contexto em canais privados e obter contexto em canais compartilhados

defaultBlockUntilAdminAction

Opcional – booliano

Um valor que indica se um aplicativo é bloqueado por padrão até que o administrador o permita.
Valor padrão: false

publisherDocsUrl

Opcional – Cadeia de caracteres

O https:// URL para a página que fornece informações adicionais do aplicativo para os administradores. O comprimento máximo da cadeia de caracteres é de 2048 caracteres.

defaultInstallScope

Opcional – Cadeia de caracteres

Especifica o escopo de instalação definido para este aplicativo por padrão. O escopo definido é a opção exibida no botão quando um usuário tenta adicionar o aplicativo. As opções são:

personal
team
groupChat
meetings

defaultGroupCapability

Opcional – Objeto

Quando um escopo de instalação de grupo é selecionado, ele define o recurso padrão quando o usuário instala o aplicativo. As opções são:

team
groupchat
meetings

Nome	Tipo	Descrição
`team`	Cadeia de caracteres	Quando o escopo de instalação selecionado é `team`, este campo especifica o recurso padrão disponível. Opções: `tab`, `bot` ou `connector`.
`groupchat`	Cadeia de caracteres	Quando o escopo de instalação selecionado é `groupchat`, este campo especifica o recurso padrão disponível. Opções: `tab`, `bot` ou `connector`.
`meetings`	Cadeia de caracteres	Quando o escopo de instalação selecionado é `meetings`, este campo especifica o recurso padrão disponível. Opções: `tab`, `bot` ou `connector`.

subscriptionOffer

Opcional – Objeto

Especifica a oferta de SaaS associada ao seu aplicativo.

Nome	Tipo	Tamanho máximo	Obrigatório	Descrição
`offerId`	string	2,048 caracteres	✔️	Um identificador exclusivo que inclui a sua ID de editor e ID de oferta, que você pode encontrar no Partner Center. Você deve formatar a cadeia de caracteres como `publisherId.offerId`.

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.

Nome	Tipo	Tamanho máximo	Descrição
`scenes`	Matriz de objetos	5 itens	Cenas suportadas da reunião.
`supportsStreaming`	Booliano		Um valor booliano que indica se um aplicativo pode transmitir o conteúdo de áudio e vídeo da reunião para um ponto de extremidade RTMP (protocolo de reunião em tempo real). Valor padrão: `false`
`videoFiltersConfigurationUrl`	Cadeia de caracteres	2048 caracteres	A URL https:// para configurar os filtros de vídeo.
`supportsAnonymousGuestUsers`	Booliano		Um valor booliano que indica se o aplicativo dá suporte ao acesso de usuários convidados anônimos. Valor padrão: `false`

meetingExtensionDefinition.scenes

Nome	Tipo	Tamanho máximo	Obrigatório	Descrição
`id`	Cadeia de caracteres		✔️	O identificador exclusivo para a cena. Essa ID deve ser um GUID.
`name`	Cadeia de caracteres	128 caracteres	✔️	O nome da cena.
`file`	Cadeia de caracteres	2048 caracteres	✔️	O caminho do arquivo relativo para o arquivo JSON de metadados das cenas.
`preview`	Cadeia de caracteres	2048 caracteres	✔️	O caminho do arquivo relativo para o ícone de visualização PNG das cenas.
`maxAudience`	Número inteiro	50	✔️	O número máximo de audiências suportadas na cena.
`seatsReservedForOrganizersOrPresenters`	Número inteiro	50	✔️	O número de assentos reservados para organizadores ou apresentadores.

meetingExtensionDefinition.videoFilters

Esse objeto indica filtros de vídeo compatíveis com a reunião.

Nome	Tipo	Tamanho máximo	Obrigatório	Descrição
`id`	Cadeia de caracteres		✔️	O identificador exclusivo para o filtro de vídeo. Essa ID deve ser um GUID.
`name`	Cadeia de caracteres	128 caracteres	✔️	O nome do filtro de vídeo.
`thumbnail`	Cadeia de caracteres	2048 caracteres	✔️	O caminho de arquivo relativo para a miniatura do filtro de vídeo.

autorização

Opcional – Objeto

Observação

authorization só há suporte para o manifesto do aplicativo versão 1.12 ou posterior.

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

Nome	Tipo	Tamanho máximo	Obrigatório	Descrição
`permissions`	Objeto			Lista de permissões que o aplicativo precisa para funcionar.

authorization.permissions

Nome	Tipo	Tamanho máximo	Obrigatório	Descrição
`resourceSpecific`	Matriz de objetos	16 itens		Permissões que protegem o acesso a dados no nível da instância do recurso.

authorization.permissions.resourceSpecific

Nome	Tipo	Tamanho máximo	Obrigatório	Descrição
`type`	Cadeia de caracteres		✔️	O tipo de permissão RSC (consentimento específico do recurso). Opções: `Application` e `Delegated`.
`name`	Cadeia de caracteres	128 caracteres	✔️	O nome da permissão RSC. Para obter mais informações, confira Permissões de aplicativo RSC e permissões delegadas do RSC

Permissões de aplicativo 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 aplicativo, confira Permissões RSC para Microsoft Graph e 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 equipe

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 o aplicativo detecte áudio de entrada em reuniões de canal associadas à equipe.
`ChannelMeetingActiveSpeaker.Read.Group`	Permite que o aplicativo leia os participantes que estão enviando áudio para as reuniões do canal associadas à equipe.
`ChannelMeetingAudioVideo.Stream.Group`	Permite que o aplicativo transmita conteúdo de áudio-vídeo de reuniões de canal associadas à equipe.
`InAppPurchase.Allow.Group`	Permite que o aplicativo mostre ofertas de marketplace aos usuários da equipe e conclua suas compras no aplicativo, em nome do usuário conectado.
`ChannelMeetingStage.Write.Group`	Permite que o aplicativo mostre conteúdo no estágio de reunião em reuniões de canal associadas à equipe, em nome do usuário conectado.
`LiveShareSession.ReadWrite.Group`	Permite que o aplicativo crie e sincronize sessões do Live Share para reuniões associadas à equipe. Forneça informações relacionadas ao acesso sobre a lista da reunião, como a função de reunião do membro, em nome do usuário conectado.
`MeetingParticipantReaction.Read.Group`	Permite que o aplicativo leia as reações dos participantes em reuniões de canal associadas à equipe.

Permissões delegadas do RSC para chats ou reuniões

Nome	Descrição
`InAppPurchase.Allow.Chat`	Permite que o aplicativo mostre ofertas de marketplace aos usuários no chat e em qualquer reunião associada e conclua suas compras no aplicativo, em nome do usuário conectado.
`MeetingStage.Write.Chat`	Permite que o aplicativo mostre conteúdo no estágio de reunião em reuniões associadas ao chat, em nome do usuário conectado.
`OnlineMeetingParticipant.Read.Chat`	Permite que o aplicativo leia informações do participante, incluindo nome, função, id, tempos ingressados e deixados, de reunião associada ao chat, em nome do usuário conectado.
`OnlineMeetingParticipant.ToggleIncomingAudio.Chat`	Permite que o aplicativo alterne o áudio de entrada para os participantes em reuniões associadas ao chat, em nome do usuário conectado.
`LiveShareSession.ReadWrite.Chat`	Permite que o aplicativo crie e sincronize sessões do Live Share para reuniões associadas ao chat. Forneça informações relacionadas ao acesso sobre a lista da reunião, como a função de reunião do membro, em nome do usuário conectado.
`MeetingParticipantReaction.Read.Chat`	Permite que o aplicativo leia as reações dos participantes em reuniões associadas ao chat.
`OnlineMeetingIncomingAudio.Detect.Chat`	Permite que o aplicativo detecte alterações no status de áudio de entrada em reuniões associadas ao chat, em nome do usuário conectado.
`OnlineMeetingActiveSpeaker.Read.Chat`	Permite que o aplicativo leia os participantes que estão enviando áudio para as reuniões associadas ao chat.
`OnlineMeetingAudioVideo.Stream.Chat`	Permite que o aplicativo transmita conteúdo de áudio-vídeo de reuniões associadas ao chat.

Permissões delegadas do RSC para usuários

Nome	Descrição
`CameraStream.Read.User`	Permite que o aplicativo leia o fluxo de câmera do usuário.
`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 o aplicativo modifique o vídeo de saída do usuário.
`MicrophoneStream.Read.User`	Permite que o aplicativo leia o fluxo de microfone do usuário.
`MeetingParticipantReaction.Read.User`	Permite que o aplicativo leia as reações do usuário durante a participação em uma reunião.

extensions

Opcional – Objeto

A extensions propriedade especifica suplementos do Outlook em um manifesto de aplicativo e simplifica a distribuição e a aquisição em todo o ecossistema do Microsoft 365. Cada aplicativo dá suporte a apenas uma extensão.

Nome	Tipo	Tamanho máximo	Descrição
`requirements`	Objeto		Especifica o conjunto de requisitos de cliente ou host para a extensão.
`runtimes`	Matriz		Configura o conjunto de runtimes e ações que podem ser usadas por cada ponto de extensão. Para obter mais informações, confira runtimes em Suplementos do Office.
`ribbons`	Matriz		Define o ponto de extensão faixas de opções.
`autoRunEvents`	Matriz		Define o ponto de extensão de ativação baseado em evento.
`alternates`	Matriz		Especifica a relação com soluções alternativas existentes do Microsoft 365. Ele é usado para ocultar ou priorizar suplementos do mesmo editor com funcionalidade sobreposta.
`audienceClaimUrl`	Cadeia de caracteres	2048 caracteres	Especifica a URL da sua extensão e é usada para validar tokens de identidade de usuário do Exchange. Para obter mais informações, confira dentro do token de identidade do Exchange

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

extensions.requirements

O extensions.requirements objeto especifica os escopos, os fatores de formulário e os conjuntos de requisitos da Biblioteca JavaScript do Office que devem ter suporte no cliente do Office para que o suplemento seja instalado. Também há suporte para requisitos nas propriedades filho "ribbon", "runtime", "alternates" e "autoRunEvents" para filtrar seletivamente alguns recursos do suplemento. Para obter mais informações, confira Especificar requisitos de suplemento do Office no manifesto unificado do Microsoft 365.

Nome	Tipo	Tamanho máximo	Obrigatório	Descrição
`requirements.capabilities`	Matriz			Identifica os conjuntos de requisitos. Opções: `name` (obrigatório), `minVersion`, `maxVersion`
`requirements.capabilities.name`	Cadeia de caracteres		✔️	Identifica o nome do conjunto de requisitos.
`requirements.capabilities.minVersion`	Cadeia de caracteres			Identifica a versão mínima para o conjunto de requisitos.
`requirements.capabilities.maxVersion`	Cadeia de caracteres			Identifica a versão máxima do conjunto de requisitos.
`requirements.scopes`	Matriz de enumerações	1		Identifica os escopos nos quais o suplemento pode ser executado e define os aplicativos do Microsoft 365 nos quais a extensão pode ser executada. Por exemplo, `mail` (Outlook). Valor com suporte: `mail`
`requirements.formFactors`	Matriz de enumerações			Identifica os fatores de formulário que dão suporte ao suplemento. Valores com suporte: `mobile`, `desktop`

extensions.runtimes

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

Nome	Tipo	Tamanho máximo	Obrigatório	Descrição
`id`	String	64 caracteres	✔️	Especifica a ID para runtime.
`type`	Enumeração de cadeia de caracteres		✔️	Especifica o tipo de runtime. O valor de enumeração com suporte para runtime baseado no navegador é `general`.
`code`	Objeto		✔️	Especifica o local do código para o runtime. Com base em `runtime.type`, os suplementos podem usar um arquivo JavaScript ou uma página HTML com uma marca inserida `script` que especifica a URL de um arquivo JavaScript. Ambas as URLs são necessárias em situações em que o `runtime.type` é incerto.
`code.page`	URL		✔️	Especifica a URL da página da Web que contém uma marca inserida `script` , que especifica a URL de um arquivo JavaScript (a ser carregado em um runtime baseado no navegador).
`code.script`	URL			Especifica a URL do arquivo JavaScript a ser carregado no runtime somente JavaScript.
`lifetime`	Enumeração de cadeia de caracteres			Especifica o tempo de vida do runtime. Runtimes com uma `short` vida útil não preservam o estado em execuções enquanto runtimes com uma `long` vida útil fazem. Para obter mais informações, consulte Runtimes em Suplementos do Office.
`actions`	Matriz			Especifica o conjunto de ações com suporte pelo runtime. Uma ação está executando uma função JavaScript ou abrindo uma exibição, como um painel de tarefas.
`actions.id`	String	64 caracteres	✔️	Especifica a ID da ação, que é passada para o arquivo de código.
`actions.type`	Cadeia de caracteres		✔️	Especifica o tipo de ação. O `executeFunction` tipo executa uma função JavaScript sem esperar que ela seja concluída e o `openPage` tipo abre uma página em uma determinada exibição.
`actions.displayName`	String	64 caracteres		Especifica o nome de exibição da ação e não é o rótulo de um botão ou um item de menu que invoca a ação (que está configurada com `tabs.groups.controls.label`).
`actions.pinnable`	Booliano			Especifica se um painel de tarefas tem suporte para fixação, que mantém o painel de tarefas aberto quando o usuário altera a seleção. Valor padrão: `false`
`actions.view`	String	64 caracteres		Especifica a exibição em que a página deve ser aberta. Ele é usado somente quando `actions.type` é `openPage`.
`actions.multiselect`	Booliano			Especifica se o usuário final pode selecionar vários itens, como várias mensagens de email, e aplicar a ação a todos eles.
`actions.supportsNoItemContext`	Booliano			Permite que os suplementos do painel de tarefas ativem sem o Painel de Leitura habilitado ou uma mensagem selecionada.
`requirements`	Objeto			Especifica os escopos, os formFactors e os conjuntos de requisitos da Biblioteca JavaScript do Office que devem ter suporte no cliente do Office para que o runtime seja incluído no suplemento. Para obter mais informações, confira Especificar requisitos de suplemento do Office no manifesto unificado do Microsoft 365.
`requirements.capabilities`	Matriz			Identifica os conjuntos de requisitos. Opções: `name` (obrigatório), `minVersion`, `maxVersion`
`requirements.capabilities.name`	Cadeia de caracteres		✔️	Identifica o nome do conjunto de requisitos.
`requirements.capabilities.minVersion`	Cadeia de caracteres			Identifica a versão mínima para o conjunto de requisitos.
`requirements.capabilities.maxVersion`	Cadeia de caracteres			Identifica a versão máxima do conjunto de requisitos.
`requirements.scopes`	Matriz de enumerações	1		Identifica os escopos nos quais o suplemento pode ser executado e define os aplicativos do Microsoft 365 nos quais a extensão pode ser executada. Por exemplo, `mail` (Outlook). Valor com suporte: `mail`
`requirements.formFactors`	Matriz de enumerações			Identifica os fatores de formulário que dão suporte ao suplemento. Valores com suporte: `mobile`, `desktop`

Para usar extensions.runtimes, confira criar comandos de suplemento, configure o runtime para um painel de tarefas e configure o runtime para o comando de função.

extensions.ribbons

A extensions.ribbons propriedade fornece a capacidade de adicionar comandos de suplemento (botões e itens de menu) à faixa de opções do aplicativo Microsoft 365. A definição da faixa de opções é selecionada na matriz com base nos requisitos e no primeiro pedido.

Nome	Tipo	Tamanho máximo	Obrigatório	Descrição
`contexts`	Matriz	7		Especifica a janela do aplicativo Microsoft 365 na qual a personalização da faixa de opções está disponível para o usuário. Cada item na matriz é um membro de uma matriz de cadeia de caracteres. Valores com suporte: `mailRead`, , `mailCompose`, `meetingDetailsOrganizer`, `meetingDetailsAttendee`, `onlineMeetingDetailsOrganizer`, , `logEventMeetingDetailsAttendeedefault`
`requirements`	Objeto			Especifica os escopos, formFactors e conjuntos de requisitos da Biblioteca JavaScript do Office que devem ter suporte no cliente do Office para que a personalização da faixa de opções seja exibida. Para obter mais informações, confira Especificar requisitos de suplemento do Office no manifesto unificado do Microsoft 365.
`requirements.capabilities`	Matriz			Identifica os conjuntos de requisitos. Opções: `name` (obrigatório), `minVersion`, `maxVersion`
`requirements.capabilities.name`	Cadeia de caracteres		✔️	Identifica o nome do conjunto de requisitos.
`requirements.capabilities.minVersion`	Cadeia de caracteres			Identifica a versão mínima para o conjunto de requisitos.
`requirements.capabilities.maxVersion`	Cadeia de caracteres			Identifica a versão máxima do conjunto de requisitos.
`requirements.scopes`	Matriz de enumerações	1		Identifica os escopos nos quais o suplemento pode ser executado e define os aplicativos do Microsoft 365 nos quais a extensão pode ser executada. Por exemplo, `mail` (Outlook). Valor com suporte: `mail`
`requirements.formFactors`	Matriz de enumerações			Identifica os fatores de formulário que dão suporte ao suplemento. Valores com suporte: `mobile`, `desktop`
`tabs`	Matriz		✔️	Configura as guias personalizadas na faixa de opções de aplicativo do Microsoft 365.
`tabs.id`	String	64 caracteres		Especifica a ID da guia dentro do aplicativo.
`tabs.builtinTabId`	String	64 caracteres		Especifica a ID de uma guia de faixa de opções interna do Office. Os valores possíveis variam de acordo com o aplicativo host do Office. Atualmente, há suporte apenas para suplementos do Outlook e o único valor permitido para o Outlook é "TabDefault". A guia padrão depende de onde o suplemento do Outlook é apresentado, conforme determinado na propriedade "extensions.ribbons.contexts". Na janela main Outlook, ela é a guia Página Inicial, em uma janela de mensagem, é a guia Mensagem e, em uma janela de reunião, é a guia Reunião.
`tabs.label`	String	64 caracteres		Especifica o texto exibido para a guia.
`tabs.position`	Objeto			Configura a posição da guia personalizada em relação a outras guias na faixa de opções.
`tabs.position.builtinTabId`	String	64 caracteres	✔️	Especifica a ID da guia interna à qual a guia personalizada deve ser posicionada ao lado. Para obter mais informações, consulte localizar as IDs de controles e grupos de controle.
`tabs.position.align`	Enumeração de cadeia de caracteres		✔️	Define o alinhamento da guia personalizada em relação à guia interna especificada. Valores com suporte: `after`, `before`
`tabs.groups`	Matriz			Define grupos de controles em uma guia de faixa de opções em um dispositivo não móvel. Para dispositivos móveis, confira `tabs.customMobileRibbonGroups` abaixo.
`tabs.groups.id`	String	64 caracteres		Especifica a ID do grupo de guias no aplicativo. Ele deve ser diferente de qualquer ID de grupo interna no aplicativo Microsoft 365 e em qualquer outro grupo personalizado.
`tabs.groups.label`	String	64 caracteres		Especifica o texto exibido para o grupo.
`tabs.groups.icons`	Matriz			Especifica os ícones exibidos para o grupo.
`tabs.groups.icons.size`	Número		✔️	Especifica o tamanho do ícone em pixels, enumerado como `16`,`20`,,`24`,`32`,`4048`,,`64`,`80`. Tamanhos de imagem necessários: `16`, `32`, `80`.
`tabs.groups.icons.url`	URL		✔️	Especifica a URL absoluta do ícone.
`tabs.groups.controls`	Matriz			Configura os botões e menus no grupo.
`tabs.groups.controls.id`	String	64 caracteres	✔️	Especifica a ID do controle dentro do aplicativo. Ele deve ser diferente de qualquer ID de controle interna no aplicativo Microsoft 365 e qualquer outro controle personalizado.
`tabs.groups.controls.items`	Matriz			Configura os itens para um controle de menu.
`tabs.groups.controls.items.id`	Cadeia de caracteres		✔️	Especifica a ID dos itens dentro do aplicativo.
`tabs.groups.controls.items.type`	Enumeração de cadeia de caracteres		✔️	Define o tipo de itens de controle. Valores com suporte: `menu`, `button`
`tabs.groups.controls.items.label`	String	64 caracteres	✔️	Especifica o texto exibido para os itens.
`tabs.groups.controls.items.icons`	Matriz			Configura os ícones para o item personalizado.
`tabs.groups.controls.items.icons.size`	Número		✔️	Especifica o tamanho do ícone em pixels, enumerado como `16`,`20`,,`24`,`32`,`4048`,,`64`,`80`. Tamanhos de imagem necessários: `16`, `32`, `80`.
`tabs.groups.controls.items.icons.url`	URL		✔️	Especifica a URL absoluta do ícone.
`tabs.groups.controls.items.supertip`			✔️	Configura uma super dica para o item personalizado. Uma super dica é um recurso de interface do usuário que exibe uma breve caixa de informações de ajuda sobre um controle quando o cursor passa sobre ele. A caixa pode conter várias linhas de texto.
`tabs.groups.controls.items.supertip.title`	String	64 caracteres	✔️	Especifica o texto do título da supertipa.
`tabs.groups.controls.items.supertip.description`	Cadeia de caracteres	128 caracteres	✔️	Especifica a descrição da supertipa.
`tabs.groups.controls.items.actionId`	String	64 caracteres	✔️	Especifica a ID da ação que é tomada quando um usuário seleciona o item de controle ou menu. O `actionId` deve corresponder com `runtime.actions.id`.
`tabs.groups.controls.items.enabled`	Booliano			Indica se o controle está inicialmente habilitado. Valor padrão: `true`
`tabs.groups.controls.items.overriddenByRibbonApi`	Booliano			Especifica se um grupo, botão, menu ou item de menu oculto em combinações de aplicativo e plataforma, que dão suporte à API (Office.ribbon.requestCreateControls) que instala guias contextuais personalizadas na faixa de opções. Valor padrão: `false`
`tabs.groups.controls.type`	Cadeia de caracteres		✔️	Define o tipo de controle. Valores com suporte: `button`, `menu`
`tabs.groups.controls.builtinControlId`	String	64 caracteres	✔️	Especifica a ID de um controle existente do Microsoft 365. Para obter mais informações, consulte localizar as IDs de controles e grupos de controle.
`tabs.groups.controls.label`	String	64 caracteres	✔️	Especifica o texto exibido para o controle.
`tabs.groups.controls.icons`	Matriz		✔️	Define os ícones para o controle. Deve haver pelo menos três objetos filho; um com `size` propriedades de `16`, `32`e `80` pixels.
`tabs.groups.controls.icons.size`	Número		✔️	Especifica o tamanho do ícone em pixels, enumerado como `16`,`20`,,`24`,`32`,`4048`,,`64`,`80`. Tamanho da imagem necessário: `16`, , `3280`
`tabs.groups.controls.icons.url`	URL			Especifica a URL absoluta para o ícone.
`tabs.groups.controls.supertip`	Objeto		✔️	Configura uma super dica para o controle.
`tabs.groups.controls.supertip.title`	String	64 caracteres	✔️	Especifica o texto do título da supertipa.
`tabs.groups.controls.supertip.description`	Cadeia de caracteres	128 caracteres	✔️	Especifica a descrição da supertipa.
`tabs.groups.controls.actionId`	String	64 caracteres		Necessário se o tipo de controle for `button`. Não use se o tipo de controle for `menu`. Especifica a ID da ação que é tomada quando um usuário seleciona o controle. O `actionId` deve corresponder à `runtime.actions.id` propriedade de uma ação no `runtimes` objeto.
`tabs.groups.controls.enabled`	Booliano			Indica se o controle está inicialmente habilitado. Valor padrão: `true`
`tabs.groups.controls.overriddenByRibbonApi`	Booliano			Especifica se um grupo, botão, menu ou item de menu está oculto em combinações de aplicativo e plataforma que dão suporte à API (Office.ribbon.requestCreateControls) que instala guias contextuais personalizadas na faixa de opções. Valor padrão: `false`
`tabs.groups.builtinGroupId`	String	64 caracteres		Especifica a ID de um grupo interno. Para obter mais informações, consulte localizar as IDs de controles e grupos de controle.
`tabs.customMobileRibbonGroups`	Matriz	10		Define grupos de controles na guia padrão da faixa de opções em um dispositivo móvel. Essa propriedade de matriz só pode estar presente em objetos de guia que têm uma `tabs.builtinTabId` propriedade definida como "DefaultTab". Para dispositivos não móveis, confira `tabs.groups` acima.
`tabs.customMobileRibbonGroups.id`	Cadeia de caracteres	250 caracteres	✔️	Especifica a ID do grupo. Ele deve ser diferente de qualquer ID de grupo interna no aplicativo Microsoft 365 e em qualquer outro grupo personalizado.
`tabs.customMobileRibbonGroups.label`	Cadeia de caracteres	32 caracteres	✔️	Especifica o rótulo no grupo.
`tabs.customMobileRibbonGroups.controls`	Matriz	20	✔️	Define os controles no grupo. Há suporte apenas para botões móveis.
`tabs.customMobileRibbonGroups.controls.id`	Cadeia de caracteres	250 caracteres	✔️	Especifica a ID do controle, como "msgReadFunctionButton".
`tabs.customMobileRibbonGroups.controls.type`	Enumeração de cadeia de caracteres		✔️	Especifica o tipo de controle. Atualmente, há suporte apenas para "MobileButton".
`tabs.customMobileRibbonGroups.controls.label`	Cadeia de caracteres	32 caracteres	✔️	Especifica o rótulo no controle.
`tabs.customMobileRibbonGroups.controls.actionId`	String	64 caracteres	✔️	Especifica a ID da ação que é tomada quando um usuário seleciona o controle. O `actionId` deve corresponder à `runtime.actions.id` propriedade de uma ação no `runtimes` objeto.
`tabs.customMobileRibbonGroups.controls.icons`	Matriz	9	✔️	Especifica os ícones que serão exibidos no controle dependendo das dimensões e da DPI da tela do dispositivo móvel. Deve haver exatamente 9 ícones.
`tabs.customMobileRibbonGroups.controls.icons.size`	Número enumeração		✔️	Tamanho em pixels do ícone. Os tamanhos possíveis são 25, 32 e 48. Deve haver exatamente um de cada tamanho para cada valor possível da propriedade dos `scale` ícones.
`tabs.customMobileRibbonGroups.controls.icons.url`	Cadeia de caracteres	2048 caracteres	✔️	A URL completa e absoluta do arquivo de imagem do ícone.
`tabs.customMobileRibbonGroups.controls.icons.scale`	Número enumeração		✔️	Especifica a propriedade UIScreen.scale para dispositivos iOS. Os valores possíveis são 1, 2 e 3. Deve haver exatamente um de cada valor para cada valor possível da propriedade dos `size` ícones.

Para usar extensions.ribbons, consulte criar comandos de suplemento, configure a interface do usuário para o comando do painel de tarefas e configure a interface do usuário para o comando de função.

extensions.autoRunEvents

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

Nome	Tipo	Tamanho máximo	Obrigatório	Descrição
`events`	Matriz	20	✔️	Configura o evento que faz com que as ações em um Suplemento do Outlook sejam executadas automaticamente. Por exemplo, confira usar alertas inteligentes e os `OnMessageSend` eventos e `OnAppointmentSend` em seus Suplementos do Outlook.
`events.type`	String	64 caracteres		Especifica o tipo de evento. Para tipos com suporte, consulte eventos com suporte.
`events.actionId`	String	64 caracteres		Identifica a ação que é tomada quando o evento é acionado. O `actionId` deve corresponder com `runtime.actions.id`.
`events.options`	Objeto			Configura como o Outlook responde ao evento.
`events.options.sendMode`	Cadeia de caracteres		✔️	Especifica as ações a serem executadas durante uma ação de envio de email. Valores com suporte: `promptUser`, , `softBlock`. `block` Para obter mais informações, consulte opções de modo de envio disponíveis.
`requirements`	Objeto			Especifica os escopos, formFactors e conjuntos de requisitos da Biblioteca JavaScript do Office que devem ter suporte no cliente do Office para que o código de tratamento de eventos seja executado. Para obter mais informações, confira Especificar requisitos de suplemento do Office no manifesto unificado do Microsoft 365.
`requirements.capabilities`	Matriz			Identifica os conjuntos de requisitos. Opções: `name` (obrigatório), `minVersion`, `maxVersion`
`requirements.capabilities.name`	Cadeia de caracteres		✔️	Identifica o nome do conjunto de requisitos.
`requirements.capabilities.minVersion`	Cadeia de caracteres			Identifica a versão mínima para o conjunto de requisitos.
`requirements.capabilities.maxVersion`	Cadeia de caracteres			Identifica a versão máxima do conjunto de requisitos.
`requirements.scopes`	Matriz de enumerações	1		Identifica os escopos nos quais o suplemento pode ser executado e define os aplicativos do Microsoft 365 nos quais a extensão pode ser executada. Por exemplo, `mail` (Outlook). Valor com suporte: `mail`
`requirements.formFactors`	Matriz de enumerações			Identifica os fatores de formulário que dão suporte ao suplemento. Valores com suporte: `mobile`, `desktop`

extensions.alternates

A extensions.alternates propriedade é usada para ocultar ou priorizar suplementos específicos no mercado quando você publicou vários suplementos com funcionalidade sobreposta.

Nome	Tipo	Tamanho máximo	Obrigatório	Descrição
`prefer`	Objeto			Especifica a compatibilidade retrógrada com um suplemento COM equivalente, suplemento XLL ou ambos.
`prefer.comAddin`	Objeto			Especifica um suplemento COM que deve ser usado no lugar do Suplemento Web do Microsoft 365 para Windows.
`prefer.comAddin.progId`	String	64 caracteres	✔️	Identifica o tipo de aplicativo no qual a extensão pode ser executada.
`hide`	Objeto			Configura como ocultar outro suplemento que você publicou sempre que o suplemento estiver instalado, para que os usuários não vejam ambos na interface do usuário do Microsoft 365. Por exemplo, use essa propriedade quando você tiver publicado anteriormente um suplemento que usa o manifesto antigo do aplicativo XML e você a substituirá por uma versão que usa o novo manifesto do aplicativo JSON.
`hide.storeOfficeAddin`	Objeto			Especifica um Suplemento do Microsoft 365 disponível no Microsoft AppSource.
`hide.storeOfficeAddin.officeAddinId`	String	64 caracteres	✔️	Especifica a ID do suplemento no mercado a ser ocultado. O GUID será retirado da propriedade manifesto `id` do aplicativo se o suplemento no mercado usar o manifesto do aplicativo JSON. O GUID será retirado do `<Id>` elemento se o suplemento no mercado usar o manifesto do aplicativo XML.
`hide.storeOfficeAddin.assetId`	String	64 caracteres	✔️	Especifica a ID do ativo AppSource do suplemento no mercado a ser ocultado.
`hide.customOfficeAddin`	Objeto			Configura como ocultar um suplemento no mercado que não é distribuído por meio do AppSource.
`hide.customOfficeAddin.officeAddinId`	String	64 caracteres	✔️	Especifica a ID do suplemento no mercado a ser ocultado. O GUID será retirado da propriedade manifesto `id` do aplicativo se o suplemento no mercado usar o manifesto do aplicativo JSON. O GUID será retirado do `<Id>` elemento se o suplemento no mercado usar o manifesto do aplicativo XML.
`requirements`	Objeto			Especifica os escopos, formFactors e conjuntos de requisitos da Biblioteca JavaScript do Office que devem ter suporte no cliente do Office para que as propriedades "ocultar", "preferir" ou "alternateIcons" entrem em vigor. Para obter mais informações, confira Especificar requisitos de suplemento do Office no manifesto unificado do Microsoft 365.
`requirements.capabilities`	Matriz			Identifica os conjuntos de requisitos. Opções: `name` (obrigatório), `minVersion`, `maxVersion`
`requirements.capabilities.name`	Cadeia de caracteres		✔️	Identifica o nome do conjunto de requisitos.
`requirements.capabilities.minVersion`	Cadeia de caracteres			Identifica a versão mínima para o conjunto de requisitos.
`requirements.capabilities.maxVersion`	Cadeia de caracteres			Identifica a versão máxima do conjunto de requisitos.
`requirements.scopes`	Matriz de enumerações	1		Identifica os escopos nos quais o suplemento pode ser executado e define os aplicativos do Microsoft 365 nos quais a extensão pode ser executada. Por exemplo, `mail` (Outlook). Valor com suporte: `mail`
`requirements.formFactors`	Matriz de enumerações			Identifica os fatores de formulário que dão suporte ao suplemento. Valores com suporte: `mobile`, `desktop`
`alternateIcons`	Objeto			Especifica os ícones main que são usados para representar o suplemento em versões mais antigas do Office. Essa propriedade será necessária para que o suplemento do Office seja instalado no Office no Mac, licenças perpétuas do Office e versões de assinatura do Microsoft 365 do Office no Windows anteriores a 2304 (Build 16320.00000).
`alternateIcons.icon`	Objeto		✔️	Especifica as propriedades do arquivo de imagem usado para representar o suplemento.
`alternateIcons.icon.size`	Número enumeração		✔️	Essa propriedade é reservada para uso futuro. O valor deve ser 64.
`alternateIcons.icon.url`	Cadeia de caracteres	2048 caracteres	✔️	Especifica a URL completa e absoluta do arquivo de imagem que é usado para representar o suplemento. A imagem do ícone deve ter 64 x 64 pixels e usar um dos seguintes formatos de arquivo: GIF, JPG, PNG, EXIF, BMP, TIFF.
`alternateIcons.highResolutionIcon`	Objeto		✔️	Especifica as propriedades do arquivo de imagem usado para representar o suplemento em telas DPI altas.
`alternateIcons.highResolutionIcon.size`	Número enumeração		✔️	Essa propriedade é reservada para uso futuro. O valor deve ser 64 (não 128).
`alternateIcons.highResolutionIcon.url`	Cadeia de caracteres	2048 caracteres	✔️	Especifica a URL completa e absoluta do arquivo de imagem que é usado para representar o suplemento em telas DPI altas. A imagem do ícone deve ter 128 x 128 pixels e usar um dos seguintes formatos de arquivo: GIF, JPG, PNG, EXIF, BMP, TIFF.

actions

Observação

As ações do Microsoft 365 estão disponíveis na versão prévia do desenvolvedor público.
Há suporte para ações para o aplicativo Microsoft 365 (Office) para Web e área de trabalho.

O objeto é uma matriz de objetos de ação. Esse bloco é necessário apenas para soluções que fornecem Ações.

Nome	Tipo	Tamanho máximo	Obrigatório	Descrição
`id`	String	64 caracteres	✔️	Uma cadeia de caracteres de identificador na localidade padrão usada para catalogar ações. Deve ser exclusivo em todas as ações deste aplicativo. Por exemplo, `openDocInContoso`.
`displayName`	Cadeia de caracteres	64 caracteres	✔️	Um nome de exibição para a ação. Capitalize a primeira letra e o nome da marca. Por exemplo, Adicionar a fornecedores, Abrir em Contoso e Solicitar assinaturas.
`description`	Cadeia de caracteres		✔️	Especifica a descrição das ações.
`intent`	Enumeração de cadeia de caracteres		✔️	Especifica o tipo de intenção. Os valores de enumeração com suporte são `open`, `addTo`e `custom`.
`handlers`	Matriz de objetos		✔️	Uma matriz de objetos manipuladores define como as Ações são gerenciadas. Na versão prévia pública atual, adicione um único manipulador para cada ação.

actions.handlers

Define os manipuladores da Ação. Os manipuladores são uma matriz de objetos manipuladores. Cada Ação deve ter pelo menos um manipulador.

Nome	Tipo	Obrigatório	Descrição
`supportedObjects`	Objeto		Objetos que definem quais objetos podem disparar essa Ação.
`type`	Enumeração de cadeia de caracteres	✔️	Especifica o tipo de manipulador de Ações. O valor de enumeração com suporte é `openPage`.
`pageInfo`	Objeto		Necessário se o tipo de manipulador for `openPage`. Objeto que contém metadados da página a ser aberta.

actions.handlers.supportedObjects

Os tipos de objeto com suporte que podem disparar essa Ação.

Nome	Tipo	Tamanho máximo	Obrigatório	Descrição
`file`	Objeto			Tipos de arquivo com suporte.
`file.extensions`	Matriz de cadeias de caracteres			Matriz de cadeias de caracteres. Extensões de arquivo do tipo de arquivo que a Ação pode disparar. Por exemplo, pdf e docx.

actions.handlers.pageInfo

Necessário se o tipo de manipulador for openPage. Objeto que contém metadados da página a ser aberta.

Nome	Tipo	Tamanho máximo	Obrigatório	Descrição
`PageId`	Cadeia de caracteres			Mapeia para a `EntityId` guia estática.
`SubPageId`	Cadeia de caracteres			Mapeia para a `SubEntityId` guia estática.

dashboardCards

Opcional – Matriz

Define uma lista de cartões que podem ser fixados em um dashboard, como Microsoft Viva Connections, para fornecer uma exibição resumida das informações do aplicativo. Para obter mais informações sobre como criar cartões para Viva Connections Dashboard, confira visão geral das extensões de cartão adaptável do Bot Powered.

A dashboardCards propriedade é uma matriz de elementos do tipo object.

dashboardCards.dashboardCard

Define um único dashboard cartão e suas propriedades.

Nome	Tipo	Tamanho máximo	Obrigatório	Descrição
`id`	Cadeia de caracteres		✔️	Um identificador exclusivo para este dashboard cartão. A ID deve ser um GUID.
`displayName`	Cadeia de caracteres	255 caracteres	✔️	Nome de exibição do cartão.
`description`	Cadeia de caracteres	255 caracteres	✔️	Descrição do cartão.
`pickerGroupId`	Cadeia de caracteres		✔️	ID do grupo no seletor de cartão. A ID deve ser um GUID.
`icon`	Objeto			Especifica o ícone do cartão.
`contentSource`	Objeto		✔️	Especifica a origem do conteúdo do cartão
`defaultSize`	Cadeia de caracteres		✔️	Tamanho de renderização do dashboard cartão. Opções: `medium` ou `large`.

dashboardCards.dashboardCard.icon

Define as propriedades de ícone de um determinado dashboard cartão.

Nome	Tipo	Tamanho máximo	Obrigatório	Descrição
`iconUrl`	Cadeia de caracteres	2048 caracteres		Local do ícone do cartão, a ser exibido na caixa de ferramentas e na barra de cartão.
`officeUIFabricIconName`	Cadeia de caracteres	255 caracteres		Nome amigável do ícone de interface do usuário fluente ou UI Fabric do Office para o cartão. Esse valor será usado se iconUrl não for especificado.

dashboardCards.dashboardCard.contentSource

Define a fonte de conteúdo de um determinado dashboard cartão.

Nome	Tipo	Tamanho máximo	Obrigatório	Descrição
`sourceType`	Cadeia de caracteres			Representa a origem do conteúdo de um cartão. Opções: `bot`.
`botConfiguration`	Objeto			A configuração da origem do bot. Necessário se o `sourceType` estiver definido como `bot`.

dashboardCards.dashboardCard.contentSource.botConfiguration

Nome	Tipo	Tamanho máximo	Obrigatório	Descrição
`botId`	Cadeia de caracteres			O ID exclusivo do aplicativo Microsoft para o bot conforme registrado na estrutura do bot. A ID deve ser um GUID.

Esquema de manifesto de aplicativo de visualização do desenvolvedor público

Manifesto de aplicativo de exemplo

$esquema

manifestVersion

versão

id

developer

localizationInfo

localizationInfo.additionalLanguages

nome

description

ícones

accentColor

configurbleTabs

staticTabs

bots

bots.configuration

bots.commandLists

conectores

composeExtensions

composeExtensions.commands

scopeConstraints

permissões

devicePermissions

validDomains

webApplicationInfo

graphConnector

showLoadingIndicator

isFullScreen

activities

activities.activityTypes

configurableProperties

supportedChannelTypes

defaultBlockUntilAdminAction

publisherDocsUrl

defaultInstallScope

defaultGroupCapability

subscriptionOffer

meetingExtensionDefinition

meetingExtensionDefinition.scenes

meetingExtensionDefinition.videoFilters

autorização

authorization.permissions

authorization.permissions.resourceSpecific

Permissões de aplicativo RSC

Permissões delegadas do RSC

extensions

extensions.requirements

extensions.runtimes

extensions.ribbons

extensions.autoRunEvents

extensions.alternates

actions

actions.handlers

actions.handlers.supportedObjects

actions.handlers.pageInfo

dashboardCards

dashboardCards.dashboardCard

dashboardCards.dashboardCard.icon

dashboardCards.dashboardCard.contentSource

dashboardCards.dashboardCard.contentSource.botConfiguration

Confira também

Comentários

Recursos adicionais