Bot de chamada e reunião do Teams
O bot de chamada e reunião do Microsoft Teams fornece funcionalidades básicas, como criar uma chamada, ingressar em uma chamada, transferir ou redirecionar uma chamada, ingressar em uma reunião agendada e convidar os participantes integrando as comunicações de nuvem API do Graph.
Os bots podem interagir com chamadas e reuniões do Teams usando voz, vídeo e compartilhamento de tela em tempo real. Os aplicativos do Teams podem interagir com usuários usando voz e vídeo para aprimorar sua experiência com APIs do Microsoft Graph para chamadas e reuniões online. Essas APIs permitem que você adicione os seguintes novos recursos:
- Use o IVR (Interactive Voice Response).
- Use o controle de chamada.
- Forneça acesso a fluxos de áudio e vídeo em tempo real, incluindo compartilhamento de área de trabalho e aplicativo.
Create um bot e especifique informações e permissões adicionais para usar essas APIs do Graph em um aplicativo do Teams.
Este guia passo a passo ajuda você a configurar o bot de chamada e reunião do 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... | |
|---|---|---|
| Conta de desenvolvedor do Microsoft 365 | Acesso à conta do Teams com as permissões apropriadas para instalar um aplicativo. | |
| 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. | |
| Microsoft Teams | Microsoft Teams para colaborar com todos com quem você trabalha por meio de aplicativos para chat, reuniões e chamar tudo em um só lugar. | |
| Windows PowerShell | Instale executando todos os comandos. | |
| 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.
Registrar Microsoft Entra aplicativo
Para registrar um aplicativo usando o Microsoft portal do Azure para que seu aplicativo se integre ao plataforma de identidade da Microsoft e chame a Microsoft API do Graph, execute as seguintes etapas:
- Create um túnel ngrok para os pontos de extremidade do servidor Web.
- Create recurso de bot do Azure para registrar bot no serviço de bot do Azure.
- Create segredo do cliente que permite a autenticação de SSO (logon único) do bot.
- Create uma política para um usuário locatário de demonstração criar reuniões online usando o PowerShell.
- Adicione permissões de API para chamadas downstream.
- Create registro de canal de bot na conta do Azure.
- Adicione o canal do Microsoft Teams para implantar o bot em um canal do Teams.
- Adicione o ponto de extremidade de mensagens ao túnel ngrok que você criou.
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 uma autenticação da Web
No painel esquerdo, em Gerenciar, selecione Autenticação.
Selecione Adicionar uma Web de plataforma>.
Insira o URI de redirecionamento para seu aplicativo acrescentando
auth-endao nome de domínio totalmente 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 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.
Adicionar permissões de API para chamadas downstream
No painel esquerdo, em Gerenciar, selecione Permissões de API.
Selecione + Adicionar uma permissão.
Selecione Microsoft Graph.
Selecione Permissões de aplicativos.
Selecione as seguintes permissões:
Calls.AccessMedia.AllCalls.Initiate.AllCalls.InitiateGroupCall.AllCalls.JoinGroupCall.AllCalls.JoinGroupCallAsGuest.AllOnlineMeetings.ReadWrite.All
Selecione Adicionar permissões.
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 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_useracrescentado 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:
Criar uma política
Para criar uma política que permita que um usuário locatário de demonstração crie reuniões online usando um script do PowerShell, execute as seguintes etapas:
Execute Windows PowerShell PSI como administrador e execute o script.
New-CsApplicationAccessPolicy -Identity "<<policy-identity/policy-name>>" -AppIds "<<azure-client-id>>" -Description "Policy-description" Grant-CsApplicationAccessPolicy -PolicyName "<<policy-identity/policy-name>>" -Identity "<<object-id-of-the-user-to-whom-policy-need-to-be-granted>>"Observação
Se você estiver usando o PSI Windows PowerShell pela primeira vez, execute os seguintes comandos:
- Set-ExecutionPolicy -ExecutionPolicy Unrestricted -Scope CurrentUser
- Executar Install-Module -Name MicrosoftTeams -Force -AllowClobber
Substitua os seguintes campos no script Windows PowerShell:
Campo Descrição policy-identity/policy-name Nome da política. azure-client-id ID do Aplicativo Microsoft, que você gerou ao registrar o aplicativo em portal do Azure. Descrição da política Descrição da política. object-id-of-the-user-to-who-policy-need-to-be-granted ID do usuário para o qual você precisa gerar a política usando o explorador de grafo. Para gerar a ID do objeto, entre no Microsoft Graph Explorer usando as credenciais a quem a política deve ser concedida.
Selecione Grafo Explorer na barra de ferramentas.
Selecione Executar consulta. Uma resposta é gerada em Visualização de resposta.
Copie o valor da
idpropriedade da versão prévia de Resposta e substitua pela ID do objeto no script do PowerShell.
Execute o script do PowerShell.
Execute
Connect-MicrosoftTeamse entre com as credenciais a quem a política deve ser concedida.
Execute o comando a seguir no PowerShell para verificar se a política foi criada com êxito ou não. Substitua o nome da política pelo nome da política definido.
Get-CsApplicationAccessPolicy -Identity “<<policy-identity/policy-name>>”
Observação
Verifique se os scripts em execução não estão desabilitados em seu sistema. Para obter mais informações, consulte políticas de execução.
Create seu bot
Create um recurso de bot do Azure
Observação
Se você já estiver testando seu bot no Teams, saia deste aplicativo e do Teams. Para ver essa alteração, entre novamente.
Vá para a Página Inicial.
Selecione + Create um recurso.
Na caixa de pesquisa, insira o Bot do Azure.
Selecione Enter.
Selecione Bot do Azure.
Selecione Criar.
Insira o nome do bot no identificador do Bot.
Selecione sua Assinatura na lista suspensa.
Selecione seu Grupo de recursos na lista suspensa.
Se você não tiver um grupo de recursos existente, poderá criar um novo grupo de recursos. Para criar um novo grupo de recursos, siga estas etapas:
- Selecione Create novo.
- Insira o nome do recurso e selecione OK.
- Selecione um local na lista suspensa Local do novo grupo de recursos .
Em Preços, selecione Alterar plano.
Selecione FO Free>Select.
Em ID do Aplicativo Microsoft, selecione Tipo de Aplicativo como Vários Locatários.
No tipo Criação, selecione Usar o registro de aplicativo existente.
Insira a ID do aplicativo.
Observação
Você não pode criar mais de um bot com a mesma ID do Aplicativo Microsoft.
Selecione Rever + criar.
Depois que a validação for aprovada, selecione Create.
O bot leva alguns minutos para provisionar.
Selecione Vá para o recurso.
Você criou com êxito seu bot do Azure.
Adicionar um canal do Teams
No painel esquerdo, selecione Canais.
Em Canais Disponíveis, selecione Microsoft Teams.
Selecione a caixa de seleção para aceitar os Termos de Serviço.
Selecione Concordar.
Selecione Aplicar.
Para adicionar um ponto de extremidade de mensagens
Use a URL do túnel de desenvolvimento no console de saída como o ponto de extremidade de mensagens.
No painel esquerdo, em Configurações, selecione Configuração.
Atualize o ponto de extremidade mensagens no formato
https://your-devtunnel-domain/api/messages.
Selecione Aplicar.
Você configurou com êxito um bot no serviço de Bot do Azure.
Observação
Se a chave instrumentação do Application Insights mostrar um erro, atualize com a ID do aplicativo.
Configurar configurações de aplicativo e arquivos de manifesto
Obter o
tenantIdouUserIddo Teams. Para obter otenantId, siga estas etapas:Selecione Teams.
Selecione Mais opções (...).
SelecioneObter um link para a equipe.
Você pode obter o
displayNamesite eid:Entre no Microsoft Graph Explorer usando sua conta de locatário do Teams.
Adicione
Usersno final da URL na caixa de pesquisa.Selecione Executar consulta.
Os nomes de exibição e as IDs de usuário vinculados à sua conta são gerados.
Selecione três contas e adicione-as
DisplayNameao arquivo eUserIdno appsettings.json.
Observação
TenantIdouUserIdda conta do Teams denota de onde você deseja iniciar a chamada eDisplayNameUserIddos usuários denotam para quem você deseja redirecionar ou transferir a chamada.
Atualizar configurações de aplicativo
Vá para o arquivo appsettings.json no repositório clonado.
Abra o arquivo appsettings.json no Visual Studio e atualize as seguintes informações:
- Substitua
MicrosoftAppId,ClientIdeAppIdpela ID do aplicativo Microsoft do bot. - Substitua
MicrosoftAppPassword,ClientSecreteAppSecretpelo Valor do segredo do cliente do bot. - Substitua
BotBaseUrlpara o nome de domínio do túnel ngrok ou dev. - Substitua
TenantIdpara oUserId. - Substitua
DisplayNamepara oId.
- Substitua
Selecione Salvar.
Atualizar manifesto do aplicativo
Vá para o arquivo manifest.json no repositório clonado.
Abra o arquivo manifest.json no Visual Studio e faça as seguintes alterações:
- Substitua
{id}`` and{BotId}' pela ID do Aplicativo Microsoft. - Substitua todas as ocorrências de pelo nome de
{{domain-name}}domínio do túnel ngrok ou dev.
- Substitua
Compilar e executar o serviço
Para compilar e executar o serviço, use o Visual Studio:
Abra o Visual Studio.
Acesse Arquivo>Abrir>Projeto/Solução...
Selecione o arquivo CallingBotSample.sln na pasta csharp>Source .
Pressione F5 para executar o projeto.
Uma página da Web é aberta com uma mensagem Seu bot está pronto!.
Adicionar bot de chamada e reunião ao Teams
No repositório clonado, acesse csharp > Source > AppManifest.
Create um arquivo .zip com os seguintes arquivos presentes na pasta AppManifest:
- manifest.json
- outline.png
- color.png
Observação
O
manifest.zipnão deve conter pastas extras nela. Ele deve termanifest jsono arquivo de origem,coloro ícone eoutlineo ícone dentro da pasta zip.No cliente do Teams, selecione o ícone Aplicativos .
Selecione Gerenciar seus aplicativos.
Selecione Carregar um aplicativo.
Na janela pop-up, selecione Carregar um aplicativo personalizado. Se você vir a opção, o upload de aplicativo personalizado estará habilitado.
Vá para csharp > Source > AppManifest.
Selecione Abrir para carregar o arquivo .zip que você criou na pasta AppManifest .
Selecione Adicionar para instalar o aplicativo bot Chamando no Teams.
Interagir com o bot de chamada e reunião
O bot permite que você acesse serviços e conteúdo em um espaço dedicado em um canal ou em um chat.
Vamos interagir com o aplicativo no Teams!
No painel esquerdo do Teams, selecione Exibir mais aplicativos (...) e selecione seu aplicativo na lista.
O bot envia um texto de boas-vindas com Cartão Adaptável.
Selecione Create Chamada.
Selecione Transferir Chamada.
Você pode pedir ao bot para agendar uma reunião e convidar os participantes.
Desafio completo
Você veio com uma saída como esta?
Parabéns!
Você concluiu o tutorial para começar a usar a chamada de bot e o aplicativo de reunião 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
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: https://aka.ms/ContentUserFeedback.
Submeter e ver comentários