Enviar notificação do feed de atividades
A notificação do feed de atividades do Microsoft Teams ajuda os utilizadores a avaliar itens que necessitam de atenção ao notificar as alterações. Para expandir a funcionalidade de notificação do feed de atividades para a sua aplicação, utilize as APIs de notificação do feed de atividades no Microsoft Graph.
As principais funcionalidades da difusão do feed de atividades são:
- Proporciona uma experiência melhorada.
- Mantém os utilizadores atualizados.
- Difusão de mensagem para todos os membros.
- Apresenta a notificação do feed de atividades.
- Detalhes de transmissões disponíveis para membros.
Este guia passo a passo ajuda-o a difundir mensagens e a notificar todos os membros de uma organização através da notificação do feed de atividades. Pode ver o seguinte resultado:
Pré-requisitos
Certifique-se de que instala as seguintes ferramentas e configura o seu ambiente de desenvolvimento:
| Instalar | Para usar... | |
|---|---|---|
| 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. | |
| .NET Core SDK versão 3.1 | Enlaces personalizados para depuração local e implementações de aplicações das Funções do Azure. 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. 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 npm devDependencies). |
Observação
Depois de transferir o ngrok, inscreva-se e instale o authtoken.
Certifique-se de que tem as seguintes contas e configure o seu ambiente de desenvolvimento:
- Conta Microsoft .
- A aplicação Teams tem de ser instalada para o destinatário, quer pessoalmente, quer numa equipa ou chat.
- O ID do Inquilino para enviar e receber notificações tem de corresponder.
Configurar o seu inquilino de desenvolvimento do Teams
Um inquilino é como um espaço ou um contentor onde conversa, partilha ficheiros e executa reuniões para a sua organização no Teams. Também pode carregar e testar a aplicação personalizada.
Verificar a opção de carregamento de aplicações personalizadas
Depois de criar o aplicativo, você deve carregar seu aplicativo no Teams sem distribuí-lo. A função é conhecida como carregamento de aplicações personalizadas. Inicie sessão na sua conta do Microsoft 365 para ver esta opção.
Observação
O carregamento de aplicações personalizadas é necessário para pré-visualizar e testar aplicações no ambiente local do Teams. Ative o carregamento de aplicações personalizadas para pré-visualizar e testar a sua aplicação no Teams localmente.
Já tem um inquilino e tem acesso de administrador? Vamos verificar se tem mesmo!
Para verificar as aplicações de carregamento personalizadas no Teams:
No cliente do Teams, selecione o ícone Aplicações .
Selecione Gerenciar seus aplicativos.
Selecione Carregar uma aplicação.
Procure a opção Carregar uma aplicação personalizada.
Observação
Contacte o administrador do Teams se não conseguir carregar uma aplicação personalizada.
Criar um inquilino gratuito para programadores do Teams (opcional)
Se não tiver uma conta de programador do Teams, pode obtê-la gratuitamente. Adira ao programa de programador do Microsoft 365!
Selecione Aderir Agora e siga as instruções apresentadas no ecrã.
Selecione Configurar a subscrição E5 no ecrã de boas-vindas.
Configurar uma conta de administrador. Depois de terminar, é apresentado o ecrã seguinte.
Inicie sessão no Teams com a nova conta de administrador. Agora, pode selecionar Carregar uma aplicação personalizada.
Configurar o ambiente local
Abra Microsoft-Teams-Samples.
Selecione Código.
No menu pendente, selecione Abrir com o GitHub Desktop.
Selecione Clonar.
Registar o SSO de Autenticação do Teams com o Microsoft Entra ID
Os passos seguintes ajudam-no a criar e registar o SSO de autenticação do Teams no portal do Azure:
- Crie e registe uma nova aplicação em Registos de aplicações.
- Utilize o ngrok para criar um túnel para os pontos finais do servidor Web.
Adicionar Registo de aplicações
Acesse o portal do Azure.
Selecione Registros de aplicativos.
Selecione + Novo registo.
Introduza o nome da sua aplicação.
Selecione Contas em qualquer diretório organizacional (Qualquer inquilino do Microsoft Entra ID – Multi-inquilino).
Selecione Registrar.
A sua aplicação está registada no Microsoft Entra ID. É apresentada a página de descrição geral da aplicação.
Observação
Guarde o ID da aplicação do ID da Aplicação (cliente) e do ID do Diretório (inquilino) para utilização adicional.
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 Web App.
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.
Adicionar URI do ID da Aplicação
No painel esquerdo, em Gerir, selecione Expor uma API.
Junto a URI do ID da Aplicação, selecione Adicionar.
Atualize o URI do ID da Aplicação no
api://your-devtunnel-domain/botid-{AppID}formato ouapi://your-ngrok-domain/botid-{AppID}e selecione Guardar.
A imagem seguinte mostra o nome de domínio:
Observação
Se estiver a utilizar um serviço de túnel, como o ngrok, certifique-se de que atualiza o valor sempre que o seu subdomínio ngrok for atualizado. Por exemplo, api://f631****.ngrok.io/c4e88a5d-e3d4-47f4-accb-0ef9de3bce8a, em f631****.ngrok.io que é o novo nome do subdomínio ngrok.
Adicionar um âmbito
No painel esquerdo, em Gerir, selecione Expor uma API.
Selecione + Adicionar um âmbito.
Introduza access_as_user como o Nome do âmbito.
Em Quem pode consentir?, selecione Administradores e utilizadores.
Atualize os valores dos restantes campos da seguinte forma:
Introduza O Teams pode aceder ao perfil do utilizador como Nome a apresentar do consentimento do administrador.
Introduza Permite que o Teams chame as APIs Web da aplicação como o utilizador atual como Descrição do consentimento do administrador.
Introduza O Teams pode aceder ao perfil de utilizador e fazer pedidos em nome do utilizador como Nome a apresentar do consentimento do utilizador.
Introduza Ativar o Teams para chamar as APIs desta aplicação com os mesmos direitos que o utilizador que aDescrição do consentimento do utilizador.
Verifique se o Estado está definido como Habilitado.
Selecione Adicionar escopo.
A imagem seguinte mostra os campos e os valores:
Observação
O Nome do âmbito tem de corresponder ao URI do ID da Aplicação com
/access_as_useracrescentado no final.
Adicionar aplicação cliente
No painel esquerdo, em Gerir, selecione Expor uma API.
Em Aplicações cliente autorizadas, identifique as aplicações que pretende autorizar para a aplicação Web da sua aplicação.
Selecione + Adicionar uma aplicação cliente.
Adicione o Teams para dispositivos móveis ou de ambiente de trabalho e a aplicação Web do Teams.
Para dispositivos móveis ou de ambiente de trabalho do Teams: introduza o ID de Cliente como
1fec8e78-bce4-4aaf-ab1b-5451cc387264.
Para a Web do Teams: introduza o ID de Cliente como
5e3ce6c0-2b1f-4285-8d4b-75ee78787346.
Selecione a caixa de verificação Âmbitos autorizados .
Selecione Adicionar aplicativo.
A imagem seguinte apresenta o ID de Cliente:
Adicionar Permissão de API
No painel esquerdo, em Gerir, selecione Permissões da API.
Selecione + Adicionar uma permissão.
Selecione Microsoft Graph.
Selecione Permissões delegadas.
Selecione as seguintes permissões:
Directory.Read.All
Directory.ReadWrite.All
TeamsActivity.Send
TeamsAppInstallation.ReadForUser
TeamsAppInstallation.ReadWriteForUser
User.Read
Observação
Utilizador. A opção Ler está ativada por predefinição.
Selecione Adicionar permissões.
Selecione + Adicionar uma permissão.
Selecione Microsoft Graph.
Selecione Permissões de aplicativos.
Selecione as seguintes permissões:
- Directory.Read.All
- TeamsActivity.Send
- TeamsAppInstallation.ReadForUser.All
Selecione Adicionar permissões.
Confirme que concede o consentimento do administrador para as permissões necessárias.
Confirme que concede o consentimento do administrador para as permissões necessárias.
Observação
- Se não for concedido consentimento ao administrador de TI a uma aplicação, os utilizadores têm de dar consentimento na primeira vez que utilizarem uma aplicação.
- Os utilizadores só precisam de dar consentimento às permissões da API se a aplicação Microsoft Entra estiver registada num inquilino diferente.
Adicionar uma autenticação Web
No painel esquerdo, em Gerir, selecione Autenticação.
Selecione Adicionar umaaplicação de página únicade plataforma>.
Introduza o URI de redirecionamento para a sua aplicação ao acrescentar
auth-endao nome de domínio completamente qualificado. Por exemplo:https://your-devtunnel-domain/auth-endouhttps://your-ngrok-domain/auth-end.Em Concessão implícita e fluxos híbridos, selecione as caixas de verificação Tokens de acesso e tokens de ID .
Selecione Configurar.
Em Web, selecione Adicionar URI.
Digite
https://token.botframework.com/.auth/web/redirect.Selecione Salvar.
Criar um segredo do cliente
No painel esquerdo, em Gerir, selecione Certificados & segredos.
Em Segredos do cliente, selecione + Novo segredo do cliente.
É apresentada a janela Adicionar um segredo do cliente .
Introduza Descrição.
Selecione Adicionar.
Em Valor, selecione Copiar para a área de transferência para guardar o valor do segredo do cliente para utilização adicional.
Configurar as definições da aplicação
Aceda a appsettings.json ficheiro no repositório clonado.
Abra o ficheiro appsettings.json na versão mais recente do Visual Studio e atualize as seguintes informações:
Defina
"MicrosoftAppId"para o ID da Aplicação Microsoft do bot.Defina
"TenantID"como ID de Diretório (inquilino).Defina
"MicrosoftAppPassword"como o valor do ID do segredo do cliente do bot.Defina
"BaseUrl"como[WebAppDomainName].
Configurar o ficheiro de manifesto
Aceda ao ficheiro manifest.json no repositório clonado.
Abra o ficheiro manifest.json na versão mais recente do Visual Studio e faça as seguintes alterações:
Substitua todas as ocorrências de
<<Microsoft-App-ID>>pelo ID da Aplicação Microsoft do bot.Substitua todas as ocorrências de pelo seu nome de
<<Base_URL>>domínio completamente qualificado.Defina
validDomainscomo[WebAppDomainName].
Criar e executar o serviço
Abra o Visual Studio.
Aceda a Ficheiro>Abrir>Projeto/Solução....
Selecione o ficheiro ActivityFeedBroadcast.sln da pasta csharp .
Selecione Abrir.
Pressione F5 para executar o projeto.
Selecione Sim se a caixa de diálogo a seguir for exibida:
É aberta uma página Web com uma mensagem, O bot está pronto!
Adicionar a aplicação de transmissão do feed de atividades ao Teams
No seu repositório clonado, aceda a graph-activity-feed-broadcast>csharp>ActivityFeedBroadcast>AppManifest.
Crie um ficheiro .zip com os seguintes ficheiros que estão presentes na pasta AppManifest :
manifest.json
outline.png
color.png
No cliente do Teams, selecione o ícone Aplicações .
Selecione Gerenciar seus aplicativos.
Selecione Submeter uma aplicação para a sua organização.
Selecione Abrir para carregar o ficheiro .zip que criou na pasta AppManifest .
Selecione Adicionar.
Interagir com a aplicação no Teams
Vamos interagir com a aplicação no Teams!
O BroadcastTab apresenta o título da mensagem e a Descrição da mensagem.
Introduza o título e a descrição da mensagem**.
Selecione Enviar mensagem.
A Mensagem transmitida com êxito é apresentada com êxito.
A notificação do feed de atividades é apresentada no separador Atividade do destinatário com o mesmo ID de Inquilino.
Os detalhes da mensagem são apresentados ao selecionar a mensagem.
Desafio completo
Encontrou algo assim?
Parabéns!
Concluiu o tutorial para começar a utilizar a aplicação de difusão do feed de atividades !
Tem algum problema com essa seção? Se tiver, envie seus comentários para que possamos melhorar esta seção.