Compartilhar via

Pré-requisitos para criar o seu agente ou aplicação do Teams

Antes de criar o seu projeto do Microsoft Teams, certifique-se de que os pré-requisitos estão implementados. Você deve:

Instalar as ferramentas necessárias para criar a sua área de trabalho do Teams

Certifique-se de que os seguintes requisitos são cumpridos antes de começar a criar o seu agente ou aplicação do Teams:

  Ferramentas Objetivo Para o tipo de ambiente
Required      
  Toolkit de Agentes do Microsoft 365 (anteriormente conhecido como Toolkit do Teams) Uma extensão do Microsoft Visual Studio Code que cria um projeto estruturado para a sua aplicação. Utilize a versão mais recente. JavaScript e TypeScript
  Microsoft Teams Colabore com todas as pessoas com quem trabalha através de agentes ou aplicações para conversas, reuniões e chamadas, tudo num único local. JavaScript e TypeScript
  Node.js Ambiente de runtime do JavaScript de back-end. Para obter mais informações, veja Node.js tabela de compatibilidade de versões para o tipo de projeto. JavaScript e TypeScript
  Gestor de Pacotes de Nós (NPM) Instale e faça a gestão de pacotes para utilização em aplicações Node.js e ASP.NET Core. JavaScript e TypeScript
  Microsoft Edge (recomendado) ou Google Chrome Um navegador com ferramentas de desenvolvedor. JavaScript e TypeScript
  Microsoft Visual Studio Code Ambientes de compilação JavaScript, TypeScript ou Python (na pré-visualização do programador). Utilize a versão mais recente. JavaScript e TypeScript
Opcional      
  Azure Tools for Visual Studio Code and CLI do Azure (Ferramentas do Azure para a CLI de Visual Studio Code e Azure) Aceda a dados armazenados ou implemente um back-end baseado na cloud para a sua aplicação Teams no Azure. JavaScript
  Ferramentas de Programação do React para Chrome ou ferramentas de programador React para o Microsoft Edge Uma extensão DevTools do browser para a biblioteca JavaScript de React open source. JavaScript
  Microsoft Graph Explorer Uma ferramenta baseada no browser que lhe permite executar uma consulta a partir de dados do Microsoft Graph. JavaScript e TypeScript
  Portal do Desenvolvedor do Teams Um portal baseado na Web para configurar, gerir e publicar o seu agente ou aplicação do Teams na sua organização ou na Loja Teams. JavaScript e TypeScript

Contas para criar o seu agente ou aplicação do Teams

Certifique-se de que tem as seguintes contas antes de começar a criar o seu agente ou aplicação do Teams:

Contas Objetivo Para o tipo de ambiente
Conta escolar ou profissional do Microsoft 365 Conta de programador do Teams ao desenvolver uma aplicação. JavaScript, TypeScript, Python (na pré-visualização do programador) e C#.
Azure conta Recursos de back-end no Azure. JavaScript, TypeScript, Python (na pré-visualização do programador) e C#.

Dica

Se quiser que o seu agente ou aplicação tenha suporte para o SharePoint, tem de ter uma conta de administrador do site de coleção do SharePoint.

Programa para desenvolvedores do Microsoft 365

Observação

Para criar um agente ou aplicação do Teams, tem de ter uma conta escolar ou profissional do Microsoft 365. Não é possível utilizar o Microsoft 365 conta pessoal.

Se você tiver uma assinatura do Visual Studio Enterprise ou Professional, ambos os programas incluem uma assinatura de desenvolvedor gratuita do Microsoft 365. Ele estará ativo desde que sua assinatura do Visual Studio esteja ativa. Para obter mais informações, consulte Assinatura de desenvolvedor do Microsoft 365.

Se não tiver nenhum inquilino do Microsoft 365, poderá qualificar-se para uma subscrição de programador Microsoft 365 E5 através do Programa para Programadores do Microsoft 365. Para obter mais informações, veja as FAQ. Em alternativa, inscreva-se numa avaliação gratuita de um mês ou compre um plano do Microsoft 365.

Pode inscrever-se no programa de programador com um dos seguintes tipos de conta:

  • Conta da Microsoft para uso pessoal

    A conta Microsoft fornece acesso aos produtos e serviços cloud da Microsoft, como o Outlook, Messenger, OneDrive, MSN, Xbox Live ou Microsoft 365.

    Inscreva-se numa caixa de correio Outlook.com para criar uma conta Microsoft (conta pessoal). Pode utilizar esta conta Microsoft para se inscrever no Programa de Programador do Microsoft 365 e para aceder a serviços cloud ou Azure da Microsoft relacionados com o consumidor. Tenha em atenção que esta conta Microsoft pessoal não pode ser utilizada diretamente para criar aplicações do Teams; precisará de uma conta do Microsoft 365 escolar ou profissional separada para tal.

    Captura de ecrã a mostrar o ícone conta pessoal.

  • Conta de trabalho da Microsoft para empresas

    Esta conta fornece acesso a todos os serviços cloud da Microsoft de nível empresarial pequeno, médio e empresarial. Os serviços incluem Azure, Microsoft Intune e Microsoft 365.

    Quando se inscreve num destes serviços como uma organização, um diretório baseado na cloud é aprovisionado automaticamente no Microsoft Entra ID para representar a sua organização.

    Captura de ecrã a mostrar o ícone da conta profissional.

Criar uma conta de programador gratuita do Microsoft 365

