Criar conectores do Teams
O conector do Microsoft Teams é o aplicativo de gerenciamento de tarefas de exemplo MVC (Model-View-Controller) e gerado usando o modelo de aplicativo Web ASP.NET. A maior parte do código está relacionada à configuração básica do MVC ou ao sistema de gerenciamento de tarefas. Você pode adicionar o conector existente para Grupos do Microsoft 365 ou criar um novo no Teams.
Tipos de códigos de conector
- ConnectorController.cs: configurar e salvar ações.
- TaskController.cs: Create e atualizar ações.
Principais recursos do conector do Microsoft Teams
- Simula o sistema de gerenciamento de tarefas real.
- Permite que os usuários criem e exibam tarefas.
- Gera conteúdo aleatoriamente.
- Simula a notificação a ser enviada ao canal do Microsoft Teams.
Este guia passo a passo ajuda você a criar e testar um conector no Microsoft Teams. Você verá a seguinte saída:
Pré-requisitos
Certifique-se de instalar as seguintes ferramentas e configurar seu ambiente de desenvolvimento:
| Instalar | Para usar... | |
|---|---|---|
| Microsoft Teams | Microsoft Teams para colaborar com todos com quem você trabalha por meio de aplicativos para chat, reuniões e chamadas em um só lugar. | |
| Visual Studio 2022 | Você pode instalar a versão corporativa no Visual Studio 2022 e instalar as cargas de trabalho ASP.NET e desenvolvimento da Web. Use a versão mais recente. | |
| SDK do .NET Core | Associações personalizadas para implantações de aplicativo de depuração local e Azure Functions. Use a versão mais recente ou instale a versão portátil. | |
| Túnel de desenvolvimento | Os recursos do aplicativo Teams (bots de conversa, extensões de mensagem e webhooks de entrada) precisam de conexões de entrada. Um túnel conecta seu sistema de desenvolvimento ao Teams. O túnel de desenvolvimento é uma ferramenta poderosa para abrir com segurança seu localhost para a Internet e controlar quem tem acesso. O túnel de desenvolvimento está disponível no Visual Studio 2022 versão 17.7.0 ou posterior. ou você também pode usar o ngrok como um túnel para conectar seu sistema de desenvolvimento ao Teams. Não é necessário para aplicativos que incluem apenas guias. Esse pacote é instalado no diretório do projeto (usando npm devDependencies). |
Observação
Depois de baixar o ngrok, inscreva-se e instale authtoken.
Configurar o ambiente local
Selecione Código.
No menu suspenso, selecione Abrir com o GitHub Desktop.
Selecione Clonar.
Habilitar a visualização do desenvolvedor
Habilite o carregamento de aplicativos no console de administração do seu locatário.
Acessar o Centro de administração do Microsoft 365 com suas credenciais de administrador.
No painel esquerdo, selecione Mostrar Tudo.
Selecione Teams.
No painel esquerdo, selecione Aplicativos do Teams.
Selecione Políticas de instalação.
Selecione Global (padrão em toda a organização).
Ative o alternância Carregar aplicativos personalizados .
Selecione Salvar.
Seu locatário de teste agora pode permitir o upload de aplicativo personalizado.
Dica
O upload de aplicativo personalizado leva algum tempo para se tornar ativo.
Acesse o Microsoft Teams.
No canto superior direito do Teams, selecione ....
Selecione Sobre>Visualização do desenvolvedor.
Selecione Alternar para visualização do desenvolvedor.
Configurar seu conector
Abra TeamsToDoAppconnector.sln no Visual Studio do repositório clonado.
Create um túnel
Abra o Visual Studio.
Selecione Create um novo projeto.
Na caixa de pesquisa, insira ASP.NET. Nos resultados da pesquisa, selecione ASP.NET Core Aplicativo Web.
Selecione Avançar.
Insira o nome do projeto e selecione Avançar.
Selecione Criar.
Uma janela de visão geral é exibida.
Na lista suspensa de depuração, selecione Túneis de Desenvolvimento (nenhum túnel ativo)>Create um túnel....
Uma janela pop-up será exibida.
Atualize os seguintes detalhes na janela pop-up:
- Conta: insira uma conta Microsoft ou GitHub.
- Nome: insira um nome para o túnel.
- Tipo de túnel: na lista suspensa, selecione Temporário.
- Acesso: Na lista suspensa, selecione Público.
Clique em OK.
Uma janela pop-up aparece mostrando que o túnel de desenvolvimento foi criado com êxito.
Clique em OK.
Você pode encontrar o túnel que você criou na lista suspensa de depuração da seguinte maneira:
Selecione F5 para executar o aplicativo no modo de depuração.
Se uma caixa de diálogo Aviso de Segurança for exibida, selecione Sim.
Uma janela pop-up será exibida.
Selecione Continuar.
A página inicial do túnel de desenvolvimento é aberta em uma nova janela do navegador e o túnel de desenvolvimento agora está ativo.
Vá para o Visual Studio, selecione Exibir > Saída.
No menu suspenso Do console de saída , selecione Túneis de Desenvolvimento.
O console de saída mostra a URL do túnel de desenvolvimento.
Selecione Novo Conector.
Insira os seguintes detalhes para registrar um novo conector:
- Nome do conector.
- Logotipo
- Descrição curta do aplicativo (10 palavras ou menos).
- Descrição detalhada do que seu Conector faz (3 a 5 frases).
- Site da empresa.
- Página de configuração do conector como
https://[BASE_URI]/connector/setup. - Defina domínios válidos como
https>//[Base URI]. - Selecione Sim para habilitar a ação em cartões conectores.
- Defina a URL de Ações como
https://[BASE_URI]/Task/Update. - Selecione Aceito os termos e condições do Contrato de Desenvolvedor de Aplicativos.
- Selecione Salvar.
Você registrou com êxito um novo conector. A janela é exibida com a ID do conector registrado.
Dica
Salve a ID do Conector para referência futura.
Abra o arquivo TeamsToDoAppConnector.csproj do repositório clonado.
No repositório clonado, vá para ocsharpde exemplos do Microsoft-Teams-Samples>>connector-todo-notification>.
Abra o arquivo appsettings.json no Visual Studio e faça as atualizações a seguir.
- Substitua o
BASE_URLporngork URLoudev tunnel URL. - Substitua
CONNECTOR_IDpela ID do conector criada.
- Substitua o
No repositório clonado, acesse Exemplos do Microsoft-Teams-Samples>>connector-todo-notification>csharp>TeamsAppPackages.
Abra o arquivo manifest.json no Visual Studio e faça as seguintes alterações:
Substitua
CONNECTOR_IDpela ID do conector criada.Substitua
VALID-DOMAINpara o domínio do túnel de desenvolvimento or ngrok, excluindo https://.
Pressione F5 para executar o projeto. Uma página da Web é aberta.
Conector de teste no Microsoft Teams
Create um arquivo .zip com os seguintes arquivos presentes na pasta Manifesto:
manifest.json
outline-icon.png
color-icon.png
Acesse o Microsoft Teams.
No painel esquerdo, selecione o ícone Aplicativos .
Selecione Gerenciar seus aplicativos.
Selecione Carregar um aplicativo.
Procure a opção para Carregar um aplicativo personalizado.
Selecione o arquivo .zip que você criou na pasta Manifesto e selecione Abrir.
Selecione Adicionar a uma equipe.
Selecione o nome da equipe ou do canal na lista.
Selecione Configurar um conector.
No painel esquerdo, pesquise o conector do Teams ToDo na barra de pesquisa e selecione Configurar.
Selecione Criado ou Atualizado na página de registro e selecione Salvar.
Após a configuração, você pode ver a notificação no canal com link para o Portal do Gerenciador de Tarefas.
Acesse Portal do Gerenciador de Tarefas.
Selecione Create Novo.
Insira os novos detalhes da tarefa:
- Título
- Descrição
- Atribuir a
Selecione Salvar.
A mensagem cartão é exibida no canal do Teams registrado.
Dica
Você pode experimentar os botões acionáveis disponíveis no cartão de mensagem.
Desafio completo
Você veio com algo assim?
Parabéns!
Você concluiu o tutorial para começar a usar os conectores do Microsoft Teams!
Tem algum problema com essa seção? Se tiver, envie seus comentários para que possamos melhorar esta seção.
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de