Pré-requisitos para criar seu aplicativo do Teams

Artigo
03/07/2024

Antes de criar seu projeto de aplicativo do Microsoft Teams, verifique se os pré-requisitos estão em vigor. Você deve:

Instalar ferramentas necessárias para criar seu aplicativo teams
Preparar contas para criar seu aplicativo teams
Verificar a permissão de carregamento de aplicativo personalizado

Instalar ferramentas necessárias para criar seu aplicativo teams

Verifique se os seguintes requisitos são atendidos antes de começar a criar seu aplicativo teams:

	Ferramentas	Objetivo	Para tipo de ambiente
Required
	Kit de ferramentas do Teams	Uma extensão do Microsoft Visual Studio Code que cria um scaffolding de projeto para seu aplicativo. Use a versão mais recente.	JavaScript e SPFx
	Microsoft Teams	Colabore com todos com quem você trabalha por meio de aplicativos para chat, reuniões e chamadas - tudo em um só lugar.	JavaScript e SPFx
	Node.js	Ambiente de runtime do JavaScript de back-end. Para obter mais informações, consulte Node.js tabela de compatibilidade de versão para o tipo de projeto.	JavaScript e SPFx
	NPM (Gerenciador de Pacotes de Nós)	Instale e gerencie pacotes para uso em aplicativos Node.js e ASP.NET Core.	JavaScript e SPFx
	Microsoft Edge (recomendado) ou Google Chrome	Um navegador com ferramentas de desenvolvedor.	JavaScript e SPFx
	Microsoft Visual Studio Code	Ambientes de build JavaScript, TypeScript ou SPFx. Use a versão mais recente.	JavaScript e SPFx
Opcional
	Ferramentas do Azure para Visual Studio Code e CLI do Azure	Acesse dados armazenados ou implante um back-end baseado em nuvem para seu aplicativo teams no Azure.	JavaScript
	React Ferramentas de Desenvolvedor para Chrome ou React Ferramentas de Desenvolvedor para Microsoft Edge	Uma extensão DevTools do navegador para a biblioteca JavaScript React de código aberto.	JavaScript
	Microsoft Graph Explorer	Uma ferramenta baseada no navegador que permite executar uma consulta de dados do Microsoft Graph.	JavaScript e SPFx
	Portal do Desenvolvedor do Teams	Um portal baseado na Web para configurar, gerenciar e distribuir seu aplicativo teams para sua organização ou para a Teams Store.	JavaScript e SPFx

Contas para criar seu aplicativo do Teams

Verifique se você tem as seguintes contas antes de começar a criar seu aplicativo do Teams:

Contas	Objetivo	Para tipo de ambiente
Conta corporativa ou escolar do Microsoft 365	Conta de desenvolvedor do Teams durante o desenvolvimento de um aplicativo.	JavaScript, TypeScript, SPFx e C# ou Blazor.
Conta do Azure	Recursos de back-end no Azure.	JavaScript, TypeScript, SPFx e C# ou Blazor.
Conta de administrador do site de coleção do SharePoint	Implantação para hospedagem.	SPFx.

Programa para desenvolvedores do Microsoft 365

Observação

Para criar aplicativos do Teams, você deve ter uma conta do Microsoft 365 do trabalho ou da escola. O Microsoft 365 conta pessoal não pode ser usado.

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 você não tiver nenhum locatário do Microsoft 365, poderá se qualificar para uma assinatura de desenvolvedor Microsoft 365 E5 por meio do Programa de Desenvolvedores do Microsoft 365; para obter detalhes, consulte as perguntas frequentes. Como alternativa, você pode se inscrever para uma avaliação gratuita de 1 mês ou comprar um plano do Microsoft 365.

Você pode se inscrever no programa de desenvolvedor usando um dos seguintes tipos de conta:

Conta da Microsoft para uso pessoal

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

Inscreva-se em uma caixa de correio Outlook.com para criar uma conta do Microsoft 365. Use-o para acessar serviços de nuvem da Microsoft relacionados ao consumidor ou ao Azure.
Conta de trabalho da Microsoft para empresas

Essa conta fornece acesso a todos os serviços de nuvem microsoft pequenos, médios e empresariais de nível empresarial. Os serviços incluem O Azure, Microsoft Intune e Microsoft 365.

Quando você se inscreve em um desses serviços como uma organização, um diretório baseado em nuvem é provisionado automaticamente em Microsoft Entra ID para representar sua organização.

Criar uma conta de desenvolvedor gratuita do Microsoft 365

Para criar uma conta de desenvolvedor gratuita do Microsoft 365:

Acesse o Programa para desenvolvedores do Microsoft 365.
Selecione Ingressar agora.
Configure sua assinatura de conta de administrador.