Para criar uma conta de programador gratuita do Microsoft 365:

  1. Acesse o Programa para desenvolvedores do Microsoft 365.
  2. Selecione Ingressar agora.
  3. Configure a subscrição da conta de administrador. Para obter mais informações, consulte Configurar uma subscrição do Sandbox para programadores do Microsoft 365

Conta do Azure

Uma conta Azure permite-lhe alojar um agente ou aplicação do Teams, ou os respetivos recursos de back-end, no Azure através do Toolkit de Agentes no Visual Studio Code. Precisa de uma subscrição Azure se:

  • Está a integrar um agente ou aplicação existente alojado fora do Azure com o Teams
  • Planeia alojar recursos de back-end noutro fornecedor de cloud ou nos seus próprios servidores acessíveis publicamente.

Observação

Pode utilizar Azure conta para aprovisionar Azure recurso para alojar o seu agente ou aplicação do Teams. Crie uma conta gratuita se ainda não tiver uma.

Não é necessária uma conta Azure se não estiver a utilizar o Toolkit de Agentes para aprovisionamento e implementação.

Verificar a permissão de carregamento de aplicações personalizadas

Depois de criar o seu agente ou aplicação, tem de carregá-lo para o Teams sem o distribuir. Isto chama-se carregamento de uma aplicação personalizada. Inicie sessão na sua conta do Microsoft 365 para aceder a esta opção. Pode marcar se o carregamento de aplicações personalizadas está ativado através de Visual Studio Code ou cliente do Teams.


Verificar a permissão de carregamento de aplicações personalizadas com Visual Studio Code

Só pode verificar as permissões de carregamento de aplicações personalizadas desta forma depois de ter criado um projeto com o Toolkit de Agentes do Microsoft 365. Se ainda não criou um projeto, utilize o cliente do Teams para marcar a permissão.

  1. Abra o Visual Studio Code.

  2. Selecione Toolkit de Agentes do Microsoft 365 na barra de atividade Visual Studio Code.

    Observação

    Se não conseguir ver a opção, veja Instalar o Toolkit de Agentes para instalar a extensão Do Toolkit de Agentes no Visual Studio Code.

  3. Crie um novo projeto do Toolkit de Agentes ou abra um projeto existente.

  4. Selecione Iniciar sessão no Microsoft 365 emCONTAS.

    Captura de ecrã a mostrar os detalhes das contas.

  5. Verifique se consegue ver a opção Carregamento de Aplicações Personalizadas Ativado , conforme mostrado na imagem seguinte:

    Captura de ecrã a mostrar a opção ativada para carregamento de aplicações personalizada realçada a vermelho.


Verificar a permissão de carregamento de aplicações personalizadas com o cliente do Teams

  1. No cliente do Teams, selecione Aplicações>Gerir as suas aplicações>Carregar uma aplicação.

    Captura de ecrã a mostrar a opção para carregar uma aplicação no Teams.

  2. Verifique se consegue ver a opção Carregar uma aplicação personalizada.

    Captura de ecrã a mostrar a opção para carregar uma aplicação personalizada no Teams.

Ativar o carregamento de aplicações personalizadas com o centro de administração

Se a opção de carregamento de aplicações personalizadas não estiver visível no Toolkit de Agentes no Visual Studio Code ou se a opção para carregar uma aplicação personalizada não estiver disponível no Teams, significa que não tem a permissão necessária para o carregamento de aplicações personalizadas.

Tem de ativar o carregamento de aplicações personalizadas no Teams, consoante a sua função:

  • Se for Administrador do Teams, ative a definição de carregamento de aplicações personalizadas para o seu inquilino ou organização no centro de administração do Teams.
  • Se não for administrador do Teams, contacte o seu administrador para ativar o carregamento de aplicações personalizadas.

Se for administrador do Teams (ou seja, tiver direitos de administrador), siga estes passos no centro de administração do Teams para ativar o carregamento de aplicações personalizadas:

  1. Acessar o Centro de administração do Microsoft 365 com suas credenciais de administrador.

  2. Selecione o ícone >Teams.

    Captura de ecrã a mostrar o cliente do Teams no painel esquerdo do Administração Microsoft 365 centro.

    Observação

    Pode levar até 24 horas para a opção Teams ser exibida. Você pode carregar seu aplicativo personalizado em um ambiente do Teams para teste e validação.

  3. Inicie sessão no centro de administração do Microsoft Teams com as suas credenciais de administrador.

  4. Selecione o ícone >Políticas de configuração de aplicações> do Teams.

    Captura de ecrã a mostrar as políticas de Configuração em Aplicações do Teams no centro Administração Microsoft 365.

  5. Selecione Global (predefinição em toda a organização).

    Captura de ecrã a mostrar o separador Gerir políticas com a opção Global (predefinição de toda a organização) realçada.

  6. Defina a opção Carregar aplicações personalizadas como Ativado.

    Captura de ecrã a mostrar o botão de alternar Carregar aplicações personalizadas realçado.

  7. Selecione Salvar.

    Observação

    Pode demorar até 24 horas para que o carregamento de aplicações personalizadas se torne ativo. Depois de estar ativa, pode utilizar a opção Carregar uma aplicação personalizada no Teams para testar a sua aplicação. Para carregar o arquivo do pacote .zip do aplicativo, consulte Carregar aplicativos personalizados.

    Certifique-se de que tem a permissão de carregamento da aplicação através dos passos mencionados em Verificar a permissão de carregamento de aplicações personalizadas.

Confira também

  • Last updated on