Perguntas frequentes

Esta seção contém as perguntas frequentes e as respostas.

Pré-visualizador de Cartão Adaptável

Por que precisamos usar uma nova extensão no Visual Studio Code? Essa extensão não pode ser integrada ao Microsoft 365 Agents Toolkit (anteriormente conhecido como Teams Toolkit) para Visual Studio Code?

O Visualizador de Cartão Adaptável é uma extensão autônoma porque usa um pacote de código fechado para renderizar os Cartões Adaptáveis para garantir uma lógica de renderização consistente com a plataforma do Teams. O Agents Toolkit é um projeto de código aberto e não inclui dependências de pacotes que desenvolvedores terceirizados não possam acessar.
 

Essa extensão dá suporte a todos os recursos do Cartão Adaptável na plataforma Teams?

Não. Há várias limitações às quais a extensão do Pré-visualizador de Cartão Adaptável não dá suporte.
 

O Visual Studio será integrado ao Pré-visualizador de Cartão Adaptável?

Não, o Visualizador de Cartão Adaptável está disponível apenas no Visual Studio Code.
 

Bots

Como posso usar Cartões Adaptáveis com um bot para que o comportamento do aplicativo da área de trabalho seja consistente entre aplicativos Web e aplicativos móveis?

Para obter mais informações sobre como usar Cartões Adaptáveis com um bot, consulte Trabalhar com Ações Universais para Cartões Adaptáveis.
 

Como posso remover mensagens específicas do histórico de bots? Há uma maneira de obter o histórico do chat e encontrar uma ID de atividade de uma mensagem específica?

Use o método da DeleteActivity estrutura Excluir mensagens-Bot: Atualize e exclua mensagens enviadas do bot.
 

Como posso testar a validade do esquema do card por meio do código?

Você pode testar ou validar o esquema do Cartão Adaptável usando a opção editor de Cartões Adaptáveis (Versão prévia) nas Ferramentas do portal > do desenvolvedor.

Por que não consigo criar um bot no Portal do Desenvolvedor?

O registro de aplicativo está desabilitado para o usuário ou o usuário não tem permissões suficientes para criar um aplicativo. Para obter mais informações, consulte limitações e problemas conhecidos.

Como posso resolver o erro "Microsoft.Graph.Communications.Core.Exceptions.ServiceException: 'Code: 9999 Message: Unknown internal server error'"?
  • Verifique se o aplicativo tem as permissões e Calls.InitiateGroupCall.All o consentimento do Calls.JoinGroupCall.All administrador.
  • Entre no seu aplicativo para capturar mais informações sobre o erro.
  • Certifique-se de que as joinParams informações passadas para o AddAsync método estejam corretas e contenham as informações necessárias.
  • Verifique se os valores para JoinUrl, MeetingIde outros parâmetros estão corretos.
  • Verifique se o scenarioId é exclusivo para cada chamada. A reutilização de IDs de cenário às vezes pode causar problemas.
Depois de registrar meu bot no portal do Azure, recebo o erro Você não tem permissão para usar este aplicativo aqui ao abri-lo no Teams. Como posso resolver isso?

Para usar seu aplicativo no Teams, você deve carregá-lo no Teams. Para obter mais informações, consulte Carregar seu aplicativo no Teams.

Como um bot usa emojis personalizados em uma mensagem no Teams?

Os bots devem enviar emojis como texto UTF-16. Não há suporte para HTML, imagens de URI de dados e esquemas de emoji do Skype no Teams.
 

Live Share

Posso usar meu próprio serviço de Retransmissão de Fluido do Azure?

Sim! Ao inicializar o Live Share, você pode definir seu próprio AzureConnectionConfigarquivo . O Live Share associa contêineres criados a reuniões, mas você precisa implementar a ITokenProvider interface para assinar tokens para seus contêineres. Por exemplo, você pode usar um fornecidoAzureFunctionTokenProvider, que usa uma função de nuvem do Azure para solicitar um token de acesso de um servidor.

Embora a maioria de vocês ache benéfico usar nosso serviço hospedado gratuito, ainda pode haver momentos em que seja benéfico usar seu próprio serviço Azure Fluid Relay para seu aplicativo Live Share. Considere usar uma conexão de serviço AFR personalizada se você:

  • Exigir o armazenamento de dados em contêineres do Fluid além do tempo de vida de uma reunião.
  • Transmita dados confidenciais por meio do serviço que requer uma política de segurança personalizada.
  • Desenvolva recursos por meio do Fluid Framework, por exemplo, SharedMappara seu aplicativo fora do Teams.

Para obter mais informações, confira como orientar ou visite a documentação do Azure Fluid Relay.
 

Por quanto tempo os dados armazenados no serviço hospedado do Live Share ficam acessíveis?

Todos os dados enviados ou armazenados por meio de contêineres do Fluid criados pelo serviço Azure Fluid Relay hospedado pelo Live Share ficam acessíveis por 24 horas. Se você quiser manter os dados por mais de 24 horas, pode substituir nosso serviço do Azure Fluid Relay hospedado pelo seu. Como alternativa, você pode usar seu próprio provedor de armazenamento em paralelo ao serviço hospedado do Live Share.
 

