Solucionar problemas em seu aplicativo Microsoft Teams

  • Artigo

Para solucionar problemas de guias

Acessar DevTools

Você pode abrir o DevTools no cliente do Teams para obter uma experiência semelhante à de pressionar F12 (no Windows) ou Command-Option-I (no MacOS) em um navegador.

Tela de guia em branco

Se você não estiver vendo seu conteúdo no modo de exibição de guia, pode ser:

  • seu conteúdo não pode ser exibido em um <iframe>.
  • o domínio de conteúdo não está na lista validDomains no manifesto.

Observação

Uma guia em branco é exibida quando a URL da guia fornecida redireciona para a tela de logon. As páginas de logon não são renderizadas em iFrames como uma proteção contra o roubo de cliques. Sua lógica de autenticação deve usar um método diferente de redirecionamento.

As alterações no meu aplicativo Web não são refletidas em sua guia Teams

Se você tiver problemas de cache consistentes ou intermitentes em que as atualizações para seu aplicativo Web não estão aparecendo quando está hospedada em uma guia do Teams, marcar as configurações de cache do servidor e use Cache-Control cabeçalhos para garantir o comportamento de cache do cliente desejado.

O botão Salvar não está habilitado na caixa de diálogo configurações

Certifique-se de chamar microsoftTeams.settings.setValidityState(true) depois que o usuário tiver entrada ou selecionado todos os dados necessários em sua página de configurações para habilitar o botão salvar.

As configurações da guia não podem ser salvas ao selecionar Salvar

Ao adicionar uma guia, se você selecionar Salvar , mas receber uma mensagem de erro indicando que as configurações não podem ser salvas, o problema poderá ser uma das duas classes de problemas:

  • A mensagem de sucesso de salvamento nunca foi recebida: se um manipulador de salvamento foi registrado usando microsoftTeams.settings.registerOnSaveHandler(handler), o retorno de chamada deve chamar saveEvent.notifySuccess().

    • Se o retorno de chamada não chamar saveEvent.notifySuccess() dentro de 30 segundos ou chamadas saveEvent.notifyFailure(reason) , esse erro será mostrado.
    • Se nenhum manipulador de salvamento foi registrado, a saveEvent.notifySuccess() chamada será feita automaticamente quando o usuário seleciona Salvar.

  • As configurações fornecidas eram inválidas: a outra razão pela qual as configurações podem não ser salvas é se a chamada para microsoftTeams.setSettings(settings) fornecer um objeto de configurações inválida ou a chamada não foi feita. Confira a próxima seção, Problemas comuns com o objeto configurações.

Problemas comuns com o objeto configurações

  • settings.entityId está ausente. O campo é obrigatório.
  • settings.contentUrl está ausente. O campo é obrigatório.
  • settings.contentUrl ou o opcional settings.removeUrl, ou settings.websiteUrl são fornecidos, mas não são válidos. As URLs devem usar HTTPS e também devem ser o mesmo domínio que a página de configurações ou especificadas na lista do validDomains manifesto.

Não é possível autenticar o usuário ou exibir seu provedor de auth em sua guia

A menos que você esteja fazendo autenticação silenciosa, você deve seguir o processo de autenticação fornecido pela biblioteca de clientes JavaScript do Microsoft Teams.

Observação

Exigimos todo o fluxo de autenticação para iniciar e terminar em seu domínio, que deve ser listado no validDomains objeto em seu manifesto.

Para obter mais informações sobre autenticação, confira como autenticar um usuário.

Guias estáticas que não aparecem

Há um problema conhecido em que atualizar um aplicativo bot existente com uma guia estática nova ou atualizada não mostrará essa alteração de guia ao acessar o aplicativo de uma conversa de chat pessoal. Para ver a alteração, você deve testar em uma nova instância de usuário ou teste ou acessar o bot no flyout aplicativos.

Para solucionar problemas de bots

Não é possível adicionar meu bot

Os aplicativos devem ser habilitados pelo administrador de locatários do Microsoft 365 para que sejam carregados pelos usuários finais. Em alguns casos, o locatário do Microsoft 365 pode ter várias SKUs associadas a ele e, para que os bots funcionem em qualquer, eles devem estar habilitados em todas as SKUs. Para obter mais informações, consulte preparar seu locatário do Microsoft 365.

Não é possível adicionar bot como membro de uma equipe

Os bots devem primeiro ser carregados em uma equipe antes de serem acessíveis em qualquer canal dessa equipe. Para obter mais informações sobre esse processo, confira como carregar seu aplicativo em uma equipe.

Meu bot não recebe minha mensagem em um canal

Os bots nos canais recebem mensagens somente quando estão explicitamente @mentioned, mesmo que você esteja respondendo a uma mensagem de bot anterior. A única exceção em que você pode não ver o nome do bot em uma mensagem é se o bot receber uma imBack ação como resultado de um CardAction que ele enviou originalmente.

Meu bot não entende meus comandos quando está em um canal

Como os bots nos canais só recebem mensagens quando são @mentioned, todas as mensagens recebidas pelo bot em um canal incluem isso @mention no campo de texto. É uma prática recomendada tirar o nome do bot de todas as mensagens de texto de entrada antes de passar para sua lógica de análise. Examine as menções para obter dicas sobre como lidar com esse caso.

Problemas com empacotamento e carregamento

Erro ao ler manifest.json

A maioria dos erros de manifesto fornece uma dica de qual campo específico está ausente ou inválido. No entanto, se o arquivo JSON não puder ser lido como JSON, essa mensagem de erro genérica será usada.

Motivos comuns para erros de leitura de manifesto:

  • JSON inválido. Use um IDE como Visual Studio Code ou Visual Studio que valida automaticamente a sintaxe JSON.
  • Problemas de codificação. Use UTF-8 para o arquivo manifest.json . Outras codificações, especificamente com o BOM, podem não ser legíveis.
  • Pacote de .zip malformado. O arquivo manifest.json deve estar no nível superior do arquivo .zip. Observe que a compactação de arquivo Mac padrão pode colocar o manifest.json em um subdiretório, que não será carregado corretamente no Microsoft Teams.

Existe outra extensão com a mesma ID

Se você estiver tentando carregar um pacote atualizado com a mesma ID novamente, escolha o ícone Substituir no final da linha de tabela da guia em vez do botão Carregar .

Se você não estiver recarregando um pacote atualizado, verifique se a ID é exclusiva.

Confira também