Enviar notificação do feed de atividades
A notificação do feed de atividades do Microsoft Teams ajuda os usuários a avaliar itens que exigem atenção notificando as alterações. Para estender a funcionalidade de notificação do feed de atividades para seu aplicativo, use as APIs de notificação do feed de atividades no Microsoft Graph.
Os principais recursos da transmissão do feed de atividades são:
- Fornece experiência aprimorada.
- Mantém os usuários atualizados.
- Transmite mensagem para todos os membros.
- Exibe a notificação do feed de atividades.
- Transmite detalhes disponíveis para membros.
Este guia passo a passo ajuda você a transmitir mensagens e notificar todos os membros de uma organização usando a notificação do feed de atividades. Você pode ver a seguinte saída:
Pré-requisitos
Certifique-se de instalar as seguintes ferramentas e configurar seu ambiente de desenvolvimento:
Instalar | Para usar... | |
---|---|---|
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 versão 3.1 | 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.
Verifique se você tem as seguintes contas e configure seu ambiente de desenvolvimento:
- Conta da Microsoft .
- O aplicativo Teams deve ser instalado para o destinatário, pessoalmente ou em uma equipe ou chat.
- A ID do Locatário para enviar e receber notificações deve corresponder.
Configurar seu locatário de desenvolvimento do Teams
Um locatário é como um espaço ou um contêiner em que você conversa, compartilha arquivos e executa reuniões para sua organização no Teams. Você também pode carregar e testar o aplicativo personalizado.
Verificar a opção de carregamento de aplicativo personalizado
Depois de criar o aplicativo, você deve carregar seu aplicativo no Teams sem distribuí-lo. A função é conhecida como upload de aplicativo personalizado. Entre em sua conta do Microsoft 365 para exibir essa opção.
Observação
O upload personalizado do aplicativo é necessário para visualizar e testar aplicativos no ambiente local do Teams. Habilite o upload de aplicativo personalizado para visualizar e testar seu aplicativo no Teams localmente.
Você já tem um locatário e tem acesso ao administrador? Vamos marcar se você realmente fizer isso!
Para verificar aplicativos de carregamento personalizados no Teams:
No cliente do Teams, selecione o ícone Aplicativos .
Selecione Gerenciar seus aplicativos.
Selecione Carregar um aplicativo.
Procure a opção para Carregar um aplicativo personalizado.
Observação
Entre em contato com o administrador do Teams, se você não puder carregar um aplicativo personalizado.
Create um locatário gratuito do desenvolvedor do Teams (opcional)
Se você não tiver uma conta de desenvolvedor do Teams, poderá obtê-la gratuitamente. Ingresse no programa de desenvolvedor do Microsoft 365!
Selecione Ingressar Agora e siga as instruções na tela.
Selecione Configurar a assinatura do E5 na tela de boas-vindas.
Configure uma conta de administrador. Depois de concluir, a tela a seguir será exibida.
Entre no Teams usando a nova conta de administrador. Agora você pode selecionar Carregar um aplicativo personalizado.
Configurar o ambiente local
Selecione Código.
No menu suspenso, selecione Abrir com o GitHub Desktop.
Selecione Clonar.
Registrar o SSO do Teams Auth com Microsoft Entra ID
As etapas a seguir ajudam você a criar e registrar o SSO de autenticação do Teams em portal do Azure:
- Create e registre um novo aplicativo em Registros de aplicativo.
- Use o ngrok para criar um túnel para os pontos de extremidade do servidor Web.
Adicionar registro de aplicativo
Acesse o portal do Azure.
Selecione Registros de aplicativos.
Selecione + Novo registro.
Insira o nome do seu aplicativo.
Selecione Contas em qualquer diretório organizacional (Qualquer locatário Microsoft Entra ID – Multilocatário).
Selecione Registrar.
Seu aplicativo está registrado em Microsoft Entra ID. A página de visão geral do aplicativo é exibida.
Observação
Salve a ID do aplicativo da ID do Aplicativo (cliente) e da ID do Diretório (locatário) para uso adicional.
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.
Adicionar URI da ID do Aplicativo
No painel esquerdo, em Gerenciar, selecione Expor uma API.
Ao lado do URI da ID do Aplicativo, selecione Adicionar.
Atualize o URI da ID do
api://your-devtunnel-domain/botid-{AppID}
Aplicativo no formato ouapi://your-ngrok-domain/botid-{AppID}
e selecione Salvar.A imagem a seguir mostra o nome de domínio:
Observação
Se você estiver usando um serviço de túnel, como o ngrok, certifique-se de atualizar o valor sempre que seu subdomínio ngrok for atualizado. Por exemplo, api://f631****.ngrok.io/c4e88a5d-e3d4-47f4-accb-0ef9de3bce8a
, em que f631****.ngrok.io
é o novo nome de subdomínio ngrok.
Adicionar um escopo
No painel esquerdo, em Gerenciar, selecione Expor uma API.
Selecione + Adicionar um escopo.
Insira access_as_user como o nome escopo.
Em Quem pode consentir?, selecione Administradores e usuários.
Atualize os valores para o restante dos campos da seguinte maneira:
O Enter Teams pode acessar o perfil do usuário como Administração nome de exibição de consentimento.
Insira Permitir que o Teams chame as APIs Web do aplicativo como o usuário atual como Administração descrição de consentimento.
O Enter Teams pode acessar o perfil do usuário e fazer solicitações em nome do usuário como nome de exibição de consentimento do usuário.
Insira Habilitar o Teams para chamar as APIs deste aplicativo com os mesmos direitos que o usuário que adescrição do consentimento do usuário.
Verifique se o Estado está definido como Habilitado.
Selecione Adicionar escopo.
A imagem a seguir mostra os campos e os valores:
Observação
O nome escopo deve corresponder ao URI da ID do Aplicativo com
/access_as_user
acrescentado no final.
Adicionar aplicativo cliente
No painel esquerdo, em Gerenciar, selecione Expor uma API.
Em Aplicativos cliente autorizados, identifique os aplicativos que você deseja autorizar para o aplicativo Web do aplicativo.
Selecione + Adicionar um aplicativo cliente.
Adicione o aplicativo Web do Teams para dispositivos móveis ou desktop e teams.
Para o teams móvel ou área de trabalho: insira a ID do cliente como
1fec8e78-bce4-4aaf-ab1b-5451cc387264
.Para o Teams Web: insira a ID do cliente como
5e3ce6c0-2b1f-4285-8d4b-75ee78787346
.
Selecione a caixa de seleção Escopos autorizados .
Selecione Adicionar aplicativo.
A imagem a seguir exibe a ID do cliente:
Adicionar permissão de API
No painel esquerdo, em Gerenciar, selecione Permissões de 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
Usuário. A leitura está habilitada por padrã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.
Certifique-se de conceder o consentimento do administrador para as permissões necessárias.
Certifique-se de conceder o consentimento do administrador para as permissões necessárias.
Observação
- Se um aplicativo não tiver o consentimento do administrador de TI, os usuários deverão fornecer consentimento na primeira vez que usarem um aplicativo.
- Os usuários precisam consentir com as permissões de API somente se o aplicativo Microsoft Entra estiver registrado em um locatário diferente.
Adicionar uma autenticação da Web
No painel esquerdo, em Gerenciar, selecione Autenticação.
Selecione Adicionar umaplicativo de página única da plataforma>.
Insira o URI de redirecionamento para seu aplicativo acrescentando
auth-end
ao nome de domínio totalmente qualificado. Por exemplo:https://your-devtunnel-domain/auth-end
ouhttps://your-ngrok-domain/auth-end
.Em Concessão implícita e fluxos híbridos, selecione as caixas de seleção Tokens de acesso e tokens de ID .
Selecione Configurar.
Na Web, selecione Adicionar URI.
Digite
https://token.botframework.com/.auth/web/redirect
.Selecione Salvar.
Criar um segredo do cliente
No painel esquerdo, em Gerenciar, selecione Certificados & segredos.
Em Segredos do cliente, selecione + Novo segredo do cliente.
A janela Adicionar um segredo do cliente é exibida.
Insira Descrição.
Selecione Adicionar.
Em Valor, selecione Copiar para área de transferência para salvar o valor de segredo do cliente para uso adicional.
Configurar configurações de aplicativo
Vá para appsettings.json arquivo no repositório clonado.
Abra o arquivo appsettings.json na versão mais recente do Visual Studio e atualize as seguintes informações:
Defina
"MicrosoftAppId"
como a ID do aplicativo Microsoft do bot.Defina
"TenantID"
como ID do Diretório (locatário).Defina
"MicrosoftAppPassword"
como o valor da ID secreta do cliente do bot.Defina
"BaseUrl"
como o[WebAppDomainName]
.
Configurar o arquivo de manifesto
Vá para o arquivo manifest.json no repositório clonado.
Abra o arquivo 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>>
pela ID do aplicativo Microsoft do bot.Substitua todas as ocorrências de pelo nome de
<<Base_URL>>
domínio totalmente qualificado.Defina
validDomains
como[WebAppDomainName]
.
Compilar e executar o serviço
Abra o Visual Studio.
Vá para Arquivo>Abrir>Projeto/Solução....
Selecione o arquivo ActivityFeedBroadcast.sln na pasta csharp .
Selecione Abrir.
Pressione F5 para executar o projeto.
Selecione Sim se a caixa de diálogo a seguir for exibida:
Uma página da Web é aberta com uma mensagem, seu bot está pronto!
Adicionar aplicativo de transmissão de feed de atividades ao Teams
No repositório clonado, acesse graph-activity-feed-broadcast>csharp>ActivityFeedBroadcast>AppManifest.
Create um arquivo .zip com os seguintes arquivos presentes na pasta AppManifest:
manifest.json
outline.png
color.png
No cliente do Teams, selecione o ícone Aplicativos .
Selecione Gerenciar seus aplicativos.
Selecione Enviar um aplicativo para sua organização.
Selecione Abrir para carregar o arquivo .zip que você criou na pasta AppManifest .
Selecione Adicionar.
Interagir com o aplicativo no Teams
Vamos interagir com o aplicativo no Teams!
O BroadcastTab exibe o título da mensagem e a descrição da mensagem.
Insira o título e a descrição da mensagem**.
Selecione Enviar mensagem.
A Mensagem transmitida com êxito é exibida.
A notificação do feed de atividades é exibida na guia Atividade do destinatário com a mesma ID do Locatário.
Os detalhes da mensagem aparecem na seleção da mensagem.
Desafio completo
Você veio com algo assim?
Parabéns!
Você concluiu o tutorial para começar a usar o aplicativo de transmissã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.
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários