Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Antes de criar seu projeto de aplicativo do Microsoft Teams, verifique se os pré-requisitos estão em vigor. Você deve:
- Instale as ferramentas necessárias para criar seu aplicativo do Teams
- Preparar Contas para criar seu aplicativo do Teams
- Verificar a permissão de upload de aplicativo personalizado
Instale as ferramentas necessárias para criar seu aplicativo do Teams
Verifique se as seguintes ferramentas estão instaladas no dispositivo em que você criará seu projeto de aplicativo antes de começar a criar seu aplicativo do Teams:
| Ferramentas | Objetivo | Para tipo de ambiente | |
|---|---|---|---|
| Required | |||
| Microsoft 365 Agents Toolkit (anteriormente conhecido como Teams Toolkit) | Uma extensão do Microsoft Visual Studio que cria uma estrutura de projeto para seu aplicativo. Use a versão mais recente. | C# e Blazor | |
| Microsoft Teams | Colabore com todos com quem você trabalha por meio de aplicativos para chat, reuniões e chamadas - tudo em um só lugar. | C# e Blazor | |
| Microsoft Edge (recomendado) ou Google Chrome | Um navegador com ferramentas de desenvolvedor. | C# e Blazor | |
| Opcional | |||
| Carga de trabalho de desenvolvimento do Azure para Visual Studio e CLI do Azure | Acesse dados armazenados ou implante um back-end baseado em nuvem para seu aplicativo do Teams no Azure. | C# e Blazor | |
| Microsoft Graph Explorer | Uma ferramenta baseada em navegador que permite executar uma consulta de dados do Microsoft Graph. | C# e Blazor | |
| Portal do Desenvolvedor do Teams | Um portal baseado na Web para configurar, gerenciar e publicar seu aplicativo do Teams, inclusive para sua organização ou para a Microsoft Teams Store. | C# e Blazor |
É recomendável que você marque o Microsoft Graph Explorer para saber mais sobre os serviços do Microsoft Graph. Essa ferramenta baseada em navegador permite que você execute uma consulta e acesse a API do Graph.
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 | Para usar | Para tipo de ambiente |
|---|---|---|
| Conta do Microsoft 365 com uma assinatura válida | Conta de desenvolvedor do Teams ao desenvolver 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. |
Programa para desenvolvedores do Microsoft 365
Observação
Para criar aplicativos do Teams, você deve ter uma conta corporativa ou escolar do Microsoft 365. A conta pessoal do Microsoft 365 não pode ser usada.
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 do Microsoft 365 E5 por meio do Programa de Desenvolvedor 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 adquirir 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 da Microsoft de nível empresarial de pequeno, médio e grande porte. Os serviços incluem o Azure, o Microsoft Intune e o Microsoft 365.
Quando você se inscreve em um desses serviços como uma organização, um diretório baseado em nuvem é provisionado automaticamente no Microsoft Entra ID para representar sua organização.
Crie uma conta de desenvolvedor gratuita do Microsoft 365
Para criar uma conta de desenvolvedor gratuita do Microsoft 365:
Selecione Ingressar agora.
Configure sua assinatura de conta de administrador.
Após a conclusão da assinatura, as seguintes informações são exibidas:
Conta do Azure
Uma conta do Azure permite que você hospede um aplicativo do Teams ou os recursos de back-end do seu aplicativo do Teams no Azure. Você pode fazer isso usando o Agents Toolkit no Visual Studio. 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 do 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 recursos 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 Kit de Ferramentas de Agentes para provisionar e implantar, a conta do Azure não será necessária.
Verificar a permissão de upload 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 na sua conta do Microsoft 365 para ver essa opção.
Você pode verificar se a permissão de upload do aplicativo personalizado está habilitada usando o cliente do Teams.
Verificar a permissão de upload 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 , como você pode ver na imagem a seguir:
Habilitar o upload de aplicativo personalizado usando o centro de administração
Se a opção de upload de aplicativo personalizado não estiver visível na extensão do Kit de Ferramentas de Agentes 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 o upload de aplicativo personalizado.
Você deve habilitar o upload de aplicativo personalizado para seu aplicativo no Teams:
- Se você for um administrador do Teams, habilite a configuração de upload de aplicativo personalizado para seu locatário ou organização no Centro de administração do Teams.
- Se você não for um administrador do Teams, entre em contato com o administrador para habilitar o upload 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 configuração de
aplicativos >do Teams.
Selecione Global (padrão em toda a organização).
Ative a alternância Carregar aplicativos personalizados .
Selecione Salvar.
Observação
Pode levar até 24 horas para que o upload do 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 upload de aplicativo personalizado usando as etapas mencionadas em verificar a permissão de upload de aplicativo personalizado usando o cliente do Visual Studio Code ou do Teams.
Confira também
Colaborar conosco no GitHub
A fonte deste conteúdo pode ser encontrada no GitHub, onde você também pode criar e revisar problemas e solicitações de pull. Para obter mais informações, confira o nosso guia para colaboradores.