Criar conectores do Teams
Importante
Os Conectores do Microsoft 365 (anteriormente denominados conectores Office 365) estão prestes a descontinuar e a criação de novos Conectores do Microsoft 365 será bloqueada em breve. Para obter mais informações sobre a agenda e como a aplicação Fluxos de Trabalho fornece uma experiência mais flexível e segura, veja Descontinuação dos conectores do Microsoft 365 no Microsoft Teams.
Como pode criar um webhook no Teams?
Para publicar automaticamente num chat ou canal quando um pedido de webhook é recebido, utilize os modelos de fluxo de trabalho predefinidos ou crie um fluxo de trabalho do zero com o acionador Quando um pedido de webhook do Teams é recebido . Para obter mais informações, consulte Publicar um fluxo de trabalho quando um pedido de webhook é recebido no Microsoft Teams..
Para obter mais informações sobre o acionador Quando um pedido de webhook do Teams é recebido , consulte Microsoft Teams – Webhook.
Se já tiver criado Office 365 Conectores:
Criar um conector do Power Automate: o Power Automate melhora as aplicações de Fluxos de Trabalho amplamente utilizadas no Teams. É a abordagem dimensionável e segura para transmitir dados através de programação para dentro e para fora do Teams. Se adotar este método, pode criar modelos de fluxo de trabalho para publicar alertas do seu produto em canais do Teams. Esta abordagem simplifica a adoção pelo utilizador do novo método. Para obter mais informações, veja Power Automate para programadores empresariais, ISVs e parceiros.
Atualizar a sua aplicação Teams: pode melhorar a sua aplicação teams atual. Por exemplo, pode permitir que os utilizadores configurem mensagens proativas com base em eventos de acionador no seu sistema. Para obter mais informações, veja como os bots podem publicar em canais através de mensagens proativas.
Problemas conhecidos
- A aplicação de fluxos de trabalho não pode publicar em canais privados como um bot de fluxo. No entanto, pode publicar em nome de um utilizador.
- Os fluxos de trabalho suportam apenas Cartões Ajustáveis. Não suporta a mensagem mais antiga card formato que os Conectores Office 365 utilizam. Os fluxos de trabalho não suportam a utilização da mensagem card formato. Para obter mais informações, veja como converter mensagens de conector card formato em Cartão Ajustável.
- Os fluxos de trabalho não oferecem conectores de terceiros, como o DataDog e o Jenkins.
- Os fluxos de trabalho só podem ser criados no seu ambiente predefinido.
Limites
Os fluxos de trabalho estão ligados apenas a utilizadores específicos (referidos como proprietários do fluxo de trabalho) e não a uma equipa ou canal do Teams. Os fluxos de trabalho podem tornar-se fluxos órfãos na ausência de um proprietário se não forem atribuídos coproprietários. Para manter a continuidade no processo de negócio automatizado pelo fluxo, os administradores podem adicionar um ou mais coproprietários e conceder-lhes controlo total sobre o fluxo de trabalho. Também podem adicionar autenticação para ligações, se existirem, e ativar o fluxo se este tiver sido desativado. Para obter mais informações, veja Gerir fluxos órfãos.
O conector do Microsoft Teams é uma aplicação de gestão de tarefas de exemplo model-View-Controller (MVC) e gerada com o modelo de aplicação Web ASP.NET. A maior parte do código está relacionada com a configuração básica do MVC ou o sistema de gestão de tarefas. 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 guardar ações.
- TaskController.cs: criar e atualizar ações.
Principais funcionalidades do conector do Microsoft Teams
- Simula o sistema de gestão de tarefas real.
- Permite que os utilizadores criem e vejam tarefas.
- Gera conteúdo aleatoriamente.
- Simula a notificação a enviar para o canal do Microsoft Teams.
Este guia passo a passo ajuda-o a criar e testar um conector no Microsoft Teams. Verá o seguinte resultado:
Pré-requisitos
Certifique-se de que instala as seguintes ferramentas e configura o seu ambiente de desenvolvimento:
Instalar | Para usar... | |
---|---|---|
Microsoft Teams | Microsoft Teams para colaborar com todas as pessoas com quem trabalha através de aplicações para chat, reuniões e chamadas num único local. | |
Visual Studio 2022 | Pode instalar a versão empresarial no Visual Studio 2022 e instalar as cargas de trabalho de desenvolvimento web e ASP.NET. Utilize a versão mais recente. | |
SDK .NET Core | Enlaces personalizados para depuração local e implementações de aplicações Azure Functions. Utilize a versão mais recente ou instale a versão portátil. | |
Túnel de desenvolvimento | As funcionalidades da aplicação Teams (bots de conversação, extensões de mensagens e webhooks recebidos) precisam de ligações de entrada. Um túnel liga o seu sistema de desenvolvimento ao Teams. O túnel Dev é uma ferramenta avançada para abrir de forma segura o seu localhost na Internet e controlar quem tem acesso. O túnel Dev está disponível no Visual Studio 2022 versão 17.7.0 ou posterior. ou também pode utilizar o ngrok como um túnel para ligar o seu sistema de desenvolvimento ao Teams. Não é necessário para aplicações que incluam apenas separadores. Este pacote é instalado no diretório do projeto (com o npm devDependencies ). |
Observação
Depois de transferir o ngrok, inscreva-se e instale o authtoken.
Configurar o ambiente local
Abra Microsoft-Teams-Samples.
Selecione Código.
No menu pendente, selecione Abrir com o GitHub Desktop.
Selecione Clonar.
Habilitar a visualização do desenvolvedor
Ative o carregamento de aplicações na consola de administração do seu inquilino.
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 Aplicações do Teams.
Selecione Políticas de configuração.
Selecione Global (predefinição em toda a organização).
Ative o botão de alternar Carregar aplicações personalizadas .
Selecione Salvar.
O inquilino de teste pode agora permitir o carregamento de aplicações personalizadas.
Dica
O carregamento de aplicações personalizadas demora algum tempo a tornar-se ativo.
Aceda ao Microsoft Teams.
No canto superior direito do Teams, selecione ....
Selecione Sobre>Visualização do desenvolvedor.
Selecione Mudar para pré-visualização do programador.
Configurar o conector
Abra TeamsToDoAppconnector.sln no Visual Studio a partir do repositório clonado.
Criar um túnel
Abra o Visual Studio.
Selecione Criar um novo projeto.
Na caixa de pesquisa, introduza ASP.NET. Nos resultados da pesquisa, selecione ASP.NET Core Aplicação Web.
Selecione Avançar.
Introduza Nome do projeto e selecione Seguinte.
Selecione Criar.
É apresentada uma janela de descrição geral.
Na lista pendente de depuração, selecione Túneis de Desenvolvimento (sem túnel ativo)>Criar um Túnel....
Uma janela pop-up será exibida.
Atualize os seguintes detalhes na janela de pop-up:
- Conta: introduza uma conta Microsoft ou GitHub.
- Nome: introduza um nome para o túnel.
- Tipo de Túnel: na lista pendente, selecione Temporário.
- Acesso: na lista pendente, selecione Público.
Selecione OK.
É apresentada uma janela de pop-up que mostra que o túnel dev foi criado com êxito.
Selecione OK.
Pode encontrar o túnel que criou na lista pendente de depuração da seguinte forma:
Selecione F5 para executar a aplicação no modo de depuração.
Se for apresentada uma caixa de diálogo Aviso de Segurança , selecione Sim.
Uma janela pop-up será exibida.
Selecione Continuar.
A home page do túnel dev é aberta numa nova janela do browser e o túnel dev está agora ativo.
Aceda ao Visual Studio e selecione Ver > Saída.
No menu pendente Consola de saída , selecione Túneis Dev.
A consola Output (Saída ) mostra o URL do túnel dev.
Aceda ao Portal do Programador do Conector.
Selecione Novo Conector.
Introduza os seguintes detalhes para registar um novo conector:
- Nome do conector.
- Logótipo
- Breve descrição da sua aplicação (10 palavras ou menos).
- Descrição detalhada do que o 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 ativar a ação nos cartões do Conector.
- Defina o URL de Ações como
https://[BASE_URI]/Task/Update
. - Selecione Aceito os termos e condições do Contrato de Programador de Aplicações.
- Selecione Salvar.
Registou com êxito um novo conector. A janela é apresentada com o ID do conector registado.
Dica
Guarde o ID do Conector para referência futura.
Abra o ficheiro TeamsToDoAppConnector.csproj a partir do repositório clonado.
No seu repositório clonado, aceda a Microsoft-Teams-Samples samples>>connector-todo-notification>csharp.
Abra o ficheiro appsettings.json no Visual Studio e efetue as seguintes atualizações.
- Substitua por
BASE_URL
ngork URL
oudev tunnel URL
. - Substitua
CONNECTOR_ID
pelo ID do conector criado.
- Substitua por
No seu repositório clonado, aceda a Microsoft-Teams-Samples samples>>connector-todo-notification>csharp>TeamsAppPackages.
Abra o ficheiro manifest.json no Visual Studio e faça as seguintes alterações:
Substitua
CONNECTOR_ID
pelo ID do conector criado.Substitua pelo
VALID-DOMAIN
seu domínio de túnel ngrok OR dev, excluindo https://.
Pressione F5 para executar o projeto. É aberta uma página Web.
Testar o conector no Microsoft Teams
Crie um ficheiro .zip com os seguintes ficheiros que estão presentes na pasta Manifesto :
manifest.json
outline-icon.png
color-icon.png
Aceda ao Microsoft Teams.
No painel esquerdo, selecione o ícone Aplicações .
Selecione Gerenciar seus aplicativos.
Selecione Carregar uma aplicação.
Procure a opção Carregar uma aplicação personalizada.
Selecione o ficheiro .zip que criou na pasta Manifesto e selecione Abrir.
Selecione Adicionar.
Procure e selecione o canal necessário ou selecione um canal na lista e percorra a caixa de diálogo para selecionar Ir.
No painel esquerdo, procure no conector ToDo do Teams na barra de pesquisa e selecione Configurar.
Selecione Criado ou Atualizado na página de registo e selecione Guardar.
Após a configuração, pode ver a notificação no canal com ligação para o Portal do Gestor de Tarefas.
Aceda ao Portal do Gestor de Tarefas.
Selecione Criar Novo.
Introduza os detalhes da nova tarefa:
- Título
- Descrição
- Atribuir a
Selecione Salvar.
A mensagem card é apresentada no canal do Teams registado.
Dica
Pode experimentar os botões acionáveis disponíveis na mensagem card.
Desafio completo
Encontrou algo assim?
Parabéns!
Concluiu o tutorial para começar a utilizar 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.