Quais tipos de reunião são compatíveis com o Live Share?

O Live Share é compatível com reuniões agendadas, chamadas individuais, chamadas em grupo e reunir agora. Ainda não há suporte para reuniões de canal.
 

O pacote de mídia do Live Share funcionará com conteúdo DRM?

O pacote de mídia do Live Share não funciona com conteúdo DRM. O Teams não dá suporte a mídia criptografada para aplicativos de guia na área de trabalho. Chrome, Edge e clientes móveis são suportados.

Para obter mais informações, você pode acompanhar o problema aqui.
 

Quantas pessoas podem participar de uma sessão do Live Share?

O Live Share dá suporte a no máximo 100 participantes por sessão. Se for algo em que você está interessado, você pode iniciar uma discussão aqui.
 

Posso usar estruturas de dados do Live Share fora do Teams?

Os pacotes Live Share exigem o SDK do cliente do Teams para funcionar corretamente. Recursos ou @microsoft/live-share@microsoft/live-share-media não funcionam fora do Microsoft Teams. Se isso é algo em que você está interessado, você pode iniciar uma discussão aqui.
 

Posso usar vários recipientes de Fluid?

O Live Share dá suporte apenas a um contêiner usando nosso serviço Azure Fluid Relay fornecido. No entanto, é possível usar um contêiner Live Share e um contêiner criado por sua própria instância do Azure Fluid Relay.
 

Posso alterar meu esquema de contêiner do Fluid depois de criar o contêiner?

O Live Share não dá suporte à adição de novos initialObjects ao Fluido ContainerSchema após criar ou ingressar em um contêiner. Como as sessões do Live Share são de curta duração, isso geralmente é um problema durante o desenvolvimento após a adição de novos recursos ao aplicativo.

Observação

Se você estiver usando a dynamicObjectTypesContainerSchemapropriedade no , poderá adicionar novos tipos a qualquer momento. Se, posteriormente, você remover tipos do esquema, as instâncias DDS existentes desses tipos falharão normalmente.

Para corrigir erros resultantes de alterações initialObjects no teste local em seu navegador, remova a ID de contêiner com hash da URL e recarregue a página. Se você estiver testando em uma reunião do Teams, inicie uma nova reunião e tente novamente.

Se você planeja atualizar seu aplicativo com novas SharedObject instâncias ou LiveObject instâncias com frequência, considere como implantar novas alterações de esquema na produção. Embora o risco real seja relativamente baixo e de curta duração, pode haver sessões ativas no momento em que você implementa a alteração. Os usuários existentes na sessão não devem ser afetados, mas os usuários que ingressarem nessa sessão depois de implantar uma alteração significativa podem ter problemas para se conectar à sessão. Para mitigar isso, você pode considerar algumas das seguintes soluções:

  • Implante alterações de esquema para seu aplicativo Web fora do horário comercial normal.
  • Use dynamicObjectTypes para todas as alterações feitas em seu esquema, em vez de alterar initialObjects.

Observação

O Live Share não dá suporte ao controle de versão do , ContainerSchemanem tem APIs dedicadas a migrações.


 
Há limites para quantos eventos de alteração posso emitir por meio do Live Share?

Enquanto o Live Share estiver em Versão Prévia, qualquer limite para eventos emitidos por meio do Live Share não será imposto. Para obter um desempenho ideal, você deve dejetar as alterações emitidas ou SharedObjectLiveObject instâncias para uma mensagem a cada 50 milissegundos ou mais. Isso é especialmente importante ao enviar alterações com base nas coordenadas do mouse ou do toque, como ao sincronizar posições do cursor, escrever à tinta e arrastar objetos em uma página.
 

O Live Share é compatível com GCC (Nuvem da Comunidade Governamental), GCC High, DoD (Departamento de Defesa) e Teams operados por ambientes 21Vianet?

O Live Share tem suporte apenas no ambiente GCC.


O Live Share dá suporte a usuários externos e convidados?

Sim, o Live Share dá suporte a usuários convidados e externos para a maioria dos tipos de reunião. No entanto, não há suporte para usuários convidados nas reuniões do canal.


O Live Share dá suporte a dispositivos de Salas do Teams?

Não, o Live Share não dá suporte a dispositivos de Salas do Teams.

Os aplicativos Live Share dão suporte a gravações de reunião?

Não, o Live Share não é compatível com gravações de reunião.

Microsoft 365 Copilot

Por que o Microsoft 365 Copilot não está incluindo meu agente em uma resposta?

Verifique se o manifesto do aplicativo (anteriormente chamado de manifesto do aplicativo do Teams) é descritivo. O manifesto do aplicativo ajuda na correspondência do agente em resposta a um prompt do usuário. Além disso, certifique-se de carregar o pacote do aplicativo no Outlook e interagir com o aplicativo, incluindo a autenticação.

Se o problema persistir, use o indicador de polegar para baixo na resposta do Microsoft 365 Copilot e prefixe sua resposta com [MessageExtension].
 

