Nesse artigo, você vai aprender a integrar o Microsoft Teams na plataforma Botmaker.

Leitura estimada: 08 minutos

O Microsoft Teams é uma plataforma unificada de comunicação e colaboração. Combina funcionalidades de chat e videochamadas, armazenamento de arquivos com possibilidade de trabalho colaborativo, e integração de aplicativos. A integração nativa na plataforma Botmaker te permite o seguinte:

• Potencializar o trabalho e a comunicação das suas equipes.
• Criar bots diferentes para casos de uso especiais.

Como fazer a integração?

Para fazer a integração, entre em Menu > Configuração > Canais

(https://go.botmaker.com/#/integrations/channels) e selecione Microsoft Teams.

Em seguida, clique em Conectar para iniciar o tutorial da integração. Você vai ver a tela a seguir, onde deve clicar em Iniciar.

Lembre-se que, para conectar um bot no Microsoft Teams, você deve cumprir com os seguintes requisitos:

• Ter uma licença do Microsoft Teams e ser administrador(a) da conta
• Ter o app Microsoft Authenticator baixado no seu celular. Você vai precisar dele para autenticar sua conta do Microsoft Teams.
• Criar um aplicativo a partir do Microsoft Teams. Os aplicativos conectam o Teams com qualquer outro software que você utilizar, como a Botmaker, por exemplo.

Passo 1: habilite os aplicativos

Para habilitar os aplicativos, entre em https://admin.teams.microsoft.com. Depois de acessar, entre em Teams Apps > Setup Policies.

Em Manage policies, selecione Global e ative Upload custom apps movendo o botão para a posição ON, assim como aparece na imagem.

Em seguida, clique no botão Save que está abaixo da tela.

Nota: ao completar cada passo do tutorial, clique em Próxima para avançar com a integração.

Passo 2: crie um App

Para criar um App do Teams, faça login com sua conta no aplicativo Teams.Em seguida, entre na seção Apps da barra lateral. Utilize a busca para encontrar o aplicativo Developer Portal. Baixe-o ou abra-o.Na aba Apps, clique em Create a new app ou em +New App se você já tiver outros apps já criados. Escolha um nome e clique em Adicionar.

Passo 3: complete os detalhes do seu App

Em App details, você deve completar uma série de passos com dados sobre o seu App.

• Em Descriptions, complete os campos com *.
• Em Developer Information, complete os campos com *.
• Em App URLs, complete os campos com * (lembre-se de escrever o endereço colocando https:// na URL).
• Não é necessário completar Application (client) ID*.

Ao completar, clique em Save.

• Em seguida, vá a Configurar/Branding na barra lateral e carregue as imagens solicitadas.

Passo 4: crie seu bot

Continue a interação fazendo os seguintes procedimentos:

• Vá para Tools, clique em Bot management e, em seguida, em Create your first bot ou em +New Bot caso você já tenha criado outros chatbots. Escreva um nome para o seu bot e clique em Adicionar.

Nota: com o bot criado, você vai ver o nome e o ID. Copie os dois dados e cole-os em um bloco de notas, pois você vai precisar deles no último passo.

• Você vai entrar no bot criado e, na parte de Configure, deve preencher o campo de Bot Endpoint Address colando o endereço a seguir: https://go.botmaker.com/rest/msbotfwk. Depois de colar, clique em Save.

Passo 5: obtenha seu Client Secret

Na barra lateral, acesse Client Secret e clique em Add a client secret for your bot.Você vai ver um código. Copie-o e cole-o em um bloco de notas, porque você vai precisar dele no passo final.

Passo 6: configure seu bot

Volte à aba Apps e selecione seu App. Em Configure/App features, selecione a feature Bot.

Em Identify your bot, selecione:

• Select an existing bot e busque seu bot na lista

Em What can your bot do?, selecione:

• Upload and download files

Em Select the scopes in which people can use this command, selecione:

• Personal
• Teams

Em seguida, clique em Save.

Passo 7: publique seu bot

Você pode publicar seu bot por meio do App ou do site seguindo o passo a passo:

• No App do Microsoft Teams: vá para Publish/Public to Org e clique em Publish your app
• Em seguida, acesse o link a seguir usando um navegador: https://admin.teams.microsoft.com/policies/manage-apps

Na tela que vai se abrir, você vai ver que há um app com aprovação pendente. Busque-o pelo nome que você deu na lista que está abaixo. Clique no app.

• Um pop-up vai se abrir. Confira se o app selecionado é o correto. Copie o App Id que aparece nos detalhes.

Nota: copie e cole o número mostrado, já que você vai precisar dele no passo final.

Em seguida, clique no botão Publish e, quando a mensagem de confirmação aparecer, clique novamente em Publish.

Passo 8: conceda permissões ao bot

Para conceder permissões ao bot, você deve entrar no Portal Azure por meio deste link:

https://aad.portal.azure.com/#view/Microsoft_AAD_IAM/ActiveDirectoryMenuBlade/~/RegisteredApps

Ao entrar no Azure, selecione seu App.

Vá para Manage/API permissions e, em seguida, clique em + Add a permission.

Selecione a API do Microsoft Graph e a opção Application permissions. Lá, você deve buscar e adicionar, uma a uma, as seguintes permissões:

• User.Read.All
• TeamsApplnstallation.ReadWriteForUser.All
• Chat.ReadBasic.All

Finalmente, marque a opção:

• doneGrant admin consent for Botmaker

Passo 9: integre à Botmaker

Cole os dados que você copiou no bloco de notas nos passos anteriores:

• Bot name
• Bot ID
• Client secret
• App ID

Por último, clique em +Conectar Microsoft Teams

Para ver os detalhes da integração das contas do Teams que já estão conectadas, acesse https://go.botmaker.com/#/integrations/channels, selecione Microsoft Teams e clique em Configurar.

Pronto! Você integrou o MS Teams com a Botmaker para potencializar o trabalho e a comunicação das suas equipes! Lembre-se de visitar nossa Central de Ajuda para mais informações.

Escrito por: Equipe Botmaker

Atualizado: 08/02/2024