Carregar arquivo no Teams usando o bot
O bot usa a API do Teams para enviar e receber arquivos com usuários nos chats pessoais. Os arquivos compartilhados no Teams podem aparecer como cartões e permitir a exibição avançada no aplicativo. O bot também ajuda na implementação de recursos como relatórios de despesas, reconhecimento de imagem, arquivamento de arquivos e assinaturas de e-signatures que envolvem a edição do conteúdo do arquivo.
Principais recursos de carregamento de arquivo no Teams usando o bot
- Carregue arquivos no Teams usando um bot.
- Receber um arquivo enviado para o bot como um anexo.
- Buscar imagens embutidas enviadas na mensagem.
Este guia passo a passo ajuda você a carregar o arquivo no Teams usando o bot. Você verá a seguinte saída:
Pré-requisitos
Instale as seguintes ferramentas e configure seu ambiente de desenvolvimento:
Microsoft Teams com conta válida
Versão mais recente do ngrok (somente para teste de devbox) ou qualquer solução de túnel equivalente
Observação
Depois de baixar o ngrok, inscreva-se e instale o authtoken.
Configurar o ambiente local
Abra BotBuilder-Samples.
Selecione Código.
No menu suspenso, selecione Abrir com o GitHub Desktop.
Selecione Clonar.
Criar e registrar seu bot
As etapas a seguir ajudam você a criar e registrar seu bot portal do Azure:
- Crie um recurso de Bot do Azure para registrar o bot no Azure Serviço de Bot.
- Crie o segredo do cliente para habilitar a autenticação de SSO do bot.
- Adicione o canal do Teams para implantar o bot.
- Use o ngrok para criar um túnel para os pontos de extremidade do servidor Web.
- Adicione o ponto de extremidade de mensagens ao túnel ngrok que você criou.
Para criar um recurso de Bot do Azure
Acesse o Portal do Azure.
Selecione Criar um recurso.
Na caixa de pesquisa, insira o bot do Azure.
Selecione Enter.
Selecione o Bot do Azure.
Selecionar Criar.
Insira o nome do identificador do bot necessário no identificador do Bot.
Na lista suspensa Assinatura, selecione sua assinatura.
Na lista suspensa grupo de recursos, selecione o grupo de recursos existente.
Você também pode criar um novo grupo de recursos (selecione Criar > insira o nome do recurso > selecione OK)
Se você tiver criado um novo grupo de recursos, selecione o local necessário na lista suspensa Novo local do grupo de recursos.
Na seção ID do Aplicativo da Microsoft , por padrão , a opção Criar nova ID de Aplicativo da Microsoft está selecionada.
Você pode selecionar Usar o registro de aplicativo existente e inserir a ID do aplicativo existente e a senha do aplicativo existente ou selecionar Criar nova ID de Aplicativo da Microsoft.
Observação
Não é possível criar mais de um bot com a mesma ID do Aplicativo da Microsoft.
Selecione o tipo de aplicativo como multilocatário.
Selecione Rever + criar.
Se a validação for aprovada, selecione Criar.
Levará alguns minutos para o serviço de bot ser provisionado.
Selecione Vá para o recurso.
Seu bot do Azure é criado.
Para criar o segredo do cliente
Execute as seguintes etapas se você tiver criado uma nova ID de Aplicativo da Microsoft:
No painel esquerdo, selecione Configuração.
Dica
Salve a ID do Aplicativo da Microsoft ou a ID do Cliente para referência futura.
Ao lado da ID do Aplicativo da Microsoft, selecione Gerenciar.
Na seção Segredos do cliente , selecione Novo segredo do cliente.
A janela Adicionar um segredo do cliente é exibida.
Insira Descrição.
Selecione Adicionar.
Na coluna Valor , selecione Copiar para área de transferência.
Dica
Salve o valor de segredos do cliente ou a senha do aplicativo para referência futura.
Para adicionar o canal do Teams
Selecione Início.
Selecione seu bot de recursos recentes.
Selecione Canais no painel esquerdo e selecione Microsoft Teams
.
Marque a caixa de seleção para aceitar os Termos de Serviço.
Selecione Concordar.
Selecione Aplicar.
Para criar um túnel para o servidor Web local
Use o ngrok ou o Prompt de Comando para criar um túnel para os pontos de extremidade HTTPS disponíveis publicamente do servidor Web em execução localmente. Execute o seguinte comando no ngrok:
ngrok http -host-header=localhost 3978
Dica
Se você encontrar ERR_NGROK_4018, siga as etapas fornecidas no Prompt de Comando para se inscrever e autenticar o ngrok. Em seguida, execute o ngrok http -host-header=localhost 3978 comando.
Para adicionar o ponto de extremidade de mensagens
No ngrok, copie a URL HTTPS.
Observação
A URL HTTPS em seu ngrok é seu nome de domínio totalmente qualificado. É
WebAppDomainum nome de domínio totalmente qualificado que não incluihttps://nele.Em Configurações do bot do Azure que você criou, selecione Configuração.
No ponto de extremidade de Mensagens, use a URL HTTPS disponível no ngrok e, no final da URL, adicione /api/messages.
Selecione Aplicar.
Você configurou com êxito um bot no Azure Serviço de Bot.
Atualizar o registro Azure AD aplicativo
Acesse o Portal do Azure.
Selecione Azure Active Directory.
No painel esquerdo, selecione Registros de Aplicativo.
Selecione seu bot.
Selecione Expor uma API.
Selecione Definir.
Defina o URI da ID do Aplicativo na forma de
api://your ngrok/botid-{your AppID}.
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, atualize o valor sempre que o subdomínio ngrok for alterado.
For example: api://f631****.ngrok.io/92c11075-c629-4a1e-ab58-02b4fd4204c2, onde estáf631****.ngrok.ioo novo nome do subdomínio ngrok.Selecione Adicionar um escopo.
No painel exibido, insira como
access_as_usero nome do escopo.Definir Quem pode consentir? para
Admins and users.Para configurar os prompts de consentimento do administrador e do usuário com os valores apropriados para
access_as_usero escopo, forneça as seguintes informações nos campos:Insira
Teams can access the user’s profilecomo Administração de exibição de consentimento.Insira
Allows Teams to call the app’s web APIs as the current usercomo Administração de consentimento.Insira como
Teams can access the user profile and make requests on the user’s behalfnome de exibição de consentimento do usuário.Insira como
Enable Teams to call this app’s APIs with the same rights as the userdescrição de consentimento do usuário.
Verifique se o Estado está definido como Habilitado.
Selecione Adicionar escopo para salvar.
Observação
O nome do escopo deve corresponder ao URI da ID do Aplicativo
/access_as_usercom acrescentado no final.api://9179****.ngrok.io/00000000-0000-0000-0000-000000000000/access_as_user
Na seção Aplicativos cliente autorizados, identifique os aplicativos que você deseja autorizar para o aplicativo Web do seu aplicativo.
Selecione Adicionar um aplicativo cliente.
Insira a ID do cliente: para
1fec8e78-bce4-4aaf-ab1b-5451cc387264o aplicativo móvel ou da área de trabalho do Teams.
Você pode inserir a ID do Cliente:
5e3ce6c0-2b1f-4285-8d4b-75ee78787346para o aplicativo Web do Teams.
A imagem a seguir exibe a ID do Cliente:
No painel esquerdo, selecione Permissões de API.
Observação
Os usuários precisam consentir com as permissões de API somente se o aplicativo do AAD estiver registrado em um locatário diferente.
Selecione Adicionar uma permissão.
Selecione Microsoft Graph.
Selecione Permissões delegadas.
Adicionar permissão User.Read in.
Selecione Adicionar permissões.
No painel esquerdo, selecione Autenticação para definir um URI de redirecionamento.
Observação
Se um aplicativo não receber consentimento do administrador de TI, os usuários deverão fornecer consentimento na primeira vez que usarem um aplicativo.
Selecione Adicionar uma plataforma.
Selecione Web.
Insira o URI de redirecionamento para seu aplicativo acrescentando-se
auth-endao nome de domínio totalmente qualificado:https://your ngrok/auth-end.Habilite a concessão implícita e os fluxos híbridos selecionando as seguintes caixas de seleção:
- Tokens de ID
- Tokens de acesso
Selecione Configurar.
**Para atualizar o TeamsAppManifest.
Selecione Manifesto no painel esquerdo.
Defina o item de configuração "accessTokenAcceptedVersion":2. Se não estiver definido, altere seu valor para e
2selecione Salvar.
Observação
Se você já estiver testando seu bot no Teams, saia deste aplicativo e saia do Teams. Para ver essa alteração, entre novamente.
Para configurar uma Serviço de Bot conexão
Vá para a página Configuração > Adicionar Configurações de Conexão OAuth.
Selecione Adicionar configurações de conexão OAuth.
Em Nova Configuração de Conexão, insira os seguintes detalhes:
- Digite o nome
name for your new connection setting. You can use the name in the settings of your bot service code. - Selecione Provedor de Serviços
Azure Active Directory V2. - ID do cliente.
Microsoft App ID - Segredo do cliente
Value of the client secret ID. - A URL de Troca de Tokens usa
Application ID URIo obtido anteriormente ao expor o ponto de extremidade da API. - ID do locatário enter
common. - Os escopos são inseridos
User.Read.
- Digite o nome
Selecione Salvar.
Configurar configurações de aplicativo e arquivos de manifesto
Navegue até appsettings.json no repositório clonado.
Abra appsettings.json no Visual Studio.
Atualize as seguintes informações:
Defina
"MicrosoftAppType"como MultiTenant.Defina
"MicrosoftAppId"como a ID do aplicativo Microsoft do bot.Defina
"MicrosoftAppPassword"como o valor da ID do segredo do cliente do bot.Definido
"MicrosoftAppTenantId"como em branco para o bot MultiTenant.
Navegue até manifest.json no repositório clonado.
Abra manifest.json no Visual Studio e faça as seguintes alterações:
Substitua todas as ocorrências pela
<<YOUR-MICROSOFT-APP-ID>>ID do aplicativo Microsoft do bot.
Compilar e executar o serviço
Para compilar e executar o serviço usando o Visual Studio ou a linha de comando
Inicie o Visual Studio.
Navegue até o projeto > /solução de > abertura de arquivo.
Selecione o arquivo TeamsFileUpload.csproj na pasta 56.teams-file-upload .
Abra Gerenciador de Soluções exibição.
Clique com o botão direito do mouse em TeamsFileUpload.
Selecione Definir como Projeto de Inicialização.
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 bot de upload de arquivo no Teams
No repositório clonado, navegue até csharp_dotnetcore > 56.teams-file-upload > TeamsAppManifest.
Crie um .zip com os seguintes arquivos que estão presentes na pasta TeamsAppManifest :
manifest.json
icon-outline.png
icon-color.png
Vá para o Microsoft Teams.
Selecione Aplicativos.
No canto inferior esquerdo, selecione Gerenciar seus aplicativos.
Selecione Fazer o upload de um aplicativo personalizado.
Selecione Abrir para carregar o .zip que você criou na pasta TeamsAppManifest .
Selecione Adicionar.
Na área de composição da mensagem, digite hi e aguarde alguns segundos para que ele responda com um cartão.
Interagir com o bot no Teams
Envie uma mensagem para o bot. Ele responde com um cartão para a permissão para carregar o arquivo.
Selecione Permitir. Um
teams-logo.pngarquivo é carregado no diretório de arquivos, que está pronto para download.
Envie um arquivo para o bot como um anexo no Teams. Ele responde com uma mensagem
Received and Saved. Você pode exibir o anexo na guia Arquivos .
Enviar uma imagem como um anexo. Ele responde com uma mensagem
Received and saved. Você pode exibir a imagem na janela de chat e na guia Arquivos .
Observação
Depois que o bot é instalado no escopo pessoal, o usuário entra em uma conversa de chat com o bot.
Desafio completo
Você conseguiu algo assim?
Parabéns!
Você concluiu o tutorial. Agora você pode carregar arquivos no Teams usando o bot.
Tem algum problema com essa seção? Se tiver, envie seus comentários para que possamos melhorar esta seção.