Após a conclusão da assinatura, as seguintes informações serão exibidas:

Conta do Azure

Uma conta do Azure permite hospedar um aplicativo do Teams ou os recursos de back-end do seu aplicativo do Teams no Azure. Você pode fazer isso usando o Teams Toolkit no Visual Studio Code. Você deve ter uma assinatura do Azure nos seguintes cenários:

Se você já tiver um aplicativo existente em um provedor de nuvem diferente do Azure e quiser integrar o aplicativo na plataforma do Teams.
Se você quiser hospedar os recursos de back-end para seu aplicativo usando outro provedor de nuvem ou em seus próprios servidores, se eles estiverem disponíveis no domínio público.

Observação

Você pode usar a conta do Azure para provisionar o recurso do Azure para hospedar seu aplicativo do Teams. Você pode criar uma conta gratuita caso não tenha nenhuma. Se você não usar o Teams Toolkit para provisionar e implantar, a conta do Azure não será necessária.

Conta de administrador do site de coleção do SharePoint

Ao criar o aplicativo Teams usando o ambiente SPFx, você deve ter uma conta de administrador do site de coleção do SharePoint. Ele é necessário para implantar e hospedar seu aplicativo no site do SharePoint. Se você estiver usando um locatário do programa de desenvolvedor do Microsoft 365, poderá usar a conta de administrador que você criou no momento.

Verificar a permissão de carregamento de aplicativo personalizado

Depois de criar o aplicativo, você deve carregar seu aplicativo no Teams sem distribuí-lo. Esse processo é conhecido como upload de aplicativo personalizado. Entre em sua conta do Microsoft 365 para exibir essa opção.

Você pode verificar se a permissão de carregamento do aplicativo está habilitada usando Visual Studio Code ou cliente do Teams.

Verificar a permissão de carregamento de aplicativo personalizado usando Visual Studio Code

Você pode usar esse método para verificar a permissão de carregamento de aplicativo personalizado somente depois de criar um projeto de aplicativo usando o Teams Toolkit. Se você ainda não criou um projeto de aplicativo, poderá verificar a permissão de carregamento de aplicativo personalizado usando o cliente do Teams.

Abra o Visual Studio Code.
Selecione Kit de Ferramentas do Teams na barra de atividades Visual Studio Code.

Observação

Se você não conseguir ver a opção, consulte instalar o Teams Toolkit para instalar a extensão do Teams Toolkit no Visual Studio Code.
Crie um novo projeto de aplicativo do Teams Toolkit ou abra um projeto de aplicativo existente.
Selecione Entrar no Microsoft 365 em CONTAS.
Verifique se você pode ver a opção Sideloading habilitada , conforme mostrado na imagem a seguir:

Verificar a permissão de carregamento de aplicativo personalizado usando o cliente do Teams

No cliente do Teams, selecione Aplicativos>Gerenciar seus aplicativos>Carregar um aplicativo.
Verifique se você pode ver a opção Carregar um aplicativo personalizado.

Habilitar o upload de aplicativo personalizado usando o centro de administração

Se a opção de carregamento de aplicativo personalizado não estiver visível na extensão do Teams Toolkit no Visual Studio Code ou se a opção de carregar um aplicativo personalizado não estiver disponível no Teams, isso indica que você não tem a permissão necessária para carregamento de aplicativo personalizado.

Você deve habilitar o upload de aplicativo personalizado no Teams:

Se você for um administrador de locatário, habilite a configuração de carregamento de aplicativo personalizado para seu locatário ou organização no centro de administração do Teams.
Se você não for um administrador de locatário, entre em contato com o administrador do locatário para habilitar o carregamento personalizado do aplicativo.

Se você tiver direitos de administrador, poderá habilitar o upload de aplicativo personalizado:

Acessar o Centro de administração do Microsoft 365 com suas credenciais de administrador.
Selecione o ícone >Teams.

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.
Entre no centro de administração do Microsoft Teams com suas credenciais de administrador.
Selecione o ícone >Políticas de instalaçãode aplicativos> do Teams.
Selecione Global (padrão em toda a organização).
Defina Carregar aplicativos personalizados como Ativado.
Selecione Salvar.

Observação

Pode levar até 24 horas para que o upload de aplicativo personalizado se torne ativo. Enquanto isso, você pode usar carregamento do seu locatário para testar seu aplicativo. Para carregar o arquivo do pacote .zip do aplicativo, consulte Carregar aplicativos personalizados.

Verifique se você tem a permissão de carregamento do aplicativo usando as etapas mencionadas na verificação da permissão de carregamento de aplicativo personalizado usando Visual Studio Code ou cliente do Teams.