Quais descrições devo incluir no manifesto do aplicativo?

Aqui está um exemplo de descrição que funciona para o NPM Finder.

 "name": { 

        "short": "NPM Finder", 

        "full": "Nuget Package Manager Finder" 

    }, 

    "description": { 

        "short": "Returns information about available NPM packages", 

        "full": "The Nuget Package Manager (NPM) Finder application provides information (such as title and description) about Nuget packages available in the global NPM catalog." 

    }, 

… 

            "commands": [ 

                { 

                    "id": "searchQuery", 

                    "context": [ 

                        "compose", 

                        "commandBox" 

                    ], 

                    "description": "Searches the global NPM catalog for available packages", 

                    "title": "Search", 

                    "type": "query", 

                    "parameters": [ 

                        { 

                            "name": "searchQuery", 

                            "title": "Search Query", 

                            "description": "A package name or description of capability to search", 

                            "inputType": "text" 

                        } 

                    ] 


 
O Microsoft 365 Copilot inclui meu agente na resposta, mas a resposta do Microsoft 365 Copilot não atende às minhas expectativas. O que devo fazer?

Use a opção de voto negativo na resposta do Microsoft 365 Copilot e prefixe sua resposta com [MessageExtension].
 

Posso criar minha própria extensão de mensagens do Teams?

Sim, você pode. Certifique-se de ter um manifesto descritivo do aplicativo e carregue o aplicativo no Outlook e interagiu com ele.

 

Como posso fazer com que minha extensão de mensagem do Teams existente funcione com o Microsoft 365 Copilot?
  1. Registre o canal de bots no Azure Serviço de Bot.
  2. Carregue o aplicativo no Outlook.

 

Quais são as diretrizes para aplicativos do Teams extensíveis como agente para Microsoft 365 Copilot?

Você pode ler as diretrizes de validação da Loja do Teams para aplicativos do Teams extensíveis como agente para o Microsoft 365 Copilot.
 

O que é o processo de certificação?

Depois de publicar o agente, inicie o fluxo de conformidade do aplicativo no Partner Center. Se a verificação do Publicador estiver incompleta, verifique se o fluxo de Conformidade do Aplicativo foi concluído antes da Certificação Microsoft 365. Em seguida, conclua o Atestado do Fornecedor, que reúne dados autoatestados sobre o agente, a empresa e as operações. Para obter mais informações, consulte Programa de Conformidade de Aplicativos Microsoft 365.

Para iniciar o processo de certificação do Microsoft 365, carregue os documentos iniciais que definem o escopo da avaliação do agente e do ambiente operacional. Dependendo do escopo, forneça evidências para controles específicos relacionados à segurança do aplicativo, segurança operacional e manipulação ou privacidade de dados. Se você criar seu agente no Azure, poderá usar a ACAT (Ferramenta de Automação de Conformidade de Aplicativos) para examinar o ambiente e gerar evidências para vários controles, reduzindo a carga de trabalho manual. Para obter mais informações, consulte Ferramenta de Automação de Conformidade de Aplicativos para Microsoft 365.
 

Como os agentes são certificados?

Depois que o aplicativo passar na validação proativa, os desenvolvedores de extensões de mensagem novas e existentes que não forem certificadas serão incentivados a certificar seu agente. Isso é comunicado por meio de um email confirmando que a extensão da mensagem é validada.
 

Como os novos agentes são certificados?

Os desenvolvedores são incentivados a certificar seu novo agente após concluir a validação com êxito.
 


Como posso criar ou atualizar um agente de extensão de mensagem para o Microsoft 365 Copilot?

Você pode criar ou atualizar uma extensão de mensagem como agente no Microsoft 365 Copilot para interagir com ferramentas e serviços de terceiros e obter mais com o Microsoft 365 Copilot. Além disso, suas extensões devem atender aos padrões de conformidade, desempenho, segurança e experiência do usuário descritos nas diretrizes para criar ou atualizar um agente de extensão de mensagem para o Microsoft 365 Copilot.
 

O que acontece com meus plug-ins de extensão de mensagem publicados?

Todos os plug-ins de extensão de mensagem publicados agora aparecerão como agentes no painel direito do Microsoft 365 Copilot. Dependendo do requisito do parceiro para implementar uma API, ele pode aceitar essa atualização ou considerar a criação de um agente de mecanismo personalizado ou um plug-in baseado em API.
 

O que os parceiros podem fazer para construir um agente mais robusto?

Se um parceiro quiser criar um agente mais robusto, ele poderá substituir seu plug-in existente e criar um agente declarativo com instruções personalizadas e ações baseadas em API. Para obter mais informações, consulte estender a extensão de mensagem baseada em bot como agente do Microsoft 365 Copilot.
 

Os agentes declarativos e os agentes de mecanismo personalizado terão a mesma experiência do usuário e recursos?

Sim, os agentes declarativos e os agentes de mecanismo personalizado terão a mesma experiência do usuário de invocação e histórico de sessão, e a ZQL (linguagem de consulta) terá suporte para ambos.
 

Os ISVs (fornecedores independentes de software) podem aprimorar seus agentes declarativos encapsulados existentes no futuro?

Os ISVs podem continuar a melhorar seu agente de extensão de mensagem e enviar seus aplicativos por meio de métodos ou canais padrão. No entanto, eles serão limitados em termos de adicionar novas instruções ou conhecimentos ao seu agente.
 

Os parceiros podem enviar um Copilot de extensão de mensagem e um agente declarativo?

Os parceiros não podem ter os dois em um pacote de aplicativo. No entanto, eles podem tê-los em pacotes de aplicativos separados, mas isso seria incomum e exigiria aprovação de acordo com as diretrizes de validação da loja de aplicativos. Para obter mais informações, consulte as diretrizes de validação para agentes.
 

Um agente declarativo requer uma licença do Copilot?

Sim, um agente declarativo requer uma licença do Copilot, assim como os plug-ins do Copilot. A extensão de mensagem continua funcionando como uma extensão de mensagem no Teams e todos os agentes declarativos aparecem no chat do aplicativo.

Microsoft Graph

Como um usuário pode definir seu fuso horário para receber notificações em um horário preferencial?

Você pode usar a seguinte API do Graph: Obter configurações de caixa de correio do usuário. Você pode obter o fuso horário do usuário da seguinte maneira:

  • GET /me/mailboxSettings/timeZone
  • GET /users/{id|userPrincipalName}/mailboxSettings/timeZone

 

Como posso implantar o código no Azure usando o Microsoft 365 Agents Toolkit e usar a API do Graph para obter uma foto de perfil do usuário?

Para obter mais informações sobre o Kit de Ferramentas de Agentes, consulte Criar um novo projeto do Teams e a CLI do Kit de Ferramentas de Agentes do Microsoft 365 (anteriormente conhecida como CLI do Kit de Ferramentas do Teams).


 
A API do Graph funciona no Postman?

Você pode usar a coleção do Microsoft Graph Postman com as APIs do Microsoft Graph.

Para obter mais informações, confira Usar o Postman com a API do Microsoft Graph.
 

A API do Graph funciona no explorador do Microsoft Graph?

Sim, a API do Graph funciona no Explorador do Graph da Microsoft.

Para saber mais, consulte Explorador do Graph.
 

Como meu bot do Teams pode distinguir entre usuários comuns e administradores sem usar a API do Graph?

Configure seu aplicativo do Azure AD para incluir a wids declaração no token. Em seguida, o bot pode inspecionar o token para identificar com segurança funções de administrador, como Administração Global (62e90394-69f5-4237-9190-012177145e10) ou Teams Administração (69091246-20e8-4a56-aa4d-066075b2a7a8), sem usar API do Graph.
 

Monetize seu aplicativo

Damos suporte a compras no aplicativo?

Sim, oferecemos suporte a compras no aplicativo. Para obter mais informações, consulte Compras no aplicativo.


Como o fluxo é tratado pelo CSP que faz a compra para a empresa?

O CSP pode fazer compras para empresas na Microsoft Teams Store. Para obter mais informações, consulte Compra de aplicativos de terceiros.


Qual é a taxa percentual cobrada pela Microsoft?

A Microsoft cobra uma taxa de transação de 3% sempre que um pagamento é processado. Portanto, se for uma assinatura mensal, os 3% serão aplicados mensalmente. Essa cobrança se aplica tanto a transações com cartão de crédito quanto a cobrança de faturas.


Posso testar a oferta antes de publicar?

Sim, você pode testar a oferta antes da publicação. Para obter mais informações, consulte testar sua oferta de SaaS.


É obrigatório vincular o aplicativo do Teams existente ao meu módulo de monetização listado no AppSource?

Não é obrigatório, mas é uma boa prática implementá-lo.


Se o aplicativo for transacionável no Azure Marketplace, ele também estará disponível no Microsoft AppSource ou no Teams por padrão?

Não. O Azure Marketplace é diferente do AppSource (e, por extensão, da Teams App Store). Para serem listados na App Store do Teams, os aplicativos do Teams devem ser enviados no Partner Center para AppSource. Ele deve ter uma oferta transacionável vinculada e deve atualizar o manifesto do aplicativo Teams para incluir as IDs de fornecedor e oferta. Depois de fazer isso, reenvie ao Partner Center para validação antes que eles apareçam na App Store do Teams com um botão Comprar uma assinatura.


Quais são as etapas adicionais para obter a opção Compre uma assinatura na Teams Store?

Você deve adicionar as IDs ao manifesto (e carregar pelo PC para validar) que mostra o botão Comprar uma assinatura no Teams. Os parceiros podem continuar a ter aplicativos disponíveis no Teams e exigir que os clientes comprem por meio do AppSource. Passar por algumas etapas adicionais traz a opção de compra para a Teams Store.


O ISV pode definir preços diferentes por país por região?

Sim. Para obter mais informações, consulte preços e ofertas.


Quais são os possíveis cenários que meu parceiro pode enfrentar ao enviar seu aplicativo do Teams para validação?
  • Cenário 1: o parceiro tem um aplicativo Teams existente e uma oferta de SaaS transacionável existente.
  • Cenário 2: o parceiro tem um aplicativo Teams existente e NENHUMA oferta de SaaS transacionável existente.
  • Cenário 3: o parceiro NÃO tem aplicativo Teams existente e uma oferta de SaaS transacionável existente.
  • Cenário 4: o parceiro NÃO tem aplicativo Teams existente e NENHUMA oferta de SaaS transacionável existente.

O que os CSPs estão procurando ao fazer a correspondência com ISVs?

Para serem locais prontos para o canal, os ISVs na melhor posição para serem correspondidos com êxito como CSPs devem procurar:

  1. Aplicativos complementares para adicionar aos pacotes, soluções e serviços.
  2. Uma margem atraente, equilibrando seu esforço com a receita potencial.
  3. Materiais fáceis de consumir e prontos para uso com os clientes.

Os parceiros são capazes de fornecer um número mínimo de licenças disponíveis para compra como parte de uma assinatura?

Sim. Para obter mais informações, consulte experiência de compra de assinatura.


Como os assinantes podem atualizar, fazer downgrade ou cancelar suas assinaturas? Eles podem atualizar de mensal para anual?

Sim. São permitidos upgrade, downgrade e cancelamento de assinaturas. Para obter mais informações sobre o gerenciamento de licenças, consulte gerenciamento de licenças.


O aplicativo Teams dá suporte à cobrança limitada?

Sim. A cobrança limitada está disponível para a oferta de SaaS. Para obter mais informações, consulte cobrança limitada para ofertas de SaaS.


Notificações

Como posso salvar a referência de conversa em um bot proativo?

É recomendável que você salve as referências de conversa no banco de dados e use o mesmo para criar um objeto de conversa para enviar mensagens proativas.

Orientação da página

Observação

As perguntas frequentes são aplicáveis apenas ao Teams para dispositivos móveis.


Preciso fazer alguma alteração no aplicativo para obter o modo paisagem?

Não. Você pode usar aplicativos no modo paisagem por padrão.
 

E se meu aplicativo não der suporte a um dos modos ou se o cenário se destinar a funcionar apenas em um dos modos?

O Teams dá suporte a ambos os modos por padrão. Os aplicativos no Teams não têm suporte para funcionar em apenas um modo. Se o seu aplicativo exigir esse requisito, entre em contato com a equipe de suporte.
 

Como posso corrigir a rolagem ausente no estado vazio do aplicativo?

Adicione <FlexColumn scroll></FlexColumn> ao estado vazio do aplicativo.
 

Como testar a compatibilidade do meu aplicativo nos modos paisagem e retrato?

Para testar a compatibilidade do aplicativo em ambos os modos, execute o aplicativo no Teams móvel em diferentes orientações de dispositivo. Verifique se todos os elementos, incluindo botões, texto e imagens, estão alinhados e exibidos corretamente, sem distorções ou cortes na interface do usuário.
 

Há alguma prática recomendada para criar aplicativos que funcionem bem nos modos paisagem e retrato? Sim, ao projetar aplicativos para o Teams, é essencial seguir princípios de design responsivos para garantir o desempenho ideal e a experiência do usuário nos modos paisagem e retrato. Use layouts flexíveis e componentes adaptáveis para acomodar diferentes tamanhos e orientações de tela.
 
O modo paisagem dá suporte aos aplicativos do Teams para Android e iOS?

Sim, o modo paisagem tem suporte nos aplicativos Teams para Android e iOS, proporcionando uma experiência consistente para usuários em ambas as plataformas.
 

Posso personalizar o comportamento do aplicativo de forma diferente para os modos paisagem e retrato?

O comportamento do aplicativo permanece consistente em ambos os modos. No entanto, se você tiver casos de uso ou requisitos específicos que exijam comportamentos diferentes em cada modo, entre em contato com a equipe de suporte com seus comentários e sugestões.
 

Existe algum impacto no desempenho dos aplicativos no modo paisagem?

Não, o suporte ao modo paisagem no Teams não tem nenhum efeito negativo no desempenho do aplicativo. O Teams garante uma experiência tranquila e perfeita para os usuários, independentemente da orientação do dispositivo.
 

Centro de parceria

Onde você encontra o ID do CCP?

Você pode encontrar sua ID da CCP buscando a ID do Partner Center.
 

Não consigo ver a guia Desenvolvedor no Partner Center. Como posso corrigir isso?

Se você não conseguir ver a guia Desenvolvedor, poderá abrir um tíquete no Partner Center.

Para obter mais informações sobre como abrir um tíquete, consulte Obter ajuda ou abrir um tíquete de suporte.
 

Como fazer para criar uma conta do Partner Center?

Você pode criar uma conta do Partner Center uma das seguintes maneiras:

 

Como posso encontrar minha conta no Partner Center?

Abra um tíquete de suporte no Partner Center e selecione o seguinte:

Menu Opção
Categoria Marketplace Comercial
Tópico Ajuda geral do Marketplace e perguntas de instruções
Subtópico Suplemento do Office

Onde posso obter suporte para meus problemas de conta do Partner Center?

Visite a página de suporte dos editores para pesquisar seu problema. Se as diretrizes não forem úteis, crie um tíquete de suporte do Partner Center.
 

Como fazer gerenciar minha conta da Microsoft 365 Store no Partner Center?

Consulte gerenciar sua conta por meio Partner Center para obter informações.
 

Meu número de telefone não tem um código de área, portanto, como adicioná-lo ao meu perfil?

O número de telefone tem três partes: código do país, código de área e número de telefone. Se o número de telefone não incluir um código de área, deixe a segunda caixa vazia e preencha a terceira caixa.
 

Como fazer para gerenciar as configurações da minha conta e o perfil do parceiro no Partner Center?

Consulte gerenciar configurações de conta e informações de perfil para obter informações.
 

Por que vejo uma mensagem "Esta conta não está qualificada para publicação" quando tento enviar meu aplicativo?

Você recebeu esta mensagem de erro porque seu status de verificação da conta está pendente. Verifique seu status no paineldo Partner Center. Selecione o ícone de engrenagem Configurações e escolha Configurações > de desenvolvedor Configurações da conta > Configurações da conta.

Status de verificação do Partner Center
 

O que é verificado no processo de verificação de conta do Partner Center?

Há três áreas de verificação, Propriedade de e-mail, Emprego e Business. Para obter mais informações, confira O que é verificado e como responder.

Se você for o contato principal, Administrador Global ou administrador da conta, poderá monitorar o status da verificação e acompanhar o progresso em sua página de perfil.

Após a conclusão do processo de verificação, o status do seu registro na página de perfil muda de pendente para autorizado. Em seguida, o contato principal recebe um email da Microsoft dentro de alguns dias úteis.
 

O status de verificação da minha conta não avançou além da Propriedade do Email. Como devo proceder?

Durante o processo de verificação da Propriedade do email um email de verificação é enviado ao contato principal. Verifique sua caixa de entrada de contato principal para obter um email com a linha de assunto Ação necessária: verificar sua conta de email com a Microsoft e concluir o processo de verificação de maccount@microsoft.com email. O email de verificação é enviado para o endereço listado nas configurações da conta do Partner Center.

Lembre-se dos seguintes pontos sobre o processo de verificação de e-mail:

  • O link de verificação de e-mail é válido apenas por sete dias.
  • Você pode solicitar o reenvio do email visitando sua página de perfil de parceiro e selecionando o link Reenviar email de verificação.
  • Para garantir que você receba o email, liste microsoft.com como um domínio seguro e verifique suas pastas de lixo eletrônico.

 

Verifiquei minhas pastas de email e não recebi o email de verificação. O que devo fazer a seguir?

Experimente as etapas a seguir:

  • Verifique sua pasta de lixo eletrônico ou spam.
  • Limpe o cache do navegador, vá para o painel da conta do Partner Center e selecione Reenviar email de verificação.
  • Tente acessar o link Reenviar email de verificação de um navegador diferente.
  • Trabalhe com seu departamento de TI para garantir que os emails de verificação não sejam bloqueados pelo servidor de email.
  • Ajuste o filtro de spam do servidor para permitir ou colocar na lista segura todos os emails de maccount@microsoft.com.

 

Quanto tempo geralmente leva o processo de verificação de emprego?

Se todos os detalhes enviados estiverem corretos, o processo de verificação de emprego leva cerca de duas horas para ser concluído.
 

Quanto tempo leva normalmente o processo de verificação de negócios?

Se todos os documentos necessários forem enviados, a verificação de negócios levará de um a dois dias úteis para ser concluída.
 

Se eu entrar em contato com a equipe de suporte, meu tíquete será acelerado?

Os tíquetes de suporte são resolvidos em uma semana. Verifique se há atualizações enviadas para o email que você forneceu ao criar o tíquete de suporte.
 

Criei um tíquete de suporte, mas não recebo uma atualização há sete dias úteis. Onde posso obter ajuda?

Envie um email com teamsubm@microsoft.com os seguintes detalhes:

  • Assunto: Problema na conta do Partner Center para nome do aplicativo.
  • Corpo do email:
    • Número do tíquete de suporte.
    • Sua ID de vendedor.
    • Uma captura de tela do problema, se possível.

 

Onde mais posso obter ajuda do Partner Center?

Os recursos a seguir também podem ajudar:

Logon único

Como validar um usuário quando ele invocar um Cartão Adaptável?

Você pode abrir a página de autenticação na caixa de diálogo (referida como módulo de tarefa no TeamsJS v1.x) quando o usuário seleciona o botão.

Você pode usar o exemplo de código para abrir a caixa de diálogo ao clicar no botão. Você pode substituir taskInfo.url pela sua página de autenticação.


 
Como posso alterar o URI da ID do aplicativo do escopo do SSO para usar a ID do bot também para que a janela de consentimento não seja necessária para um aplicativo de bot?

Para obter mais informações, consulte Configurar seu aplicativo no Microsoft Entra ID.
 

Quero abrir um iframe que contenha um aplicativo React (que exibe informações confidenciais) em uma caixa de diálogo do bot (conhecido como módulo de tarefa no TeamsJS v1.x) com segurança. Você pode sugerir qual é a melhor, mais fácil e padrão abordagem para realizar essa operação?

Implemente a página react com SSO de guia e renderize o conteúdo conforme necessário. Você pode abrir a mesma URL da guia que a caixa de diálogo do bot.

Para obter mais informações, consulte Habilitar SSO para aplicativo de guia.
 

Como evitar o erro de tempo limite do SDK enquanto o usuário do aplicativo entra?

Abra a página inicial simples de entrada em vez de abrir a página de logon diretamente para resolver o problema.
 

Como posso gerar o token de acesso usando o ponto de extremidade oauth2/v2.0/token com tipo de concessão como authorization_code?

Configure o aplicativo que você está usando para executar a codificação HTML dos escopos apenas uma vez, para que os escopos possam ser enviados e avaliados corretamente pelo Microsoft Entra ID.
 

Como posso implementar o SSO de Bot usando o React?

Se você usar o Kit de Ferramentas de Agentes para criar seu aplicativo, consulte Adicionar logon único ao aplicativo Teams para obter mais informações.

Para obter mais informações sobre o exemplo de código js do Node, consulte Início rápido de autenticação de bot.
 

Stageview


Qual Stageview devo usar?

O Collaborative Stageview permite que os usuários abram o conteúdo junto com uma conversa do painel lateral em uma janela do Teams. Essa exibição é mais adequada para a maioria dos cenários de colaboração.


Qual é a diferença entre o Stageview Modal e as caixas de diálogo?

O Stageview Modal é útil para exibir conteúdo rico para os usuários, como página, dashboard ou arquivo.
As caixas de diálogo (chamadas de módulos de tarefas no TeamsJS v1.x) são úteis para exibir mensagens que precisam da atenção dos usuários ou coletar informações necessárias para passar para a próxima etapa.


Quando o Stageview é invocado, o conteúdo é aberto no Stageview Colaborativo, mas é carregado na janela principal do Teams em vez de em uma nova janela. Como abrir o conteúdo em uma nova janela?

Certifique-se de que seu contentUrl domínio seja refletido com precisão na propriedade manifest validDomains . Para obter mais informações, consulte Esquema de manifesto do aplicativo.


Por que nenhum conteúdo é exibido em uma nova janela do Teams, mesmo quando contentUrl corresponde a validDomains?

Chame app.notifySuccess() todo o conteúdo baseado em iframe para notificar o Teams de que seu aplicativo foi carregado com êxito. Se aplicável, o Teams oculta o indicador de carregamento. Se notifySuccess não for chamado em 30 segundos, o Teams presume que o aplicativo atingiu o tempo limite e exibe uma tela de erro com uma opção de repetição. Para atualizações de aplicativo, esta etapa é aplicável para guias que já estão configuradas. Se você não executar esta etapa, uma tela de erro será exibida para os usuários existentes.


Posso incluir um link profundo no meu contentUrl?

Não, não há suporte para links profundos no contentUrl.


Como fazer para manter uma conversa específica exibida ao lado do meu conteúdo?

O Stageview colaborativo de um link profundo ou de uma API stageView vem com o parâmetro adicional threadId . Você pode definir explicitamente o thread de chat a ser exibido no painel lateral para seu arquivo .contentUrl Para obter mais informações sobre como recuperar um threadId, consulte Obter thread de conversa.


Guias

Como posso usar o deeplink para obter a subEntityId ou a subPageId no cliente móvel ao navegar de uma guia para outra?

Atualize o SDK do cliente JavaScript do Teams para (@microsoft/teams-js": "^2.0.0") para resolve o problema.
 

Qual guia será fixada se a guia configurável e a guia estática forem definidas no manifesto do aplicativo para um escopo específico?

Se você tiver a guia configurável e a guia estática definidas no manifesto do aplicativo para um escopo específico, o Teams fixará a guia estática por padrão.
 

E se eu já tiver guias configuráveis fixadas pré-existentes após alternar para guias estáticas?

As instâncias de guia configuráveis fixadas pré-existentes do seu aplicativo continuam funcionando da mesma forma. Você não tem a opção de fixar novas instâncias dessas guias configuráveis. Quando você opta por fixar sua guia, o Teams fixa a guia estática do seu aplicativo.
 

Como fazer otimizar minhas páginas da guia para ter um melhor desempenho em dispositivos móveis?

Para otimizar o desempenho do aplicativo de guia no Teams móvel, use profissionais de serviço para armazenar em cache ativos estáticos e minimizar o tamanho da página da Web. Você também pode realizar auditorias de desempenho usando ferramentas de desenvolvimento para identificar gargalos. Para obter mais informações, consulte práticas recomendadas para aplicativos móveis do Teams.
 

Teams SDK


O que o SDK do Teams faz?

O SDK do Teams fornece abstrações para você criar aplicativos robustos que utilizam LLMs (Modelos de Linguagem Grande) do OpenAI.


A Microsoft fornece uma versão hospedada dos modelos OpenAI usados pelo SDK do Teams?

Não, você precisa ter seus LLMs (Modelos de Linguagem Grande) hospedados no OpenAI do Azure ou em outro lugar.


Podemos usar o SDK do Teams com outros modelos de linguagem grandes além do OpenAI?

Sim, é possível usar o SDK do Teams com outros modelos de linguagem grande (LLMs).


Um desenvolvedor precisa fazer alguma coisa para se beneficiar dos LLMs? Em caso afirmativo, por quê?

Sim, o SDK do Teams fornece abstrações para simplificar a utilização de LLMs (Modelos de Linguagem Grande) em aplicativos de conversação. No entanto, você (desenvolvedor) deve ajustar os prompts, filtros de tópico e ações dependendo de seus cenários.


Como o SDK do Teams se integra ao ODSL?

Os dois são independentes e não podem ser integrados.


Como o SDK do Teams coexiste com a história de heróis dos desenvolvedores que criam para o ecossistema de habilidades no Microsoft 365?

A história do SDK do Teams é voltada para desenvolvedores profissionais e separada da história de herói em torno do ecossistema de habilidades no Microsoft 365.


Como as informações sobre o SDK do Bot Framework existente devem ser comunicadas após o anúncio de uma nova versão?

O SDK do Teams funciona junto com o SDK do Bot Framework existente e não é um substituto.

Microsoft 365 Agents Toolkit

Perguntas frequentes sobre Provisionar recursos de nuvem usando o Kit de ferramentas de agentes.

Como solucionar problemas?

Se você receber erros com o Agents Toolkit no Visual Studio Code, poderá selecionar Obter Ajuda na notificação de erro para ir para o documento relacionado. Se você estiver usando a CLI do Agents Toolkit, haverá um hiperlink no final da mensagem de erro que aponta para o documento de ajuda.

 

Como posso alternar para outra assinatura do Azure durante o provisionamento?
  1. Alterne a assinatura na conta atual ou faça logoff e selecione uma nova assinatura.
  2. Se você já tiver provisionado o ambiente atual, precisará criar um novo ambiente e executar o provisionamento porque o ARM não dá suporte à movimentação de recursos.
  3. Se você não provisionou o ambiente atual, poderá disparar o provisionamento diretamente.

 

Como posso alterar o grupo de recursos durante o provisionamento?

Antes de provisionar, o kit de ferramentas pergunta se você deseja criar um novo grupo de recursos ou usar um existente. É possível fornecer um novo nome de grupo de recursos ou escolher um existente nesta etapa.
 

Como posso provisionar um aplicativo baseado no SharePoint?

Você pode fazer isso seguindo a provisão do aplicativo baseado no SharePoint.
 

Como posso implantar o código no Microsoft Entra ID usando o Microsoft 365 Agents Toolkit e usar a API do Graph para obter a foto de perfil do usuário do aplicativo?

Referências compartilhadas para implantar o código usando o kit de ferramentas:

Você pode chamar a API do Graph para obter a foto de perfil do usuário do aplicativo.
 

Distribuição de aplicativos

Por que vejo a mensagem Você não tem acesso a este aplicativo ao adicionar um aplicativo personalizado do Teams?

Para resolve o erro Você não tem acesso a este aplicativo, verifique se o canal do Teams está habilitado no seu Azure Serviço de Bot.
 

É aceitável incluir localhost como um domínio válido em um manifesto do suplemento do Outlook?

O localhost domínio é aceitável apenas para desenvolvimento e teste local. Para envio em produção ou repositório, todos os pontos de extremidade devem ser acessíveis publicamente e protegidos usando HTTPS.
 

PowerShell

Como recuperar todos os atendedores automáticos ou filas de chamadas se a saída estiver limitada a 100 linhas?

Use os -First parâmetros and -Skip com Get-CsAutoAttendant ou Get-CsCallQueue para paginar os resultados e recuperar todas as entradas. O -Limit All parâmetro não é mais suportado.
 

Power Platform

Como posso configurar um fluxo de trabalho do Teams para aguardar a aprovação manual sem atingir o tempo limite muito rapidamente?

Use Iniciar e aguarde uma ação de aprovação no Power Automate. Nas configurações de ação, estenda o tempo limite especificando a duração no formato ISO 8601 (por exemplo, P7D por 7 dias). Isso garante que o fluxo de trabalho seja pausado até que a aprovação seja concedida.
 

Quais são os requisitos de licenciamento da Power Platform para ambientes gerenciados e uso do Copilot?

Em ambientes gerenciados, todos os criadores e usuários finais devem ter uma licença premium do Power Platform, mesmo para aplicativos padrão. Para o Copilot, licenças individuais não são necessárias se os usuários estiverem cobertos pela capacidade de mensagens no nível do locatário. Caso contrário, será necessária uma licença pessoal do Copilot.